{"title":"Acuan API QuerySet GIS","version":"6.1","locale":"id","docname":"ref/contrib/gis/geoquerysets","url":"/id/6.1/ref/contrib/gis/geoquerysets/","canonical":"https://djangodocs.dev/id/6.1/ref/contrib/gis/geoquerysets/","summary":"Pencarian Spasial Link to this heading # Pencarian spasial dalam bagian ini tersedia untuk GeometryField dan RasterField . For an introduction, see the spatial…","html":"

Acuan API QuerySet GISLink to this heading#

\n
\n

Pencarian SpasialLink to this heading#

\n

Pencarian spasial dalam bagian ini tersedia untuk GeometryField dan RasterField.

\n

For an introduction, see the spatial lookups introduction. For an overview of what lookups are\ncompatible with a particular spatial backend, refer to the\nspatial lookup compatibility table.

\n
\n

Pencarian dengan rasterLink to this heading#

\n

Semua contoh dalam acuan dibawah diberikan untuk bidang-bidang dan masukan geometri, tetapi pencarian dapat menggunakan cara sama dengan raster pada kedua sisi. Kapanpun pencarian tidak mendukung amsukan raster, masukan otomatis dirubah ke geometri dimana dibutuhkan menggunakan fungsi ST_Polygon. Lihat juga introduction to raster lookups.

\n

Penghubung basisdata digunakan oleh pencarian dapat dibagi menjadi tiga kategori:

\n\n

Contoh-contoh dibawah menunjukkan SQL setara untuk pencarian dalam jenis berbeda dari dukungan raster. Pola sama berlaku pada semua pencarian spasial.

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

Kasus

Cari

Setara 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

Pencarian spasial dengan raster hanya didukung untuk backend PostGIS (dinamai sebagai PGRaster dalam bagian ini).

\n
\n
\n

bbcontainsLink to this heading#

\n

Ketersediaan: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (Asli)

\n

Coba jika geometri atau kotak pembatas bidang raster sepenuhnya mengandung pencarian kotak pembatas geometri.

\n

Contoh:

\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

Backend

Setara 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

Ketersediaan: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (Asli)

\n

Coba jika kotak pembatas bidang geometri tumpang tindih pencarian kotak pembatas geometri.

\n

Contoh:

\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

Backend

Setara 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

Ketersediaan: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (Asli)

\n

Coba jika kotak pembatas bidang geometri sepenuhnya terkandung oleh pencarian kotak pembatas geometri.

\n

Contoh:

\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

Backend

Setara 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

Ketersediaan: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Timbal balik)

\n

Dicoba jika bidang geometri secara spasial mengandung pencarian geometri.

\n

Contoh:

\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

Backend

Setara 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

Tersedia: PostGIS, PGRaster (Timbal balik)

\n

Mengembalikan true jika pencarian geometri memotong interior dari bidang geometri, tetapi bukan batas (atau eksterior).

\n

Contoh:

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

Backend

Setara SQL

PostGIS

ST_ContainsProperly(poly, geom)

\n
\n
\n
\n

coveredbyLink to this heading#

\n

Availability: PostGIS,\nOracle, MariaDB, MySQL, PGRaster (Bilateral), SpatiaLite

\n

Uji jika tidak ada titik dalam bidang geometri diluar pencarian geometri. [3]

\n

Contoh:

\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\n\n\n\n\n\n

Backend

Setara SQL

PostGIS

ST_CoveredBy(poly, geom)

Oracle

SDO_COVEREDBY(poly, geom)

MariaDB

MBRCoveredBy(poly, geom)

MySQL

MBRCoveredBy(poly, geom)

SpatiaLite

CoveredBy(poly, geom)

\n
\n\n
\n
\n

coversLink to this heading#

\n

Ketersediaan: PostGIS, Oracle, MySQL, PGRaster (Bilateral), SpatiaLite

\n

Uji jika tidak ada titik dalam pencarian geometri diluar bidang geometri. [3]

\n

Contoh:

\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\n\n\n

Backend

Setara SQL

PostGIS

ST_Covers(poly, geom)

Oracle

SDO_COVERS(poly, geom)

MySQL

MBRCovers(poly, geom)

SpatiaLite

Covers(poly, geom)

\n
\n
\n
\n

crossesLink to this heading#

\n

Ketersediaan: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (Perubahan)

