このドキュメントでは GeoDjango Model API の詳細を説明します。この節では、次の ZIP code と Digital Elevation Model の地理情報モデルを例として使います:
\nfrom django.contrib.gis.db import models\n\n\nclass Zipcode(models.Model):\n code = models.CharField(max_length=5)\n poly = models.PolygonField()\n\n\nclass Elevation(models.Model):\n name = models.CharField(max_length=100)\n rast = models.RasterField()\n空間フィールドは一連のジオメトリフィールド型と1つのラスターフィールド型で構成されます。各ジオメトリフィールド型は OpenGIS Simple Features 仕様 [1] に対応しています。ラスターデータに対するこのような標準は存在しません。
\nGeometryFieldLink to this heading#ジオメトリフィールドの基本クラス。
\nPointFieldLink to this heading#Point を格納します。
LineStringFieldLink to this heading#LineString を格納します。
PolygonFieldLink to this heading#Polygon を格納します。
MultiPointFieldLink to this heading#MultiPoint を格納します。
MultiLineStringFieldLink to this heading#MultiLineString を格納します。
MultiPolygonFieldLink to this heading#MultiPolygon を格納します。
GeometryCollectionFieldLink to this heading#GeometryCollection を格納します。
RasterFieldLink to this heading#GDALRaster を格納します。
RasterField は現在、PostGIS バックエンドのみで実装されています。
Django のモデルフィールドで利用できる通常の フィールドオプション に加えて、空間フィールドには以下の追加オプションがあります。すべてオプションです。
\nsridLink to this heading#ジオメトリフィールドの SRID [2] (Spatial Reference System Identity) を指定した値に設定します。デフォルトは 4326 (別名 WGS84 、単位は緯度経度)。
\nモデルに適切な SRID を選択することは、開発者が慎重に検討すべき重要な決定事項です。SRIDは、空間データベースのデータを解釈するために使用される投影システムに対応する整数指定子です。 [3] 投影システムは、場所を特定する座標にコンテキストを与えます。測地学 geodesy の詳細はこのドキュメントの範囲外ですが、一般的な問題は、地球は球形であり、地球の表現 (紙の地図やウェブマップなど) は球形ではないということです。
\nほとんどの人は、緯度と経度を使って地表上の位置を参照することに慣れています。しかし、緯度と経度は距離ではなく角度です。言い換えれば、平面上の2点間の最短経路は直線ですが、(地球のような) 曲面上の2点間の最短経路は、great circle の 弧 です [4] 。したがって、平面単位 (キロメートルやマイルなど) で距離を求めるには、追加の計算が必要になります。地理座標系を使うことは、開発者に後で複雑な問題をもたらすかもしれません。例えば、SpatiaLiteでは、地理座標系を使用してジオメトリ間の距離計算を実行する機能がないため、WGS84で格納された郡の境界から5マイル以内のすべてのポイントを検索するクエリを作成することはできません [5] 。
\n地球の地表の一部は、二次元またはデカルト平面に投影できます。投影座標系は地域固有のアプリケーションに特に便利であり、たとえば、データベースで North Kansas エリアのジオメトリだけを扱うことを知っている場合は、その地域固有の投影系を使用することを検討できます。さらに、投影座標系はデカルト単位 (メートルやフィートなど) で定義されており、距離の計算が容易になります。
\n\n追加のリソース:
\nspatialreference.org: Djangoを使用した空間参照システムのデータベース。
The State Plane Coordinate System: 米国で使用されている様々な投影系をカバーするウェブサイトです。WGS84のような地理座標系ではなく、米国で遭遇する空間データの多くはこれらの座標系のいずれかになります。
spatial_indexLink to this heading#デフォルトは True です。指定されたジオメトリフィールドに空間インデックスを作成します。
ジオメトリフィールドには追加オプションがあります。以下のすべてのオプションは任意です。
\ndimLink to this heading#このオプションは、ジオメトリフィールドの座標次元をカスタマイズするために使用できます。デフォルトでは、2次元ジオメトリを表すために2に設定されています。それをサポートする空間バックエンドでは、3次元をサポートするために3に設定できます。
\n\ngeographyLink to this heading#このオプションを True に設定すると、ジオメトリ型ではなくジオグラフィ型のデータベースカラムが作成されます。詳細は以下の ジオグラフィ型 セクションを参照してください。
ジオグラフィ (geography) 型は、地理座標 (例えばWGS84経度/緯度)で表現された空間特徴をネイティブにサポートします [6] 。ジオメトリ型が使用する平面とは異なり、ジオグラフィ型はデータを球体で表現します。ジオグラフィのカラムに対して行われる距離や計測の操作は、自動的に大円弧の計算を行い、線形単位を返します。言い換えると、2つのジオグラフィに対して ST_Distance を呼び出すと、メートル単位の値が返されます (WGS84のジオメトリ列に対して呼び出した場合は度単位になります) 。
地理計算にはより多くの数学が関わるため、地理型に対して使用できる PostGIS 空間ルックアップのサブセットが限られています。具体的には、距離ルックアップ に加えて、ジオグラフィカラム用に利用可能な追加の 空間ルックアップ は以下のみです。
\n入力としてジオグラフィ型をサポートしていない空間ルックアップや集計を使用する必要がある場合、 Cast データベース関数を使用して、クエリの中でジオグラフィカラムをジオメトリ型に変換できます:
from django.contrib.gis.db.models import PointField\nfrom django.db.models.functions import Cast\n\nZipcode.objects.annotate(geom=Cast("geography_field", PointField())).filter(\n geom__within=poly\n)\n詳細については、PostGISのドキュメントに ジオメトリ型ではなくジオグラフィ型を使うべき場合. を決定するのに役立つセクションがあります。
\n脚注
\n\n