{"title":"GIS QuerySet API リファレンス","version":"5.0","locale":"ja","docname":"ref/contrib/gis/geoquerysets","url":"/ja/5.0/ref/contrib/gis/geoquerysets/","canonical":"https://djangodocs.dev/ja/5.0/ref/contrib/gis/geoquerysets/","summary":"空間のルックアップ (Spatial Lookup) Link to this heading # このセクションの空間ルックアップは GeometryField と RasterField 用です。 導入については、 空間ルックアップの概要…","html":"

GIS QuerySet API リファレンスLink to this heading#

\n
\n

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

\n

このセクションの空間ルックアップは GeometryField と RasterField 用です。

\n

導入については、 空間ルックアップの概要 を参照してください。特定の空間バックエンドと互換性のあるルックアップの概要については、 空間ルックアップの互換表 を参照してください。

\n
\n

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

\n

以下のリファレンスにあるすべての例は地理情報フィールドおよび入力に対して提供されていますが、ルックアップはラスタの両側で同じように使用できます。ルックアップがラスター入力をサポートしていない場合、入力は ST_Polygon 関数を使用して必要に応じて自動的にジオメトリに変換されます。 ラスタルックアップの概要 も参照してください。

\n

ルックアップで使用されるデータベース演算子は、以下の 3 つのカテゴリに分類できます:

\n\n

以下の例は、さまざまなタイプのラスターサポートにおけるルックアップに相当する SQL を示しています。同じパターンがすべての空間ルックアップに適用されます。

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

ケース

ルックアップ

等価なSQL

N, B

rast__contains=rst

ST_Contains(rast, rst)

N, B

rast__1__contains=(rst, 2)

ST_Contains(rast, 1, rst, 2)

B, C

rast__contains=geom

ST_Contains(ST_Polygon(rast), geom)

B, C

rast__1__contains=geom

ST_Contains(ST_Polygon(rast, 1), geom)

B, C

poly__contains=rst

ST_Contains(poly, ST_Polygon(rst))

B, C

poly__contains=(rst, 1)

ST_Contains(poly, ST_Polygon(rst, 1))

C

rast__crosses=rst

ST_Crosses(ST_Polygon(rast), ST_Polygon(rst))

C

rast__1__crosses=(rst, 2)

ST_Crosses(ST_Polygon(rast, 1), ST_Polygon(rst, 2))

C

rast__crosses=geom

ST_Crosses(ST_Polygon(rast), geom)

C

poly__crosses=rst

ST_Crosses(poly, ST_Polygon(rst))

\n
\n

ラスターを使った空間ルックアップは、PostGISバックエンド (この節ではPGRasterと表記) のみでサポートされています。

\n
\n
\n

bbcontainsLink to this heading#

\n

利用可能なDB: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (Native)

\n

ジオメトリまたはラスタフィールドのバウンディングボックスが、ルックアップジオメトリのバウンディングボックスを完全に含むかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__bbcontains=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

poly ~ geom

MariaDB

MBRContains(poly, geom)

MySQL

MBRContains(poly, geom)

SpatiaLite

MbrContains(poly, geom)

\n
\n
\n
\n

bboverlapsLink to this heading#

\n

利用可能なDB: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (Native)

\n

ジオメトリフィールドのバウンディングボックスが、ルックアップジオメトリのバウンディングボックスと重なるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__bboverlaps=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

poly && geom

MariaDB

MBROverlaps(poly, geom)

MySQL

MBROverlaps(poly, geom)

SpatiaLite

MbrOverlaps(poly, geom)

\n
\n
\n
\n

containedLink to this heading#

\n

利用可能なDB: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (Native)

\n

ジオメトリフィールドのバウンディングボックスがルックアップジオメトリのバウンディングボックスに完全に含まれるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__contained=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

poly @ geom

MariaDB

MBRWithin(poly, geom)

MySQL

MBRWithin(poly, geom)

SpatiaLite

MbrWithin(poly, geom)

\n
\n
\n
\n

containsLink to this heading#

\n

利用可能なDB: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

ジオメトリフィールドにルックアップ ジオメトリが含まれているかどうかを調べます。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__contains=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Contains(poly, geom)

Oracle

SDO_CONTAINS(poly, geom)

MariaDB

ST_Contains(poly, geom)

MySQL

ST_Contains(poly, geom)

SpatiaLite

Contains(poly, geom)

\n
\n
\n
\n

contains_properlyLink to this heading#

\n

利用可能なDB: PostGIS, PGRaster (Bilateral)

\n

ルックアップ ジオメトリがジオメトリ フィールドの内部と交差し、境界 (または外部) と交差しない場合に true を返します。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__contains_properly=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_ContainsProperly(poly, geom)

\n
\n
\n
\n

coveredbyLink to this heading#

\n

利用可能なDB: PostGIS, Oracle, PGRaster (Bilateral), SpatiaLite

\n

ジオメトリフィールドのどのポイントもルックアップジオメトリの外側にないかどうかをテストします。 [3]

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__coveredby=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_CoveredBy(poly, geom)

Oracle

SDO_COVEREDBY(poly, geom)

SpatiaLite

CoveredBy(poly, geom)

\n
\n
\n
\n

coversLink to this heading#

\n

利用可能なDB: PostGIS, Oracle, PGRaster (Bilateral), SpatiaLite

\n

ルックアップされたジオメトリ内のどのポイントも、ジオメトリフィールドの外にないかどうかテストします。 [3]

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__covers=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Covers(poly, geom)

Oracle

SDO_COVERS(poly, geom)

SpatiaLite

Covers(poly, geom)

\n
\n
\n
\n

crossesLink to this heading#

\n

利用可能なDB: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (Conversion)

\n

ジオメトリフィールドがルックアップジオメトリと空間的に交差しているかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__crosses=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Crosses(poly, geom)

MariaDB

ST_Crosses(poly, geom)

MySQL

ST_Crosses(poly, geom)

SpatiaLite

Crosses(poly, geom)

\n
\n
\n
\n

disjointLink to this heading#

\n

利用可能なDB: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

ジオメトリフィールドがルックアップジオメトリから空間的に分離しているかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__disjoint=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Disjoint(poly, geom)

Oracle

SDO_GEOM.RELATE(poly, 'DISJOINT', geom, 0.05)

MariaDB

ST_Disjoint(poly, geom)

MySQL

ST_Disjoint(poly, geom)

SpatiaLite

Disjoint(poly, geom)

\n
\n
\n
\n

equalsLink to this heading#

\n

利用可能なDB: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Conversion)