\n

Uji jika bidang geometri secara spasial menyebrangi pencarian geometri.

\n

Contoh:

\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

Backend

Setara 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

Ketersediaan: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Timbal balik)

\n

Coba jika bidang geometri secara spasial diuraikan dari pencarian geometri.

\n

Contoh:

\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

Backend

Setara 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

Ketersediaan: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Perubahan)

\n

Coba jika bidang geometri secara spasial setara pada pencarian geometri.

\n

Contoh:

\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

Backend

Setara 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

Ketersediaan: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Timbal balik)

\n

Tests if the geometry field is "equal" to the lookup geometry. On Oracle,\nMySQL, and SpatiaLite, it tests spatial equality, while on PostGIS it tests\nequality of bounding boxes.

\n

Contoh:

\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

Backend

Setara 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

Ketersediaan: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Timbal balik)

\n

Coba jika bidang geometri secara spasial memotong pencarian geometri.

\n

Contoh:

\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

Backend

Setara 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

Availability: PostGIS,\nSpatiaLite

\n

Tests if the geometry is empty.

\n

Contoh:

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

isvalidLink to this heading#

\n

Availability: MariaDB, MySQL,\nPostGIS, Oracle, SpatiaLite

\n

Coba jika geometri adalah sah.

\n

Contoh:

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

Backend

Setara SQL

MariaDB, MySQL, PostGIS, SpatiaLite

ST_IsValid(poly)

Oracle

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

\n
\n\n
\n
\n

geom_typeLink to this heading#

\n\n

Availability: PostGIS,\nOracle 23c+, MariaDB, MySQL, SpatiaLite

\n

Returns the geometry type of the geometry field.

\n

Contoh:

\n
Code
Zipcode.objects.filter(poly__geom_type="POLYGON")\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Backend

Setara SQL

PostGIS

GeometryType(geom)

MariaDB

ST_GeometryType(geom)

MySQL

ST_GeometryType(geom)

Oracle

SDO_GEOMETRY.GET_GTYPE(geom)

SpatiaLite

GeometryType(geom)

\n
\n
\n
\n

num_dimensionsLink to this heading#

\n\n

Availability: PostGIS,\nSpatiaLite

\n

Returns the number of dimensions used by the geometry.

\n

Contoh:

\n
Code
Zipcode.objects.filter(geom__num_dimensions=3)\n
\n
\n\n\n\n\n\n\n\n\n\n\n

Backend

Setara SQL

PostGIS, SpatiaLite

ST_NDims(geom)

\n
\n
\n
\n

overlapsLink to this heading#

\n

Ketersediaan: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Timbal balik)

\n

Coba jika bidang geometri spasial tumpang tindih pencarian geometri.

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

Backend

Setara 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

Ketersediaan: PostGIS, MariaDB, Oracle, SpatiaLite, PGRaster (Conversion)

\n

Tests if the geometry field is spatially related to the lookup geometry by the\nvalues given in the given pattern. This lookup requires a tuple parameter,\n(geom, pattern); the form of pattern will depend on the spatial\nbackend:

\n
\n

MariaDB, PostGIS, and SpatiaLiteLink to this heading#

\n

On these spatial backends the intersection pattern is a string comprising nine\ncharacters, which define intersections between the interior, boundary, and\nexterior of the geometry field and the lookup geometry. The intersection\npattern matrix may only use the following characters: 1, 2, T,\nF, or *. This lookup type allows users to "fine tune" a specific\ngeometric relationship consistent with the DE-9IM model. [1]

\n

Contoh geometri:

\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 and MariaDB SQL equivalent:

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

SpatiaLite SQL setara:

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

Contoh raster:

\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 setara:

\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

Here the relation pattern is comprised of at least one of the nine relation\nstrings: TOUCH, OVERLAPBDYDISJOINT, OVERLAPBDYINTERSECT,\nEQUAL, INSIDE, COVEREDBY, CONTAINS, COVERS, ON, and\nANYINTERACT. Multiple strings may be combined with the logical Boolean\noperator OR, for example, 'inside+touch'. [2] The relation\nstrings are case-insensitive.

\n

Contoh:

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

Oracle SQL setara:

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

touchesLink to this heading#

\n

Ketersediaan: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite

\n

Coba jika bidang geometri secara spasial menyentuh pencarian geometri.

