{"title":"GeoDjango データベース API","version":"6.1","locale":"ja","docname":"ref/contrib/gis/db-api","url":"/ja/6.1/ref/contrib/gis/db-api/","canonical":"https://djangodocs.dev/ja/6.1/ref/contrib/gis/db-api/","summary":"空間バックエンド (Spatial Backend) Link to this heading # GeoDjango は現在、次の空間データベースバックエンドを提供しています: django.contrib.gis.db.backends.postgis…","html":"

GeoDjango データベース APILink to this heading#

\n
\n

空間バックエンド (Spatial Backend)Link to this heading#

\n

GeoDjango は現在、次の空間データベースバックエンドを提供しています:

\n\n
\n

MySQL の空間データに関する制限Link to this heading#

\n

Django は、最近の MySQL バージョンで利用可能な、実際のジオメトリを操作する空間関数をサポートしています。しかし、空間関数は PostGIS のような他のバックエンドほど豊富ではありません。

\n
\n
\n

ラスターのサポートLink to this heading#

\n

RasterField は現在、PostGIS バックエンドのみに実装されています。ラスターフィールドに対する空間ルックアップは可能ですが、空間データベース関数や集計は実装されていません。

\n
\n
\n
\n

モデルを作成し、ジオメトリフィールドを保存するLink to this heading#

\n

以下にジオメトリオブジェクトの作成例を示します (Zipcode モデルを想定):

\n
Python console
>>> from zipcode.models import Zipcode\n>>> z = Zipcode(code=77096, poly="POLYGON(( 10 10, 10 20, 20 20, 20 15, 10 10))")\n>>> z.save()\n
\n

GEOSGeometry オブジェクトもジオメトリモデルを保存するために使用できます:

\n
Python console
>>> from django.contrib.gis.geos import GEOSGeometry\n>>> poly = GEOSGeometry("POLYGON(( 10 10, 10 20, 20 20, 20 15, 10 10))")\n>>> z = Zipcode(code=77096, poly=poly)\n>>> z.save()\n
\n

さらに、GEOSGeometry がフィールドの座標系と異なる座標系 (異なる SRID 値を持つ) 場合は、空間データベースの変換プロシージャを使用して、モデルのフィールドの SRID に暗黙的に変換されます:

\n
Python console
>>> poly_3084 = GEOSGeometry(\n...     "POLYGON(( 10 10, 10 20, 20 20, 20 15, 10 10))", srid=3084\n... )  # SRID 3084 is 'NAD83(HARN) / Texas Centric Lambert Conformal'\n>>> z = Zipcode(code=78212, poly=poly_3084)\n>>> z.save()\n>>> from django.db import connection\n>>> print(\n...     connection.queries[-1]["sql"]\n... )  # printing the last SQL statement executed (requires DEBUG=True)\nINSERT INTO "geoapp_zipcode" ("code", "poly") VALUES (78212, ST_Transform(ST_GeomFromWKB('\\\\001 ... ', 3084), 4326))\n
\n

そのため、ジオメトリパラメータは GEOSGeometry オブジェクト、WKT (Well Known Text [1]) 、HEXEWKB (PostGIS 固有のジオメトリで、16 進数の WKB ジオメトリ [2]) 、GeoJSON (RFC 7946 参照) を使用して渡すことができます。基本的に、入力が GEOSGeometry オブジェクトでない場合、ジオメトリフィールドは入力から GEOSGeometry インスタンスを作成しようとします。

\n

GEOSGeometry オブジェクトを作成する詳細については、GEOS チュートリアル を参照してください。

\n
\n
\n

ラスターフィールドを持つモデルの作成と保存Link to this heading#

\n

ラスターモデルを作成するとき、ラスターフィールドは、遅延評価を使用して、入力を GDALRaster に暗黙的に変換します。そのため、ラスタフィールドは GDALRaster コンストラクタが受け付けるすべての入力を受け入れます。

\n

以下は、ラスターファイル volcano.tif からラスターオブジェクトを作成する方法の例です (Elevation モデルを想定) :

\n
Python console
>>> from elevation.models import Elevation\n>>> dem = Elevation(name="Volcano", rast="/path/to/raster/volcano.tif")\n>>> dem.save()\n
\n

GDALRaster オブジェクトもラスターモデルの保存に使用できます:

\n
Python console
>>> from django.contrib.gis.gdal import GDALRaster\n>>> rast = GDALRaster(\n...     {\n...         "width": 10,\n...         "height": 10,\n...         "name": "Canyon",\n...         "srid": 4326,\n...         "scale": [0.1, -0.1],\n...         "bands": [{"data": range(100)}],\n...     }\n... )\n>>> dem = Elevation(name="Canyon", rast=rast)\n>>> dem.save()\n
\n

Note that this is equivalent to:

\n
Python console
>>> dem = Elevation.objects.create(\n...     name="Canyon",\n...     rast={\n...         "width": 10,\n...         "height": 10,\n...         "name": "Canyon",\n...         "srid": 4326,\n...         "scale": [0.1, -0.1],\n...         "bands": [{"data": range(100)}],\n...     },\n... )\n
\n
\n
\n

空間のルックアップ (Spatial Lookup)Link to this heading#

\n

GeoDjango のルックアップ型は filter() や exclude() などの manager メソッドで使うことができます。しかし、 GeoDjango 固有のルックアップ型は空間フィールドでのみ利用可能です。

\n

Filters on 'normal' fields (e.g. CharField)\nmay be chained with those on geographic fields. Geographic lookups accept\ngeometry and raster input on both sides, and input types can be mixed freely in\nmost cases. However, unlike assignments to model fields, with lookups,\ntypes such as str, pathlib.Path, and dict must be wrapped by\nGDALRaster to signify that the potential for\nfile writing or network fetching is acceptable. For the rationale, see\nraster security considerations.

\n

地理情報ルックアップの一般的な構造を以下に記載します。完全なリファレンスは、 空間ルックアップのリファレンス にあります。

\n\n
\n

ジオメトリ・ルックアップLink to this heading#

\n

地理情報クエリにおいて、ジオメトリを用いる一般的な形式は以下の通りです (GeoDjango モデル API で使用されている Zipcode モデルを想定):

\n
Text
>>> qs = Zipcode.objects.filter(<field>__<lookup_type>=<parameter>)\n>>> qs = Zipcode.objects.exclude(...)\n
\n

例:

\n
Python console
>>> qs = Zipcode.objects.filter(poly__contains=pnt)\n>>> qs = Elevation.objects.filter(poly__contains=rst)\n
\n

この場合、 poly は地理情報フィールド、 contains は空間ルックアップタイプ、 pnt はパラメータ (GEOSGeometry オブジェクト、または GeoJSON、WKT、HEXEWKB の文字列)、そして rst は GDALRaster オブジェクトです。

\n
\n
\n

ラスター・ルックアップLink to this heading#

\n

ラスタールックアップの構文はジオメトリの構文に似ています。唯一の違いは、バンドインデックスを追加入力として指定できることです。バンドインデックスが指定されていない場合は、デフォルトで最初のバンドが使用されます (インデックス"0") 。その場合、構文はジオメトリルックアップの構文と同一です。

\n

バンドインデックスを指定するには、ルックアップに追加のパラメータを両側で指定できます。左側では、バンドインデックスを渡すためにダブルアンダースコア構文が使用されます。右側では、ラスターとバンドのインデックスのタプルを指定できます。

\n

これにより、ラスターを使用するルックアップの一般的な形式が得られます (GeoDjango モデル API で使用されている Elevation モデルを想定):

\n
Text
>>> qs = Elevation.objects.filter(<field>__<lookup_type>=<parameter>)\n>>> qs = Elevation.objects.filter(<field>__<band_index>__<lookup_type>=<parameter>)\n>>> qs = Elevation.objects.filter(<field>__<lookup_type>=(<raster_input, <band_index>)\n
\n

例:

\n
Python console
>>> qs = Elevation.objects.filter(rast__contains=geom)\n>>> qs = Elevation.objects.filter(rast__contains=rst)\n>>> qs = Elevation.objects.filter(rast__1__contains=geom)\n>>> qs = Elevation.objects.filter(rast__contains=(rst, 1))\n>>> qs = Elevation.objects.filter(rast__1__contains=(rst, 1))\n
\n

例の左辺では、 rast が地理情報ラスタフィールドで、 contains が空間ルックアップタイプです。右辺の geom はジオメトリ入力で、 rst は GDALRaster オブジェクトです。バンドインデックスは最初の2つのクエリではデフォルトで 0 に設定され、他のクエリでは 1 に設定されます。

\n

すべての空間ルックアップはラスターオブジェクトの両側で使用できますが、すべての基本演算子がラスター入力をネイティブに受け付けるわけではありません。演算子がジオメトリ入力を想定している場合、ラスタは自動的にジオメトリに変換されます。ルックアップ結果を解釈する際には、この点に留意することが重要です。

\n

ラスターをサポートするタイプは 互換表 のすべてのルックアップにリストされています。ラスタを含むルックアップは現在のところ PostGIS バックエンドでのみ利用可能です。

\n
\n
\n
\n

距離クエリLink to this heading#

\n
\n

はじめにLink to this heading#

\n

残念ながら、地球は平らではないため、空間データでの距離計算は厄介です。PostGIS の制限により、地理座標系のフィールドを使用した距離のクエリは、別の方法で表現しなければならない場合があります。詳細は SRID の選択 セクションを参照してください。

\n
\n
\n

距離ルックアップLink to this heading#

\n

利用可能なDB: PostGIS、MariaDB、MySQL、Oracle、SpatiaLite、PGRaster (ネイティブ)

\n

以下の距離ルックアップが利用できます:

\n\n\n

距離ルックアップは、次のように構成されるタプルパラメータを受け取ります:

\n
    \n

  1. 計算のベースとなるジオメトリまたはラスター。

    2. \n

  2. 距離を含む数字または Distance オブジェクト。

    3. \n
\n

Distance オブジェクトが使用されている場合、任意の単位で表現される可能性があります(SQL 生成時には、フィールドの単位に変換された単位が使用される)。それ以外の場合、数値パラメータはフィールドの単位であると想定されます。

\n\n

例えば、SouthTexasCity というモデル (GeoDjango 距離テスト から) が、テキサス州南部の都市に有効な 投影 座標系にあるとします:

\n
Code
from django.contrib.gis.db import models\n\n\nclass SouthTexasCity(models.Model):\n    name = models.CharField(max_length=30)\n    # A projected coordinate system (only valid for South Texas!)\n    # is used, units are in meters.\n    point = models.PointField(srid=32140)\n
\n

距離クエリは次のように実行できます:

\n
Python console
>>> from django.contrib.gis.geos import GEOSGeometry\n>>> from django.contrib.gis.measure import D  # ``D`` is a shortcut for ``Distance``\n>>> from geoapp.models import SouthTexasCity\n# Distances will be calculated from this point, which does not have to be projected.\n>>> pnt = GEOSGeometry("POINT(-96.876369 29.905320)", srid=4326)\n# If numeric parameter, units of field (meters in this case) are assumed.\n>>> qs = SouthTexasCity.objects.filter(point__distance_lte=(pnt, 7000))\n# Find all Cities within 7 km, > 20 miles away, and > 100 chains away (an obscure unit)\n>>> qs = SouthTexasCity.objects.filter(point__distance_lte=(pnt, D(km=7)))\n>>> qs = SouthTexasCity.objects.filter(point__distance_gte=(pnt, D(mi=20)))\n>>> qs = SouthTexasCity.objects.filter(point__distance_gte=(pnt, D(chain=100)))\n
\n

ラスタークエリは、ジオメトリフィールド "point" をラスターフィールドに置き換えるか、"pnt" オブジェクトをラスターオブジェクトに置き換えるか、またはその両方で同じように機能します。右辺のラスター入力のバンドインデックスを指定するには、3値のタプルをルックアップに渡すことができます:

\n
Python console
>>> qs = SouthTexasCity.objects.filter(point__distance_gte=(rst, 2, D(km=7)))\n
\n

ラスター rst のバンドのうち、インデックス2 (3番目のバンド) がルックアップに使用されます。

\n
\n
\n
\n

互換表Link to this heading#

\n
\n

空間のルックアップ (Spatial Lookup)Link to this heading#

\n

以下の表は、各空間データベースバックエンドで利用可能な空間ルックアップの概要です。PostGIS Raster (PGRaster) のルックアップは ラスタールックアップの詳細 に記載されている3つのカテゴリに分類されます: ネイティブサポート N、双方向ネイティブサポート B、ジオメトリ変換サポート C。

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

ルックアップタイプ

PostGIS

Oracle

MariaDB

MySQL [4]

SpatiaLite

PGRaster

bbcontains

X

X

X

X

N

bboverlaps

X

X

X

X

N

contained

X

X

X

X

N

contains

X

X

X

X

X

B

contains_properly

X

B

coveredby

X

X

X (≥ 12.0.1)

X

X

B

covers

X

X

X

X

B

crosses

X

X

X

X

C

disjoint

X

X

X

X

X

B

distance_gt

X

X

X

X

X

N

distance_gte

X

X

X

X

X

N

distance_lt

X

X

X

X

X

N

distance_lte

X

X

X

X

X

N

dwithin

X

X

X

B

equals

X

X

X

X

X

C

exact

X

X

X

X

X

B

geom_type

X

X (≥ 23c)

X

X

X

intersects

X

X

X

X

X

B

isempty

X

X

isvalid

X

X

X (≥ 12.0.1)

X

X

num_dimensions

X

X

overlaps

X

X

X

X

X

B

relate

X

X

X

X

C

same_as

X

X

X

X

X

B

touches

X

X

X

X

X

B

within

X

X

X

X

X

B

left

X

C

right

X

C

overlaps_left

X

B

overlaps_right

X

B

overlaps_above

X

C

overlaps_below

X

C

strictly_above

X

C

strictly_below

X

C

\n
\n
\n
\n

データベース関数Link to this heading#

\n

次の表は、各空間バックエンドで使用できるジオグラフィ固有のデータベース関数の概要です。

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

関数

PostGIS

Oracle

MariaDB

MySQL

SpatiaLite

Area

X

X

X

X

X

AsGeoJSON

X

X

X

X

X

AsGML

X

X

X

AsKML

X

X

AsSVG

X

X

AsWKB

X

X

X

X

X

AsWKT

X

X

X

X

X

Azimuth

X

X (LWGEOM/RTTOPO)

BoundingCircle

X

X

X (≥ 5.1)

Centroid

X

X

X

X

X

ClosestPoint

X

X

Difference

X

X

X

X

X

Distance

X

X

X

X

X

Envelope

X

X

X

X

X

ForcePolygonCW

X

X

FromWKB

X

X

X

X

X

FromWKT

X

X

X

X

X

GeoHash

X

X (≥ 12.0.1)

X

X (LWGEOM/RTTOPO)

GeometryDistance

X

GeometryType

X

X (≥ 23c)

X

X

X

Intersection

X

X

X

X

X

IsEmpty

X

X

IsValid

X

X

X (≥ 12.0.1)

X

X

Length

X

X

X

X

X

LineLocatePoint

X

X

MakeValid

X

X (LWGEOM/RTTOPO)

MemSize

X

NumDimensions

X

X

NumGeometries

X

X

X

X

X

NumPoints

X

X

X

X

X

Perimeter

X

X

X

PointOnSurface

X

X

X

X

Reverse

X

X

X

Rotate

X

Scale

X

X

SnapToGrid

X

X

SymDifference

X

X

X

X

X

Transform

X

X

X

Translate

X

X

Union

X

X

X

X

X

\n
\n
\n
\n

集計関数Link to this heading#

\n

次の表は、各空間バックエンドで使用できるGIS固有のアグリゲート関数の概要です。

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

集計関数

PostGIS

Oracle

MariaDB

MySQL

SpatiaLite

Collect

X

X (≥ 12.0.1)

X (≥ 8.0.24)

X

Extent

X

X

X

Extent3D

X

MakeLine

X

X

Union

X

X

X

\n
\n

脚注

\n\n
\n
","rootId":"geodjango-database-api","toc":[{"title":"空間バックエンド (Spatial Backend)","anchor":"module-django.contrib.gis.db.backends","children":[{"title":"MySQL の空間データに関する制限","anchor":"mysql-spatial-limitations","children":[]},{"title":"ラスターのサポート","anchor":"raster-support","children":[]}]},{"title":"モデルを作成し、ジオメトリフィールドを保存する","anchor":"creating-and-saving-models-with-geometry-fields","children":[]},{"title":"ラスターフィールドを持つモデルの作成と保存","anchor":"creating-and-saving-models-with-raster-fields","children":[]},{"title":"空間のルックアップ (Spatial Lookup)","anchor":"spatial-lookups","children":[{"title":"ジオメトリ・ルックアップ","anchor":"geometry-lookups","children":[]},{"title":"ラスター・ルックアップ","anchor":"raster-lookups","children":[]}]},{"title":"距離クエリ","anchor":"distance-queries","children":[{"title":"はじめに","anchor":"introduction","children":[]},{"title":"距離ルックアップ","anchor":"distance-lookups","children":[]}]},{"title":"互換表","anchor":"compatibility-tables","children":[{"title":"空間のルックアップ (Spatial Lookup)","anchor":"spatial-lookup-compatibility","children":[]},{"title":"データベース関数","anchor":"database-functions","children":[]},{"title":"集計関数","anchor":"aggregate-functions","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API リファレンス","url":"/ja/6.1/ref/"},{"docname":"ref/contrib/index","title":"contrib パッケージ","url":"/ja/6.1/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/ja/6.1/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/model-api","title":"GeoDjango モデル API","url":"/ja/6.1/ref/contrib/gis/model-api/"},"next":{"docname":"ref/contrib/gis/forms-api","title":"GeoDjango フォーム API","url":"/ja/6.1/ref/contrib/gis/forms-api/"},"formats":{"html":"/ja/6.1/ref/contrib/gis/db-api/","markdown":"/ja/6.1/ref/contrib/gis/db-api.md","json":"/ja/6.1/ref/contrib/gis/db-api.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/ref/contrib/gis/db-api.txt","official":"https://docs.djangoproject.com/ja/6.1/ref/contrib/gis/db-api/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}