\n

ジオメトリフィールドがルックアップジオメトリと空間的に等しいかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__equals=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Equals(poly, geom)

Oracle

SDO_EQUAL(poly, geom)

MariaDB

ST_Equals(poly, geom)

MySQL

ST_Equals(poly, geom)

SpatiaLite

Equals(poly, geom)

\n
\n
\n
\n

exact, same_asLink to this heading#

\n

利用可能なDB: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

ジオメトリフィールドがルックアップジオメトリと "等しい" かどうかをテストします。Oracle、MySQL、SpatiaLite では空間的な等しさをテストし、PostGIS ではバウンディングボックスの等しさをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

poly ~= geom

Oracle

SDO_EQUAL(poly, geom)

MariaDB

ST_Equals(poly, geom)

MySQL

ST_Equals(poly, geom)

SpatiaLite

Equals(poly, geom)

\n
\n
\n
\n

intersectsLink to this heading#

\n

利用可能なDB: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

ジオメトリフィールドがルックアップジオメトリと空間的に交差しているかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__intersects=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Intersects(poly, geom)

Oracle

SDO_OVERLAPBDYINTERSECT(poly, geom)

MariaDB

ST_Intersects(poly, geom)

MySQL

ST_Intersects(poly, geom)

SpatiaLite

Intersects(poly, geom)