\n

Contoh:

\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

Backend

Setara 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

Ketersediaan: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Timbal balik)

\n

Coba jika bidang geomrtri secara spasial dalam pencarian geometri.

\n

Contoh:

\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

Backend

Setara 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

Tersedia: PostGIS, PGRaster (Perubahan)

\n

Coba jika kotak pembatas bidang geometri ketat ke kiri dari pencarian kotak pembatas geometri.

\n

Contoh:

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

PostGIS setara:

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

rightLink to this heading#

\n

Tersedia: PostGIS, PGRaster (Perubahan)

\n

Coba jika kotak pembatas bidang geometri tegas ke kanan dari pencarian kotak pembatas geometri.

\n

Contoh:

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

PostGIS setara:

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

overlaps_leftLink to this heading#

\n

Tersedia: PostGIS, PGRaster (Timbal balik)

\n

Coba jika kotak pencarian bidang geometri tumpang tindih atau ke kiri dari pencarian kotak pembatas geometri.

\n

Contoh:

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

PostGIS setara:

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

overlaps_rightLink to this heading#

\n

Tersedia: PostGIS, PGRaster (Timbal balik)

\n

Coba jika kotak pencarian bidang geometri tumpang tindih atau ke kanan dari pencarian kotak pembatas geometri.

\n

Contoh:

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

PostGIS setara:

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

overlaps_aboveLink to this heading#

\n

Tersedia: PostGIS, PGRaster (Perubahan)

\n

Coba jika kotak pembatas bidang geometri tumpang tindih atau diatas pencarian kotak pembatas geometri.

\n

Contoh:

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

PostGIS setara:

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

overlaps_belowLink to this heading#

\n

Tersedia: PostGIS, PGRaster (Perubahan)

\n

Coba jika kotak pembatas bidang geometri tumpang tindih atau dibawah pencarian kotak pembatas geometri.

\n

Contoh:

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

PostGIS setara:

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

strictly_aboveLink to this heading#

\n

Tersedia: PostGIS, PGRaster (Perubahan)

\n

Coba jika kotak pembatas bidang geometri ketat diatas pencarian kotak pembatas geometri.

\n

Contoh:

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

PostGIS setara:

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

strictly_belowLink to this heading#

\n

Tersedia: PostGIS, PGRaster (Perubahan)

\n

Coba jika kotak pembatas bidang geometri ketat dibawah pencarian kotak pembatas geometri.

\n

Contoh:

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

PostGIS setara:

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

Pencarian JarakLink to this heading#

\n

Ketersediaan: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Asli)

\n

Untuk sebuah tinjauan pada melakukan permintaan jarak, hrap mengacu pada distance queries introduction.

\n

Distance lookups take the following form:

\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

The value passed into a distance lookup is a tuple; the first two\nvalues are mandatory, and are the geometry to calculate distances to,\nand a distance value (either a number in units of the field, a\nDistance object, or a query\nexpression). To pass a band index to the lookup, use\na 3-tuple where the second entry is the band index.

\n

Pada setiap pencarian jarak kecuali dwithin, sebuah unsur pilihan, 'spheroid', mungkin disertakan untuk digunakan lebih akurat fungsi perhitungan jarak bulatan dengan sistem kordinat geodetik.

\n

Pada PostgreSQL, pilihan 'spheroid' menggunakan ST_DistanceSpheroid daripada ST_DistanceSphere. Fungsi ST_Distance paling sederhana digunakan dengan sistem kordinat yang sudah dihitung. Raster dirubah ke geometri untuk pencarian berdasarkan spheroid.

\n
\n

distance_gtLink to this heading#

\n

Mengembalikan model-model dimana jarak pada bidang geometri dari geometri pencarian lebih besar dari nilai jarak yang diberikan.

\n

Contoh:

\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

Backend

Setara 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

Mengembalikan model-model dimana jarak pada bidang geometri dari geometri pencarian lebih besar dari atau setara pada nilai jarak diberikan.

\n

Contoh:

\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

Backend

Setara 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

Mengembalikan model-model dimana jarak pada bidang geometri dari geometri pencarian kurang dari nilai jarak yang diberikan.

\n

Contoh:

\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

Backend

Setara 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

Mengembalikan model-model dimana jarak pada bidang geometri dari geometri pencarian kurang dari atau setara pada nilai jarak yang diberikan.

