{"title":"Tagairt API GIS QuerySet","version":"5.2","locale":"ga","docname":"ref/contrib/gis/geoquerysets","url":"/ga/5.2/ref/contrib/gis/geoquerysets/","canonical":"https://djangodocs.dev/ga/5.2/ref/contrib/gis/geoquerysets/","summary":"Tá na cuardaigh spásúla sa chuid seo ar fáil le haghaidh: aicme: GeometryField agus:class: Rasterfield.","html":"

Tagairt API GIS QuerySetLink to this heading#

\n
\n

Cuardaigh SpásúlaLink to this heading#

\n

Tá na cuardaigh spásúla sa chuid seo ar fáil le haghaidh: aicme: GeometryField agus:class: Rasterfield.

\n

<spatial-lookups-intro>Le haghaidh réamhrá, féach an:ref: `réamhrá cuardaigh spásúla `. <spatial-lookup-compatibility>Chun forbhreathnú a fháil ar na cuardaigh atá comhoiriúnach le cúltaca spásúil áirithe, féach faoir:ref: `tábla comhoiriúnachta cuardaigh spásúil `.

\n
\n

Cuardaigh le rastersLink to this heading#

\n

Tugtar na samplaí go léir sa tagairt thíos do réimsí geoiméadrachta agus ionchuir, ach is féidir na cuardaigh a úsáid ar an mbealach céanna le rasters ar an dá thaobh. < https://postgis.net/docs/RT_ST_Polygon.html>Aon uair nach dtacaíonn cuardach le hionchur raster, déantar an t-ionchur a thiontú go géiméadracht go huathoibríoch nuair is gá ag baint úsáide as an bhfeidhm ST_Polygon. <spatial-lookup-raster>Féach freis:ref: `réamhrá ar chuardach raster `.

\n

Is féidir na hoibreoirí bunachar sonraí a úsáideann na cuardaigh a roinnt ina thrí chatagóir:

\n\n

Taispeánann na samplaí thíos an coibhéis SQL do na cuardaigh sna cineálacha éagsúla tacaíochta raster. Baineann an patrún céanna le gach cuardach spásúil.

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

Cás

Cuardaigh

Coibhéis SQL

N, B

rast__contains=rst

``ST_Contains (réidh, an chéad) ``

N, B

``rast__1__contains= (an chéad, 2) ``

``ST_Contains (ceart, 1, an chéad, 2) ``

B, C

rast__contains=geom

``ST_Contains (ST_polygon (ar dheis), geom) ``

B, C

rast__1__contains=geom

``ST_Contains (ST_polygon (ceart, 1), geom) ``

B, C

poly__contains=rst

``ST_Contains (poly, ST_polygon (rst)) ``

B, C

``poly__contains= (an chéad, 1) ``

``ST_Contains (poly, ST_polygon (rst, 1)) ``

C

rast__crosses=rst

``ST_Crosses (ST_polygon (ar dheis), ST_polygon (an chéad)) ``

C

``rast__1__crosses= (an chéad, 2) ``

``ST_Crosses (ST_polygon (ceart, 1), ST_polygon (an chéad, 2)) ``

C

rast__crosses=geom

``ST_Crosses (ST_polygon (ar dheis), geom) ``

C

poly__crosses=rst

``ST_Crosses (poli, ST_polygon (rst)) ``

\n
\n

Ní thacaítear le cuardaigh spásúla le rasters ach le cúltaca PostGIS (ainmnítear mar PGraster sa chuid seo).

\n
\n
\n

bbcontainsLink to this heading#

\n

Infhaighteacht: `PostGIS`__ < https://postgis.net/docs/ST_Geometry_Contain.html>, MariaDB, MySQL, Spatialite, PGraster (Dúchasach)

\n

Tástálacha má tá bosca teorainneacha an geoiméadra cuardaigh go hiomlán i mbosca teorainneacha an ghéimseadra nó sa réimse raster.

\n

Sampla:

\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

Cúltaca

Coibhéis 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

Infhaighteacht: `PostGIS`__ < https://postgis.net/docs/geometry_overlaps.html>, MariaDB, MySQL, Spatialite, PGraster (Dúchasach)

\n

Déanann tástálacha má fhorluíonn bosca teorainneacha an réimse geoiméadachta bosca teorainneacha an choiméadra cuardaigh.

\n

Sampla:

\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

Cúltaca

Coibhéis SQL

PostGIS

Polai & & Geom

MariaDB

``Mbroverlaps (poly, geom) ``

MySQL

``Mbroverlaps (poly, geom) ``

Spatialite

``Mbroverlaps (poly, geom) ``

\n
\n
\n
\n

CoimeádaíLink to this heading#

\n

Infhaighteacht: `PostGIS`__ < https://postgis.net/docs/ST_Geometry_Contained.html>, MariaDB, MySQL, Spatialite, PGraster (Dúchasach)

\n

Tástálacha má tá bosca teorainneacha an réimse geoiméadachta cuardaigh go hiomlán i mbosca teorainneacha an réimse geoiméadrach.

\n

Sampla:

\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

Cúltaca

Coibhéis SQL

PostGIS

Poly @ geom

MariaDB

``MBRwithin (poly, geom) ``

MySQL

``MBRwithin (poly, geom) ``

Spatialite

``MBRwithin (poly, geom) ``

\n
\n
\n
\n

CoimeádLink to this heading#

\n

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

\n

Tástálacha má tá an geoiméadracht cuardaigh sa réimse geoiméadrach spásúil.

\n

Sampla:

\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

Cúltaca

Coibhéis SQL

PostGIS

``ST_Contains (poly, geom) ``

Oracle

``SDO_CONTAINS (poly, geom) ``

MariaDB

``ST_Contains (poly, geom) ``

MySQL

``ST_Contains (poly, geom) ``

Spatialite

``Tá (poly, geom) ``

\n
\n
\n
\n

``coinníomhaíon_ceart ``Link to this heading#

\n

< https://postgis.net/docs/ST_ContainsProperly.html>*Infhaighteacht*: `PostGIS`__, PGraster (Déthaobhach)

\n

Filleann sé fíor má thrasnaíonn an geoiméadracht cuardaigh taobh istigh den réimse geoiméadrach, ach ní an teorainn (nó an taobh amuigh).

\n

Sampla:

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

Cúltaca

Coibhéis SQL

PostGIS

``ST_CONTAINSProperly (poly, geom) ``

\n
\n
\n
\n

``clúdaithe ag ``Link to this heading#

\n

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

\n

Tástálacha mura bhfuil aon phointe sa réimse geoiméadrach lasmuigh den ghéimseadracht cuardaigh [#fncovers] _

\n

Sampla:

\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

Cúltaca

Coibhéis SQL

PostGIS

``St_CoveredBy (poly, geom) ``

Oracle

``SDO_COVEREDBY (poly, geom) ``

MySQL

MBRCoveredBy(poly, geom)

Spatialite

``CoveredBy (poly, geom) ``

\n
\n\n
\n
\n

``clúdaithe ``Link to this heading#

\n

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

\n

Tástálacha mura bhfuil aon phointe sa ghéimseadracht cuardaigh lasmuigh den réimse geoiméadachta [#fncovers] _

\n

Sampla:

\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

Cúltaca

Coibhéis SQL

PostGIS

``ST_Clúdaigh (poly, geom) ``

Oracle

``SDO_COVERS (poly, geom) ``

MySQL

MBRCovers(poly, geom)

Spatialite

``Clúdaigh (poli, geom) ``

\n
\n\n
\n
\n

trasnaLink to this heading#

\n

Infhaighteacht: `PostGIS`__ < https://postgis.net/docs/ST_Crosses.html>, MariaDB, MySQL, Spatialite, PGraster (Comhshó)

\n

Tástálacha má thrasnaíonn an réimse geoiméadrachta an geoiméadracht cuardaigh

\n

Sampla:

\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

Cúltaca

Coibhéis SQL

PostGIS

``St_Crosses (poly, geom) ``

MariaDB

``St_Crosses (poly, geom) ``

MySQL

``St_Crosses (poly, geom) ``

Spatialite

``Croisí (poli, geom) ``

\n
\n
\n
\n

dícheangailtiLink to this heading#

\n

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

\n

Tástálacha má tá an réimse geoiméadrachta neamhspleách go spásúil ón gcéimseadra cuardaigh.

\n

Sampla:

\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

Cúltaca

Coibhéis 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

comhionannaiLink to this heading#

\n

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

\n

Tástálacha má tá an réimse geoiméadrach cothrom go spásúil leis an gcéiméadra cuardaigh

\n

Sampla:

\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

Cúltaca

Coibhéis SQL

PostGIS

``ST_EQUALS (poly, geom) ``

Oracle

``SDO_EQUAL (poly, geom) ``

MariaDB

``ST_EQUALS (poly, geom) ``

MySQL

``ST_EQUALS (poly, geom) ``

Spatialite

``Cothrom (poly, geom) ``

\n
\n
\n
\n

`cruth, ``an gcéann_mar ``Link to this heading#

\n

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

\n

Tástálacha má tá an réimse geoiméadrach “comhionann” leis an gcéiméadra cuardaigh. Ar Oracle, MySQL, agus SpatiaLite, déanann sé tástáil ar chomhionannas spásúil, agus ar PostGIS déanann sé tástáil ar chomhionannas boscaí teorainneacha.

\n

Sampla:

\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

Cúltaca

Coibhéis SQL

PostGIS

poly ~= geom

Oracle

``SDO_EQUAL (poly, geom) ``

MariaDB

``ST_EQUALS (poly, geom) ``

MySQL

``ST_EQUALS (poly, geom) ``

Spatialite

``Cothrom (poly, geom) ``

\n
\n
\n
\n

CraitheangairLink to this heading#

\n

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

\n

Tástálacha má thrasnaíonn an réimse geoiméadrach an geoiméadracht cuardaigh go spásúil.

\n

Sampla:

\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

Cúltaca

Coibhéis 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

< https://postgis.net/docs/ST_IsEmpty.html>*Infhaighteacht*: `PostGis`__

\n

Tástálacha má tá an geoiméadracht folamh.

\n

Sampla:

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

“Is bailí”Link to this heading#

\n

< https://postgis.net/docs/ST_IsValid.html>*Infhaighteacht*: MySQL, `PostGis`__, Oracle, Spatialite

\n

Tástálacha má tá an geoiméadracht bailí.

\n

Sampla:

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

Cúltaca

Coibhéis SQL

MySQL, PostGIS, Spatialite

``St_IsValid (poli) ``

Oracle

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

\n
\n
\n
\n

forlapsLink to this heading#

\n

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

\n

Tástálacha má fhorluíonn an réimse geoiméadrachta go spásúil ar an gcéiméadra

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

Cúltaca

Coibhéis SQL

PostGIS

``St_overforluí (poly, geom) ``

Oracle

``SDO_OVERLAPES (poly, geom) ``

MariaDB

``St_overforluí (poly, geom) ``

MySQL

``St_overforluí (poly, geom) ``

Spatialite

``Forluí (poly, geom) ``

\n
\n
\n
\n

``gaolmhar ``Link to this heading#

\n

Availability: PostGIS,\nMariaDB, Oracle, SpatiaLite, PGRaster (Conversion)

\n

Tástálacha má tá baint spásúil ag an réimse geoiméadair leis an gcéiméadra cuardaigh de réir na luachanna a thugtar sa phatrún tugtha. Éilíonn an cuardach seo paraiméadar tuple, (geom, patrún); beidh foirm ``patrún ``ag brath ar an gcúltaca spásúil:

\n
\n

MariaDB, PostGIS, agus SpatialiteLink to this heading#

\n

Ar na cúltaca spásúla seo is teaghrán é an patrún trasna ina bhfuil naoi charachtar, a shainmhíníonn trasnáithe idir taobh istigh, teorainn agus taobh amuigh den réimse geoiméadrach agus an geoiméadracht cuardaigh. Ní féidir leis an maitrís phatrún trasna ach na carachtair seo a leanas a úsáid: 1, 2, T`, F`, nó *. Ligeann an cineál cuardaigh seo d'úsáideoirí caidreamh geoiméadrach ar leith a “tiúnadh go mín” atá comhsheasmhach leis an tsamhail DE-9IM. [#fnde9im] _

\n

Sampla geoiméadair:

\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

Coibhéis PostGIS agus MariaDB SQL:

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

Coibhéis SQL SpatialITE:

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

Sampla 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

Coibhéis 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

Anseo tá an patrún caidrimh comhdhéanta de cheann amháin ar a laghad de na naoi teaghrán caidrimh: TOUCH`, OVERLAPBDYDISJOINT`, OVERLAPBDYINTERSECT`, EQUAL`, INSIDE`, COVEREDBY`, CONTAINS`, COVERS`, ON`ANY, agus ``ON`ANY`, agus ````ON`ANY`, agus ``IDIRGHNÍOMHAÍOCHT. Féadfar teaghráin iolracha a chomhcheangal leis an oibreoir loighciúil Boolean NÓ, mar shampla, `laistich+teagmháil '. [#fnsdorelate] _ Tá na teaghráin caidrimh neamh-íogair.

\n

Sampla:

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

Coibhéis Oracle SQL:

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

teagmhálachaLink to this heading#

\n

< https://postgis.net/docs/ST_Touches.html>*Infhaighteacht*: `PostGIS`__, Oracle, MariaDB, MySQL, Spatialite

\n

Tástálacha má théann an réimse geoiméadrachta i dteagmháil go spásúil leis an

\n

Sampla:

\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

Cúltaca

Coibhéis 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

``laistigh de ``Link to this heading#

\n

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

\n

Tástálacha má tá an réimse geoiméadrachta go spásúil laistigh den ghéimseadracht

\n

Sampla:

\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

Cúltaca

Coibhéis SQL

PostGIS

``St_within (poly, geom) ``

MariaDB

``St_within (poly, geom) ``

MySQL

``St_within (poly, geom) ``

Oracle

``SDO_INSIDE (poly, geom) ``

Spatialite

``Laistigh de (poly, geom) ``

\n
\n
\n
\n

``chlé `Link to this heading#

\n

< https://postgis.net/docs/ST_Geometry_Left.html>*Infhaighteacht*: `PostGIS`__, PGraster (Comhshó)

\n

Tástálacha má tá bosca teorainneacha an réimse geoiméadrachta go docht ar thaobh clé de bhosca teorainneacha an geoiméadrachta cuardaigh.

\n

Sampla:

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

Coibhéis PostGIS:

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

ceartLink to this heading#

\n

< https://postgis.net/docs/ST_Geometry_Right.html>*Infhaighteacht*: `PostGIS`__, PGraster (Comhshó)

\n

Tástálacha má tá bosca teorainneacha an réimse geoiméadrachta go docht ar dheis de bhosca teorainneacha an geoiméadrachta cuardaigh.

\n

Sampla:

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

Coibhéis PostGIS:

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

``overlaps_chlé ``Link to this heading#

\n

< https://postgis.net/docs/ST_Geometry_Overleft.html>*Infhaighteacht*: `PostGIS`__, PGraster (Déthaobhach)

\n

Tástálacha má théann bosca teorainneacha an réimse geoiméadrachta forluí nó má tá sé ar thaobh clé de bhosca teorainneacha an geoiméadrachta cuardaigh.

\n

Sampla:

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

Coibhéis PostGIS:

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

overlaps_rightLink to this heading#

\n

< https://postgis.net/docs/ST_Geometry_Overright.html>*Infhaighteacht*: `PostGIS`__, PGraster (Déthaobhach)

\n

Tástálacha má théann bosca teorainneacha an réimse geoiméadrachta forluí nó má tá sé ar dheis de bhosca teorainneacha an geoiméadrachta cuardaigh.

\n

Sampla:

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

Coibhéis PostGIS:

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

overlaps_thuasLink to this heading#

\n

< https://postgis.net/docs/ST_Geometry_Overabove.html>*Infhaighteacht*: `PostGIS`__, PGraster (Comhshó)

\n

Tástálacha má théann bosca teorainneacha an réimse geoiméadachta forluí nó má tá sé os cionn bosca teorainneacha an geoiméadrachta cuardaigh

\n

Sampla:

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

Coibhéis PostGIS:

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

overlaps_thíosLink to this heading#

\n

< https://postgis.net/docs/ST_Geometry_Overbelow.html>*Infhaighteacht*: `PostGIS`__, PGraster (Comhshó)

\n

Tástálacha má théann bosca teorainneacha an réimse geoiméadrachta forluí nó má tá sé faoi bhun bosca teorainneacha an ghéimseadrachta cu

\n

Sampla:

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

Coibhéis PostGIS:

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

docht thuasLink to this heading#

\n

< https://postgis.net/docs/ST_Geometry_Above.html>*Infhaighteacht*: `PostGIS`__, PGraster (Comhshó)

\n

Tástálacha má tá bosca teorainneacha an réimse geoiméadachta go docht os cionn bosca teorainneacha an ghéimseadra cuardaigh.

\n

Sampla:

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

Coibhéis PostGIS:

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

``docht thíos ``Link to this heading#

\n

< https://postgis.net/docs/ST_Geometry_Below.html>*Infhaighteacht*: `PostGIS`__, PGraster (Comhshó)

\n

Tástálacha má tá bosca teorainneacha an réimse geoiméadrach faoi bhun bosca teorainneacha an ghéimseadrachta cuardaigh.

\n

Sampla:

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

Coibhéis PostGIS:

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

Cuardaigh FadLink to this heading#

\n

Availability: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Native)

\n

<distance-queries>Le haghaidh forbhreathnú ar cheisteanna achair a dhéanamh, féach le do thoil faoir:ref: `réamhrá ceisteanna achair `.

\n

Tá an fhoirm seo a leanas ag cuardach achair:

\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

Is é an luach a chuirtear isteach i gcuardach achair; tá an chéad dá luach éigeantach, agus is iad an geoiméadra chun achair a ríomh, agus luach achair (uimhir in aonaid den réimse, a: aicme: ~django.contrib.gis.Measure.distance réad, nó a:doc: `</ref/models/expressions> léiriú fiosraithe'). Chun innéacs banna a chur chuig an lorg, bain úsáid as 3-tuple ina bhfuil an dara iontráil an t-innéacs banna.

\n

Ar gach cuardach achair ach amháin: lookup: dwithin, féadfar eilimint roghnach, spheroid, a chur san áireamh chun na feidhmeanna ríofa achair spheroid níos cruinne a úsáid ar réimsí le córas comhordaithe geodéiseach.

\n

< https://postgis.net/docs/ST_Distance_Spheroid.html> < https://postgis.net/docs/ST_DistanceSphere.html>Ar PostgreSQL, úsáideann an rogha 'spheroid' `ST_distanceSpheroid`__ in ionad `ST_distanceSphere`__. Úsáidtear an fheidhm `ST_distance`__ níos simplí le córais chomhordaithe ré< https://postgis.net/docs/ST_Distance.html> amh-mheasta. Déantar rasters a thiontú go geoiméadraí le haghaidh cuardaigh bunaithe ar spheroid.

\n
\n

Fachad_gtLink to this heading#

\n

Tugann samhlacha ar ais ina bhfuil an fad chuig an réimse geoiméadais ón gcéimseadra cuardaigh níos mó ná an luach achair a thugtar.

\n

Sampla:

\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

Cúltaca

Coibhéis 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 (poli, geom, 0.05) > 5

Spatialite

Fad (poli, geom) > 5

\n
\n
\n
\n

achtar_gteLink to this heading#

\n

Tugann samhlacha ar ais ina bhfuil an fad chuig an réimse geoiméadais ón gcéimseadra cuardaigh níos mó ná nó cothrom leis an luach achair ar leith.

\n

Sampla:

\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

Cúltaca

Coibhéis 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 (poli, geom, 0.05) >= 5

Spatialite

Fad (poli, geom) >= 5

\n
\n
\n
\n

Fachad_ltLink to this heading#

\n

Tugann samhlacha ar ais ina bhfuil an fad go réimse an geoiméadais ón gcéimseadra cuardaigh níos lú ná an luach achair a thugtar.

\n

Sampla:

\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

Cúltaca

Coibhéis 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 (poli, geom, 0.05) < 5

Spatialite

Fad (poli, geom) < 5

\n
\n
\n
\n

Fachad_lteLink to this heading#

\n

Tugann samhlacha ar ais ina bhfuil an fad chuig an réimse geoiméadais ón gcéimseadra cuardaigh níos lú ná nó cothrom leis an luach achair ar leith.

\n

Sampla:

\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

Cúltaca

Coibhéis 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 (poli, geom, 0.05) <= 5

Spatialite

Fad (poli, geom) <= 5

\n
\n
\n
\n

``thíníLink to this heading#

\n

Tuairisceáin samhlacha ina bhfuil an fad go réimse an geoiméadais ón gcéimseadra cuardaigh laistigh den achar sonraithe óna chéile. Tabhair faoi deara nach féidir leat rudaí:class: ~django.contrib.gis.Measure.distance a sholáthar ach má tá na geoiméadrachtaí spriocdhírithe i gcóras réamh-mheasta. Maidir le geoiméadraí geografacha, ba chóir duit aonaid den réimse geoiméadrach a úsáid (m.sh. céimeanna do WGS84`).

\n

Sampla:

\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

Cúltaca

Coibhéis SQL

PostGIS

``St_dWithin (poly, geom, 5) ``

Oracle

``SDO_WITHIN_DISTANCE (poly, geom, 5) ``

Spatialite

``PTdistWithin (poly, geom, 5) ``

\n
\n
\n
\n

Feidhmeanna ChomLink to this heading#

\n

Soláthraíonn Django roinnt feidhmeanna comhiomlán atá sonrach le GIS. Le haghaidh sonraí maidir le conas na feidhmeanna comhiomlána seo a úsáid, féach:doc: `an treoir ábhair ar chomhiomlán' </topics/db/aggregation>.

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

Argóint Eochairfho

Cur síos

``lamháltas ``

Tá an eochairfhocal seo le haghaidh Oracle amháin. Tá sé don luach lamháltais a úsáideann an nós imeachta SDOAGGRTYPE`; tá tuilleadh sonraí ag doiciméadú `Oracle`__.

\n
\n

Sampla:

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

BailiúchLink to this heading#

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

< https://postgis.net/docs/ST_Collect.html>*Infhaighteacht*: `PostGIS`__, MySQL, Spatialite

\n

Filleann sé réad geoiméadachta GEOMETRYCOLLECTION nó réad geoiméadais MULTI ón gcolún geoiméadrach. Tá sé seo cosúil le leagan simplithe den chomhiomlán: aicme: Union, ach amháin gur féidir leis a bheith roinnt orduithe méide níos tapa ná aontas a dhéanamh toisc go rollaíonn sé geoiméadraí i mbailiúchán nó ilréad, gan cúram faoi theorainneacha a thuaslagadh.

\n\n
\n
\n

Faoi láimhseLink to this heading#

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

< https://postgis.net/docs/ST_Extent.html>*Infhaighteacht*: `PostGIS`__, Oracle, Spatialite

\n

Tugann sé ar ais méid na geo_field` go léir sa QuerySet mar 4-tuple, lena n-áirítear an comhordanáid íochtarach ar chlé agus an comhordanáid uachtarach ar dheis.

\n

Sampla:

\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

< https://postgis.net/docs/ST_3DExtent.html>*Infhaighteacht*: `PostGis`__

\n

Filleann sé méid 3D gach geo_field sa QuerySet` mar thúpla 6, lena n-áirítear an comhordanáid íochtarach ar chlé agus an comhordanáid uachtarach ar dheis (gach ceann acu le comhordanáidí x, y, agus z).

\n

Sampla:

\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

< https://postgis.net/docs/ST_MakeLine.html>*Infhaighteacht*: `PostGis`__, Spatialite

\n

Filleann sé Linestring a tógadh ó na geoiméadrachtaí réimse pointe sa QuerySet. Faoi láthair, níl aon éifeacht ag ordú an tacar fiosrúcháin.

\n

Sampla:

\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

AontasLink to this heading#

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

< https://postgis.net/docs/ST_Union.html>*Infhaighteacht*: `PostGIS`__, Oracle, Spatialite

\n

Tugann an modh seo a: aicme: ~django.contrib.gis.geos.geosgeometry réad a chuimsíonn aontas gach geoiméadair sa tacar fiosrúcháin. Tabhair faoi deara le do thoil go bhfuil úsáid “Union” dian ar phróiseálaí agus go bhféadfadh sé go dtógfadh sé go leor ama ar cheisteanna móra.

\n\n

Sampla:

\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

Fonótaí

\n\n
\n
\n
","rootId":"gis-queryset-api-reference","toc":[{"title":"Cuardaigh Spásúla","anchor":"spatial-lookups","children":[{"title":"Cuardaigh le rasters","anchor":"lookups-with-rasters","children":[]},{"title":"bbcontains","anchor":"bbcontains","children":[]},{"title":"bboverlaps","anchor":"bboverlaps","children":[]},{"title":"Coimeádaí","anchor":"contained","children":[]},{"title":"Coimeád","anchor":"contains","children":[]},{"title":"``coinníomhaíon_ceart ``","anchor":"contains-properly","children":[]},{"title":"``clúdaithe ag ``","anchor":"coveredby","children":[]},{"title":"``clúdaithe ``","anchor":"covers","children":[]},{"title":"trasna","anchor":"crosses","children":[]},{"title":"dícheangailti","anchor":"disjoint","children":[]},{"title":"comhionannai","anchor":"equals","children":[]},{"title":"`cruth, ``an gcéann_mar ``","anchor":"exact-same-as","children":[]},{"title":"Craitheangair","anchor":"intersects","children":[]},{"title":"isempty","anchor":"isempty","children":[]},{"title":"“Is bailí”","anchor":"isvalid","children":[]},{"title":"forlaps","anchor":"overlaps","children":[]},{"title":"``gaolmhar ``","anchor":"relate","children":[{"title":"MariaDB, PostGIS, agus Spatialite","anchor":"mariadb-postgis-and-spatialite","children":[]},{"title":"Oracle","anchor":"oracle","children":[]}]},{"title":"teagmhálacha","anchor":"touches","children":[]},{"title":"``laistigh de ``","anchor":"within","children":[]},{"title":"``chlé `","anchor":"left","children":[]},{"title":"ceart","anchor":"right","children":[]},{"title":"``overlaps_chlé ``","anchor":"overlaps-left","children":[]},{"title":"overlaps_right","anchor":"overlaps-right","children":[]},{"title":"overlaps_thuas","anchor":"overlaps-above","children":[]},{"title":"overlaps_thíos","anchor":"overlaps-below","children":[]},{"title":"docht thuas","anchor":"strictly-above","children":[]},{"title":"``docht thíos ``","anchor":"strictly-below","children":[]}]},{"title":"Cuardaigh Fad","anchor":"distance-lookups","children":[{"title":"Fachad_gt","anchor":"distance-gt","children":[]},{"title":"achtar_gte","anchor":"distance-gte","children":[]},{"title":"Fachad_lt","anchor":"distance-lt","children":[]},{"title":"Fachad_lte","anchor":"distance-lte","children":[]},{"title":"``thíní","anchor":"dwithin","children":[]},{"title":"Feidhmeanna Chom","anchor":"aggregate-functions","children":[{"title":"Bailiúch","anchor":"collect","children":[]},{"title":"Faoi láimhse","anchor":"extent","children":[]},{"title":"Extent3D","anchor":"extent3d","children":[]},{"title":"Makeline","anchor":"makeline","children":[]},{"title":"Aontas","anchor":"union","children":[]}]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/5.2/ref/"},{"docname":"ref/contrib/index","title":"Pacáistí contrib","url":"/ga/5.2/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeodJango","url":"/ga/5.2/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/forms-api","title":"Foirmeacha API GeodJango","url":"/ga/5.2/ref/contrib/gis/forms-api/"},"next":{"docname":"ref/contrib/gis/functions","title":"Feidhmeanna Bunachar Sonraí","url":"/ga/5.2/ref/contrib/gis/functions/"},"formats":{"html":"/ga/5.2/ref/contrib/gis/geoquerysets/","markdown":"/ga/5.2/ref/contrib/gis/geoquerysets.md","json":"/ga/5.2/ref/contrib/gis/geoquerysets.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/contrib/gis/geoquerysets.txt","official":"https://docs.djangoproject.com/ga/5.2/ref/contrib/gis/geoquerysets/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}