\n
\n
\n
\n

isemptyLink to this heading#

\n\n

利用可能なDB: PostGIS

\n

ジオメトリが空かどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__isempty=True)\n
\n
\n
\n

isvalidLink to this heading#

\n

利用可能なDB: MySQL, PostGIS, Oracle, SpatiaLite

\n

ジオメトリが有効かどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__isvalid=True)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

MySQL, PostGIS, SpatiaLite

ST_IsValid(poly)

Oracle

SDO_GEOM.VALIDATE_GEOMETRY_WITH_CONTEXT(poly, 0.05) = 'TRUE'

\n
\n
\n
\n

overlapsLink to this heading#

\n

利用可能なDB: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

ジオメトリフィールドがルックアップ ジオメトリと空間的に重なっているかどうかをテストします。

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

バックエンド

等価なSQL

PostGIS

ST_Overlaps(poly, geom)

Oracle

SDO_OVERLAPS(poly, geom)

MariaDB

ST_Overlaps(poly, geom)

MySQL

ST_Overlaps(poly, geom)

SpatiaLite

Overlaps(poly, geom)

\n
\n
\n
\n

relateLink to this heading#

\n

利用可能なDB: PostGIS, MariaDB, Oracle, SpatiaLite, PGRaster (Conversion)

\n

ジオメトリフィールドが指定されたパターンの値によって空間的に関連しているかをテストします。このルックアップには (geom, pattern) というタプルパラメータが必要であり、pattern の形式は空間バックエンドによって異なります。

\n
\n

MariaDB, PostGIS, SpatiaLiteLink to this heading#

\n

これらの空間バックエンドでは、交差パターンは9文字からなる文字列で、ジオメトリフィールドとルックアップジオメトリの内部、境界、外部の交差を定義します。交差パターン行列では、次の文字のみを使用できます: 1、2、T、F、または *。このルックアップタイプを使用すると、ユーザーはDE-9IMモデルに一致する特定のジオメトリのリレーションシップを「微調整」できます。 [1]

\n

ジオメトリの例:

\n
Code
# A tuple lookup parameter is used to specify the geometry and\n# the intersection pattern (the pattern here is for 'contains').\nZipcode.objects.filter(poly__relate=(geom, "T*T***FF*"))\n
\n

PostGIS と MariaDB では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE ST_Relate(poly, geom, 'T*T***FF*')\n
\n

SpatiaLite では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE Relate(poly, geom, 'T*T***FF*')\n
\n

ラスターの例:

\n
Code
Zipcode.objects.filter(poly__relate=(rast, 1, "T*T***FF*"))\nZipcode.objects.filter(rast__2__relate=(rast, 1, "T*T***FF*"))\n
\n

PostGIS では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE ST_Relate(poly, ST_Polygon(rast, 1), 'T*T***FF*')\nSELECT ... WHERE ST_Relate(ST_Polygon(rast, 2), ST_Polygon(rast, 1), 'T*T***FF*')\n
\n
\n
\n

OracleLink to this heading#

\n

ここで、リレーションパターンは9つのリレーション文字列のうち少なくとも1つで構成されます: TOUCH, OVERLAPBDYDISJOINT, OVERLAPBDYINTERSECT, EQUAL, INSIDE, COVEREDBY, CONTAINS, COVERS, ON, ANYINTERACT 。複数の文字列を論理論理演算子 OR で結合することもできます。 [2] リレーション文字列は大文字小文字を区別しません。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__relate=(geom, "anyinteract"))\n
\n

Oracle では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE SDO_RELATE(poly, geom, 'anyinteract')\n
\n
\n
\n
\n

touchesLink to this heading#

\n

利用可能なDB: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite

\n