\n

Contoh:

\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

Backend

Setara 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

Mengembalikan model-model dimana jarak pada bidang geometri dari geometri pencarian dalam jarak yang diberikan dari satu lainnya. Catat bahwa anda hanya dapat menyediakan obyek Distance jika geometri tersasar dalam sistem diperhitungkan. Untuk geometri geografis, anda harus menggunakan satuan dari bidang geometri (misalnya tingkatan untuk WGS84) .

\n

Contoh:

\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

Backend

Setara SQL

PostGIS

ST_DWithin(poly, geom, 5)

Oracle

SDO_WITHIN_DISTANCE(poly, geom, 5)

SpatiaLite

PtDistWithin(poly, geom, 5)

\n
\n
\n
\n

Fungsi KumpulanLink to this heading#

\n

Django menyediakan beberapa fungsi pengumpulan khusus-GIS. Untuk rincian pada bagaimana menggunakan fungsi-fungsi pengumpulan ini, lihat the topic guide on aggregation.

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

Argumen Katakunci

Deskripsi

tolerance

This keyword is for Oracle only. It is for the\ntolerance value used by the SDOAGGRTYPE\nprocedure; the Oracle documentation has more\ndetails.

\n
\n

Example:

\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

Availability: PostGIS,\nMariaDB, MySQL, SpatiaLite

\n

Returns a GEOMETRYCOLLECTION or a MULTI geometry object from the\ngeometry column. This is analogous to a simplified version of the\nUnion aggregate, except it can be several orders of magnitude faster\nthan performing a union because it rolls up geometries into a collection or\nmulti object, not caring about dissolving boundaries.

\n\n
\n
\n

ExtentLink to this heading#

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

Tersedia: PostGIS, Oracle, SpatiaLite

\n

Returns the extent of all geo_field in the QuerySet as a 4-tuple,\ncomprising the lower left coordinate and the upper right coordinate.

\n

Example:

\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

Extent3DLink to this heading#

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

Tersedia: PostGIS

\n

Returns the 3D extent of all geo_field in the QuerySet as a 6-tuple,\ncomprising the lower left coordinate and upper right coordinate (each with x,\ny, and z coordinates).

\n

Example:

\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

MakeLineLink to this heading#

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

Tersedia: PostGIS, SpatiaLite

\n

Mengembalikan LineString dibangun dari geometri bidang titik dalam QuerySet. Saat ini pengurutan queryset tidak mempunyai pengaruh.

\n

Example:

\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

UnionLink to this heading#

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

Tersedia: PostGIS, Oracle, SpatiaLite

\n

Metode ini mengembalikan obyek GEOSGeometry terdiri dari gabungan dari setiap geometri dalam queryset. Harap catat bahwa penggunaan dari Union diolah secara intensif dan mungkin mengambil jumlah signifikan waktu pada queryset besar.

\n\n

Example:

\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

Catatan kaki

\n\n
\n
\n
","rootId":"gis-queryset-api-reference","toc":[{"title":"Pencarian Spasial","anchor":"spatial-lookups","children":[{"title":"Pencarian dengan raster","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":"geom_type","anchor":"geom-type","children":[]},{"title":"num_dimensions","anchor":"num-dimensions","children":[]},{"title":"overlaps","anchor":"overlaps","children":[]},{"title":"relate","anchor":"relate","children":[{"title":"MariaDB, PostGIS, and 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":"Pencarian Jarak","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":"Fungsi Kumpulan","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":"Acuan API","url":"/id/6.1/ref/"},{"docname":"ref/contrib/index","title":"Paket contrib","url":"/id/6.1/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/id/6.1/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/forms-api","title":"API Formulir GeoDjango","url":"/id/6.1/ref/contrib/gis/forms-api/"},"next":{"docname":"ref/contrib/gis/functions","title":"Fungsi Basisdata Geografis","url":"/id/6.1/ref/contrib/gis/functions/"},"formats":{"html":"/id/6.1/ref/contrib/gis/geoquerysets/","markdown":"/id/6.1/ref/contrib/gis/geoquerysets.md","json":"/id/6.1/ref/contrib/gis/geoquerysets.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/ref/contrib/gis/geoquerysets.txt","official":"https://docs.djangoproject.com/id/6.1/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","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}