ジオメトリ フィールドがルックアップ ジオメトリに空間的に接しているかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__touches=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Touches(poly, geom)

MariaDB

ST_Touches(poly, geom)

MySQL

ST_Touches(poly, geom)

Oracle

SDO_TOUCH(poly, geom)

SpatiaLite

Touches(poly, geom)

\n
\n
\n
\n

withinLink to this heading#

\n

利用可能なDB: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

ジオメトリフィールドが空間的にルックアップジオメトリ内にあるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__within=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Within(poly, geom)

MariaDB

ST_Within(poly, geom)

MySQL

ST_Within(poly, geom)

Oracle

SDO_INSIDE(poly, geom)

SpatiaLite

Within(poly, geom)

\n
\n
\n
\n

leftLink to this heading#

\n

利用可能なDB: PostGIS, PGRaster (Conversion)

\n

ジオメトリフィールドのバウンディングボックスが、ルックアップ ジオメトリのバウンディングボックスよりも厳密に左側にあるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__left=geom)\n
\n

PostGIS では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE poly << geom\n
\n
\n
\n

rightLink to this heading#

\n

利用可能なDB: PostGIS, PGRaster (Conversion)

\n

ジオメトリフィールドのバウンディングボックスが、ルックアップ ジオメトリのバウンディングボックスの厳密に右側にあるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__right=geom)\n
\n

PostGIS では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE poly >> geom\n
\n
\n
\n

overlaps_leftLink to this heading#

\n

利用可能なDB: PostGIS, PGRaster (Bilateral)

\n

ジオメトリフィールドのバウンディングボックスが、ルックアップ ジオメトリのバウンディングボックスと重なるか、または左にあるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__overlaps_left=geom)\n
\n

PostGIS では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE poly &< geom\n
\n
\n
\n

overlaps_rightLink to this heading#

\n

利用可能なDB: PostGIS, PGRaster (Bilateral)

\n

ジオメトリフィールドのバウンディングボックスが、ルックアップ ジオメトリのバウンディングボックスと重なっているか、または右側にあるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__overlaps_right=geom)\n
\n

PostGIS では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE poly &> geom\n
\n
\n
\n

overlaps_aboveLink to this heading#

\n

利用可能なDB: PostGIS, PGRaster (Conversion)

\n

ジオメトリフィールドのバウンディングボックスがルックアップジオメトリのバウンディングボックスと重なっているか、または上にあるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__overlaps_above=geom)\n
\n

PostGIS では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE poly |&> geom\n
\n
\n
\n

overlaps_belowLink to this heading#

\n

利用可能なDB: PostGIS, PGRaster (Conversion)

\n

ジオメトリフィールドのバウンディングボックスがルックアップジオメトリのバウンディングボックスと重なっているか、または下にあるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__overlaps_below=geom)\n
\n

PostGIS では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE poly &<| geom\n
\n
\n
\n

strictly_aboveLink to this heading#

\n

利用可能なDB: PostGIS, PGRaster (Conversion)

\n

ジオメトリフィールドのバウンディングボックスが、ルックアップジオメトリのバウンディングボックスの厳密に上にあるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__strictly_above=geom)\n
\n

PostGIS では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE poly |>> geom\n
\n
\n
\n

strictly_belowLink to this heading#

\n

利用可能なDB: PostGIS, PGRaster (Conversion)

\n

ジオメトリフィールドのバウンディングボックスが、ルックアップジオメトリのバウンディングボックスの厳密に下にあるかどうかをテストします。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__strictly_below=geom)\n
\n

PostGIS では下記の SQL と同等です:

\n
SQL
SELECT ... WHERE poly <<| geom\n
\n
\n
\n
\n

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

\n

利用可能なDB: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Native)

\n

距離クエリの概要については 距離クエリの概要 を参照してください。

\n

距離ルックアップは次の形式を取ります:

\n
Text
<field>__<distance lookup>=(<geometry/raster>, <distance value>[, "spheroid"])\n<field>__<distance lookup>=(<raster>, <band_index>, <distance value>[, "spheroid"])\n<field>__<band_index>__<distance lookup>=(<raster>, <band_index>, <distance value>[, "spheroid"])\n
\n

距離ルックアップに渡される値はタプルであり、最初の2つの値は必須で、それぞれ、距離の計算対象のジオメトリと距離値 (フィールドの単位での数値、 Distance オブジェクト、または クエリ式) です。ルックアップにバンドインデックスを渡すには、2番目のエントリがバンドインデックスである3値タプルを使用します。

\n

dwithin を除くすべての距離ルックアップには、オプションの要素として 'spheroid' を含めることができます。これにより、測地座標系を持つフィールドにおいてより精度の高い回転楕円体距離計算関数を使用できます。

\n

PostgreSQLでは、 'spheroid' オプションは ST_DistanceSphere の代わりに ST_DistanceSpheroid を使用します。投影座標系では、より単純な ST_Distance 関数を使用します。ラスタは回転楕円体ベースのルックアップ用にジオメトリに変換されます。

\n
\n

distance_gtLink to this heading#

\n

指定された距離値よりも、ルックアップジオメトリからジオメトリフィールドへの距離が大きいモデルを返します。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__distance_gt=(geom, D(m=5)))\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Distance/ST_Distance_Sphere(poly, geom) > 5

MariaDB

ST_Distance(poly, geom) > 5

MySQL

ST_Distance(poly, geom) > 5

Oracle

SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) > 5

SpatiaLite

Distance(poly, geom) > 5

\n
\n
\n
\n

distance_gteLink to this heading#

\n

ルックアップしたジオメトリからジオメトリフィールドまでの距離が、指定した距離の値以上であるモデルを返します。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__distance_gte=(geom, D(m=5)))\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Distance/ST_Distance_Sphere(poly, geom) >= 5

MariaDB

ST_Distance(poly, geom) >= 5

MySQL

ST_Distance(poly, geom) >= 5

Oracle

SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) >= 5

SpatiaLite

Distance(poly, geom) >= 5

\n
\n
\n
\n

distance_ltLink to this heading#

\n

ルックアップしたジオメトリからジオメトリフィールドまでの距離が、指定した距離の値よりも小さいモデルを返します。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__distance_lt=(geom, D(m=5)))\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Distance/ST_Distance_Sphere(poly, geom) < 5

MariaDB

ST_Distance(poly, geom) < 5

MySQL

ST_Distance(poly, geom) < 5

Oracle

SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) < 5

SpatiaLite

Distance(poly, geom) < 5

\n
\n
\n
\n

distance_lteLink to this heading#

\n

ルックアップされたジオメトリからジオメトリフィールドまでの距離が、指定された距離の値以下であるモデルを返します。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__distance_lte=(geom, D(m=5)))\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_Distance/ST_Distance_Sphere(poly, geom) <= 5

MariaDB

ST_Distance(poly, geom) <= 5

MySQL

ST_Distance(poly, geom) <= 5

Oracle

SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) <= 5

SpatiaLite

Distance(poly, geom) <= 5

\n
\n
\n
\n

dwithinLink to this heading#

\n

ルックアップしたジオメトリからジオメトリフィールドまでの距離が、指定した距離以内のモデルを返します。 Distance オブジェクトを指定できるのは、対象となるジオメトリが投影システムの場合のみであることに注意してください。地理ジオメトリの場合は、ジオメトリフィールドの単位を使用する必要があります (例えば WGS84 の場合は度)。

\n

実装例:

\n
Code
Zipcode.objects.filter(poly__dwithin=(geom, D(m=5)))\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

バックエンド

等価なSQL

PostGIS

ST_DWithin(poly, geom, 5)

Oracle

SDO_WITHIN_DISTANCE(poly, geom, 5)

SpatiaLite

PtDistWithin(poly, geom, 5)

\n
\n
\n
\n

集計関数Link to this heading#

\n

Django はいくつかの GIS 固有の集計関数を提供しています。これらの集計関数の使い方の詳細については、 集計に関するトピックガイド を参照してください。

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

キーワード引数

説明

tolerance

このキーワードはOracle専用です。SDOAGGRTYPE プロシージャで使用される許容値のためのものです。詳細は Oracle documentation を参照してください。

\n
\n

例:

\n
Python console
>>> from django.contrib.gis.db.models import Extent, Union\n>>> WorldBorder.objects.aggregate(Extent("mpoly"), Union("mpoly"))\n
\n
\n

CollectLink to this heading#

\n
\n
\nclass Collect(geo_field, filter=None)Link to this definition#
\n
\n\n

利用可能なDB: PostGIS, SpatiaLite

\n

ジオメトリ列から GEOMETRYCOLLECTION または MULTI ジオメトリオブジェクトを返します。これは Union 集計の簡略版に似ていますが、ジオメトリをコレクションまたはマルチオブジェクトにまとめ、境界の解消を気にしないため、ユニオンを実行するよりも数桁高速です。

\n\n
\n
\n

ExtentLink to this heading#

\n
\n
\nclass Extent(geo_field, filter=None)Link to this definition#
\n
\n\n

利用可能なDB: PostGIS, Oracle, SpatiaLite

\n

QuerySet 内のすべての geo_field の範囲を表す、左下の座標と右上の座標からなる4値タプルを返します。

\n

例:

\n
Python console
>>> qs = City.objects.filter(name__in=("Houston", "Dallas")).aggregate(Extent("poly"))\n>>> print(qs["poly__extent"])\n(-96.8016128540039, 29.7633724212646, -95.3631439208984, 32.782058715820)\n
\n\n
\n
\n

Extent3DLink to this heading#

\n
\n
\nclass Extent3D(geo_field, filter=None)Link to this definition#
\n
\n\n

利用可能なDB: PostGIS

\n

QuerySet 内のすべての geo_field の 3D 範囲を、左下の座標と右上の座標 (それぞれ x、y、z 座標を持つ) からなる 6 要素のタプルとして返します。

\n

例:

\n
Python console
>>> qs = City.objects.filter(name__in=("Houston", "Dallas")).aggregate(Extent3D("poly"))\n>>> print(qs["poly__extent3d"])\n(-96.8016128540039, 29.7633724212646, 0, -95.3631439208984, 32.782058715820, 0)\n
\n\n
\n
\n

MakeLineLink to this heading#

\n
\n
\nclass MakeLine(geo_field, filter=None)Link to this definition#
\n
\n\n

利用可能なDB: PostGIS, SpatiaLite

\n

QuerySet 内のポイントフィールドジオメトリから構築された LineString を返します。現在、クエリセットの順序は意味がありません。

\n

例:

\n
Python console
>>> qs = City.objects.filter(name__in=("Houston", "Dallas")).aggregate(MakeLine("poly"))\n>>> print(qs["poly__makeline"])\nLINESTRING (-95.3631510000000020 29.7633739999999989, -96.8016109999999941 32.7820570000000018)\n
\n\n
\n
\n

UnionLink to this heading#

\n
\n
\nclass Union(geo_field, filter=None)Link to this definition#
\n
\n\n

利用可能なDB: PostGIS, Oracle, SpatiaLite

\n

このメソッドは、クエリセット内のすべてのジオメトリの結合を含む GEOSGeometry オブジェクトを返します。大きなクエリセットでは、Union を使用すると処理が集中し、かなりの時間がかかる可能性があることに注意してください。

\n\n

例:

\n
Python console
>>> u = Zipcode.objects.aggregate(Union(poly))  # This may take a long time.\n>>> u = Zipcode.objects.filter(poly__within=bbox).aggregate(\n...     Union(poly)\n... )  # A more sensible approach.\n
\n\n

脚注

\n\n
\n
\n
","rootId":"gis-queryset-api-reference","toc":[{"title":"空間のルックアップ (Spatial Lookup)","anchor":"spatial-lookups","children":[{"title":"ラスターのルックアップ","anchor":"lookups-with-rasters","children":[]},{"title":"bbcontains","anchor":"bbcontains","children":[]},{"title":"bboverlaps","anchor":"bboverlaps","children":[]},{"title":"contained","anchor":"contained","children":[]},{"title":"contains","anchor":"contains","children":[]},{"title":"contains_properly","anchor":"contains-properly","children":[]},{"title":"coveredby","anchor":"coveredby","children":[]},{"title":"covers","anchor":"covers","children":[]},{"title":"crosses","anchor":"crosses","children":[]},{"title":"disjoint","anchor":"disjoint","children":[]},{"title":"equals","anchor":"equals","children":[]},{"title":"exact, same_as","anchor":"exact-same-as","children":[]},{"title":"intersects","anchor":"intersects","children":[]},{"title":"isempty","anchor":"isempty","children":[]},{"title":"isvalid","anchor":"isvalid","children":[]},{"title":"overlaps","anchor":"overlaps","children":[]},{"title":"relate","anchor":"relate","children":[{"title":"MariaDB, PostGIS, SpatiaLite","anchor":"mariadb-postgis-and-spatialite","children":[]},{"title":"Oracle","anchor":"oracle","children":[]}]},{"title":"touches","anchor":"touches","children":[]},{"title":"within","anchor":"within","children":[]},{"title":"left","anchor":"left","children":[]},{"title":"right","anchor":"right","children":[]},{"title":"overlaps_left","anchor":"overlaps-left","children":[]},{"title":"overlaps_right","anchor":"overlaps-right","children":[]},{"title":"overlaps_above","anchor":"overlaps-above","children":[]},{"title":"overlaps_below","anchor":"overlaps-below","children":[]},{"title":"strictly_above","anchor":"strictly-above","children":[]},{"title":"strictly_below","anchor":"strictly-below","children":[]}]},{"title":"距離ルックアップ","anchor":"distance-lookups","children":[{"title":"distance_gt","anchor":"distance-gt","children":[]},{"title":"distance_gte","anchor":"distance-gte","children":[]},{"title":"distance_lt","anchor":"distance-lt","children":[]},{"title":"distance_lte","anchor":"distance-lte","children":[]},{"title":"dwithin","anchor":"dwithin","children":[]},{"title":"集計関数","anchor":"aggregate-functions","children":[{"title":"Collect","anchor":"collect","children":[]},{"title":"Extent","anchor":"extent","children":[]},{"title":"Extent3D","anchor":"extent3d","children":[]},{"title":"MakeLine","anchor":"makeline","children":[]},{"title":"Union","anchor":"union","children":[]}]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API リファレンス","url":"/ja/5.0/ref/"},{"docname":"ref/contrib/index","title":"contrib パッケージ","url":"/ja/5.0/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/ja/5.0/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/forms-api","title":"GeoDjango フォーム API","url":"/ja/5.0/ref/contrib/gis/forms-api/"},"next":{"docname":"ref/contrib/gis/functions","title":"地理情報データベース関数","url":"/ja/5.0/ref/contrib/gis/functions/"},"formats":{"html":"/ja/5.0/ref/contrib/gis/geoquerysets/","markdown":"/ja/5.0/ref/contrib/gis/geoquerysets.md","json":"/ja/5.0/ref/contrib/gis/geoquerysets.json"},"source":"https://github.com/django/django/blob/stable/5.0.x/docs/ref/contrib/gis/geoquerysets.txt","official":"https://docs.djangoproject.com/ja/5.0/ref/contrib/gis/geoquerysets/","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","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}