{"title":"GIS QuerySet API-referens","version":"6.1","locale":"sv","docname":"ref/contrib/gis/geoquerysets","url":"/sv/6.1/ref/contrib/gis/geoquerysets/","canonical":"https://djangodocs.dev/sv/6.1/ref/contrib/gis/geoquerysets/","summary":"De rumsliga uppslagningarna i detta avsnitt är tillgängliga för GeometryField och RasterField. För en introduktion, se introduktionen till spatiala uppslag.","html":"

GIS QuerySet API-referensLink to this heading#

\n
\n

Rumsliga uppslagningarLink to this heading#

\n

De rumsliga uppslagningarna i detta avsnitt är tillgängliga för GeometryField och RasterField.

\n

För en introduktion, se introduktionen till spatiala uppslag. En översikt över vilka uppslag som är kompatibla med en viss spatial backend finns i kompatibilitetstabellen för spatiala uppslag.

\n
\n

Uppslagningar med rasterLink to this heading#

\n

Alla exempel i referensen nedan ges för geometriska fält och inmatningar, men uppslagningarna kan användas på samma sätt med raster på båda sidor. När en lookup inte stöder rasterinmatning konverteras inmatningen automatiskt till en geometri där så behövs med hjälp av funktionen ST_Polygon. Se även introduktion till rasteruppslagningar.

\n

De databasoperatörer som används vid uppslagningarna kan delas in i tre kategorier:

\n\n

Exemplen nedan visar SQL-motsvarigheten för uppslagningarna i de olika typerna av rasterstöd. Samma mönster gäller för alla spatiala uppslagningar.

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

Case

Uppslag

SQL-ekvivalent

N, B

rast__innehåller=rst

ST_Contains(rast, rst)

N, B

rast__1__contains=(rst, 2)

ST_Contains(rast, 1, rst, 2)

B, C

rast__innehåller=geom

ST_Contains(ST_Polygon(rast), geom)

B, C

rast__1__innehåller=geom

ST_Contains(ST_Polygon(rast, 1), geom)

B, C

poly__innehåller=rst

ST_Contains(poly, ST_Polygon(rst))

B, C

poly__contains=(rst, 1)

ST_Contains(poly, ST_Polygon(rst, 1))

C

rast__korsningar=rst

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

C

rast__1__korsningar=(rst, 2)

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

C

rast__korsningar=geom

ST_Crosses(ST_Polygon(rast), geom)

C

poly__kors=rst

ST_Crosses(poly, ST_Polygon(rst))

\n
\n

Rumsliga uppslagningar med raster stöds endast för PostGIS-backends (benämns som PGRaster i detta avsnitt).

\n
\n
\n

bbcontainsLink to this heading#

\n

Tillgänglighet: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (inbyggd)

\n

Testar om geometrins eller rasterfältets begränsningsbox helt och hållet innehåller uppslagsgeometrins begränsningsbox.

\n

Exempel:

\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

SQL-ekvivalent

PostGIS

poly ~ geom

MariaDB

MBRContains(poly, geom)

MySQL

MBRContains(poly, geom)

SpatiaLite

MbrInnehåller(poly, geom)

\n
\n
\n
\n

bboverlapsLink to this heading#

\n

Tillgänglighet: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (inbyggd)

\n

Testar om geometrifältets avgränsningsbox överlappar uppslagsgeometrins avgränsningsbox.

\n

Exempel:

\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

SQL-ekvivalent

PostGIS

poly && geom

MariaDB

MBROverlaps(poly, geom)

MySQL

MBROverlaps(poly, geom)

SpatiaLite

MbrOverlaps(poly, geom)

\n
\n
\n
\n

innehållenLink to this heading#

\n

Tillgänglighet: PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (inbyggd)

\n

Testar om geometrifältets avgränsningsbox är helt innesluten i uppslagsgeometrins avgränsningsbox.

\n

Exempel:

\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

SQL-ekvivalent

PostGIS

poly @ geom

MariaDB

MBRInom(poly, geom)

MySQL

MBRInom(poly, geom)

SpatiaLite

MbrInom(poly, geom)

\n
\n
\n
\n

innehållerLink to this heading#

\n

Tillgänglighet: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

Testar om geometrifältet rumsligt innehåller uppslagsgeometrin.

\n

Exempel:

\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

SQL-ekvivalent

PostGIS

ST_Contains(poly, geom)

Oracle

SDO_CONTAINS(poly, geom)

MariaDB

ST_Contains(poly, geom)

MySQL

ST_Contains(poly, geom)

SpatiaLite

Innehåller(poly, geom)

\n
\n
\n
\n

innehåller_riktigtLink to this heading#

\n

Tillgänglighet: PostGIS, PGRaster (Bilateral)

\n

Returnerar true om uppslagsgeometrin skär geometrins insida, men inte dess gräns (eller utsida).

\n

Exempel:

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

Backend

SQL-ekvivalent

PostGIS

ST_ContainsProperly(poly, geom)

\n
\n
\n
\n

”täckt avLink to this heading#

\n

Tillgänglighet: PostGIS, Oracle, MariaDB, MySQL, PGRaster (bilateral), SpatiaLite

\n

Testar om ingen punkt i geometrifältet ligger utanför lookup-geometrin. [3] _

\n

Exempel:

\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

SQL-ekvivalent

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

överdragLink to this heading#

\n

Tillgänglighet: PostGIS, Oracle, MySQL, PGRaster (Bilateral), SpatiaLite

\n

Testar om ingen punkt i uppslagsgeometrin ligger utanför geometrifältet. [3] _

\n

Exempel:

\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

SQL-ekvivalent

PostGIS

ST_Covers(poly, geom)

Oracle

SDO_COVERS(poly, geom)

MySQL

MBRCovers(poly, geom)

SpatiaLite

Täckningar(poly, geom)

\n
\n
\n
\n

korsningarLink to this heading#

\n

Tillgänglighet: postGIS <https://postgis.net/docs/ST_Crosses.html>`__, MariaDB, MySQL, SpatiaLite, PGRaster (konvertering)

\n

Testar om geometrifältet rumsligt korsar lookup-geometrin.

\n

Exempel:

\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

SQL-ekvivalent

PostGIS

ST_Crosses(poly, geom)

MariaDB

ST_Crosses(poly, geom)

MySQL

ST_Crosses(poly, geom)

SpatiaLite

Korsningar(poly, geom)

\n
\n
\n
\n

disjunktLink to this heading#

\n

Tillgänglighet: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

Testar om geometrifältet är rumsligt åtskilt från uppslagsgeometrin.

\n

Exempel:

\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

SQL-ekvivalent

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

likvärdigaLink to this heading#

\n

Tillgänglighet: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Konvertering)

\n

Testar om geometrifältet är rumsligt lika med uppslagsgeometrin.

\n

Exempel:

\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

SQL-ekvivalent

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

Tillgänglighet: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

Testar om geometrifältet är ”lika” med uppslagsgeometrin. På Oracle, MySQL och SpatiaLite testar det rumslig likhet, medan det på PostGIS testar likhet mellan begränsningsrutor.

\n

Exempel:

\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

SQL-ekvivalent

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

skärningspunkterLink to this heading#

\n

Tillgänglighet: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

Testar om geometrifältet rumsligt korsar uppslagsgeometrin.

\n

Exempel:

\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

SQL-ekvivalent

PostGIS

ST_Intersects(poly, geom)

Oracle

SDO_OVERLAPBDYINTERSECT(poly, geom)

MariaDB

ST_Intersects(poly, geom)

MySQL

ST_Intersects(poly, geom)

SpatiaLite

Intersekter(poly, geom)

\n
\n
\n
\n

isemptyLink to this heading#

\n

Tillgänglighet: PostGIS, SpatiaLite

\n

Testar om geometrin är tom.

\n

Exempel:

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

isvalidLink to this heading#

\n

Tillgänglighet: MariaDB, MySQL, PostGIS, Oracle, SpatiaLite

\n

Testar om geometrin är giltig.

\n

Exempel:

\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

SQL-ekvivalent

MariaDB, MySQL, PostGIS, SpatiaLite

ST_IsValid(poly)

Oracle

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

\n
\n\n
\n
\n

geom_typLink to this heading#

\n\n

Tillgänglighet: PostGIS, Oracle 23c+, MariaDB, MySQL, SpatiaLite

\n

Returnerar geometritypen för geometrifältet.

\n

Exempel:

\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

SQL-ekvivalent

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

Tillgänglighet: PostGIS, SpatiaLite

\n

Returnerar antalet dimensioner som geometrin använder.

\n

Exempel:

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

Backend

SQL-ekvivalent

PostGIS, SpatiaLite

ST_NDims(geom)

\n
\n
\n
\n

överlapparLink to this heading#

\n

Tillgänglighet: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

Testar om geometrifältet spatialt överlappar lookup-geometrin.

\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

SQL-ekvivalent

PostGIS

ST_Overlaps(poly, geom)

Oracle

SDO_OVERLAPS(poly, geom)

MariaDB

ST_Overlaps(poly, geom)

MySQL

ST_Overlaps(poly, geom)

SpatiaLite

Överlappningar(poly, geom)

\n
\n
\n
\n

förhållandeLink to this heading#

\n

Tillgänglighet: PostGIS, MariaDB, Oracle, SpatiaLite, PGRaster (Konvertering)

\n

Testar om geometrifältet har en spatial relation till uppslagsgeometrin utifrån värdena i det angivna mönstret. Detta uppslag kräver en tuppelparameter, (geom, pattern); formen för pattern beror på den spatiala backend som används:

\n
\n

MariaDB, PostGIS och SpatiaLiteLink to this heading#

\n

På dessa spatiala backendar är skärningsmönstret en sträng med nio tecken som definierar skärningar mellan det inre, gränsen och det yttre hos geometrifältet och uppslagsgeometrin. Matrisen för skärningsmönstret får endast använda följande tecken: 1, 2, T, F eller *. Med den här uppslagstypen kan användare finjustera en specifik geometrisk relation som överensstämmer med DE-9IM-modellen. [1]

\n

Geometri exempel:

\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 och MariaDB SQL motsvarande:

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

SpatiaLite SQL-ekvivalent:

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

Rasterexempel:

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

\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

Här består relationsmönstret av minst en av de nio relationssträngarna: TOUCH, OVERLAPBDYDISJOINT, OVERLAPBDYINTERSECT, EQUAL, INSIDE, COVEREDBY, CONTAINS, COVERS, ON och ANYINTERACT. Flera strängar kan kombineras med den logiska booleska operatorn OR, till exempel 'inside+touch'. [2] Relationssträngarna är skiftlägesokänsliga.

\n

Exempel:

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

Oracle SQL motsvarande:

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

touchesLink to this heading#

\n

Tillgänglighet: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite

\n

Testar om geometrifältet rumsligt berör uppslagsgeometrin.

\n

Exempel:

\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

SQL-ekvivalent

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

inomLink to this heading#

\n

Tillgänglighet: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (Bilateral)

\n

Testar om geometrifältet är rumsligt inom lookup-geometrin.

\n

Exempel:

\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

SQL-ekvivalent

PostGIS

ST_Within(poly, geom)

MariaDB

ST_Within(poly, geom)

MySQL

ST_Within(poly, geom)

Oracle

SDO_INSIDE(poly, geom)

SpatiaLite

Inom(poly, geom)

\n
\n
\n
\n

vänsterLink to this heading#

\n

Tillgänglighet: PostGIS, PGRaster (Konvertering)

\n

Testar om geometrifältets avgränsningsbox ligger strikt till vänster om uppslagsgeometrins avgränsningsbox.

\n

Exempel:

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

PostGIS-ekvivalent:

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

högerLink to this heading#

\n

Tillgänglighet: PostGIS, PGRaster (Konvertering)

\n

Testar om geometrifältets avgränsningsbox ligger strikt till höger om uppslagsgeometrins avgränsningsbox.

\n

Exempel:

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

PostGIS-ekvivalent:

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

överlappar_vänsterLink to this heading#

\n

Tillgänglighet: PostGIS, PGRaster (Bilateral)

\n

Testar om geometrifältets avgränsningsbox överlappar eller är till vänster om uppslagsgeometrins avgränsningsbox.

\n

Exempel:

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

PostGIS-ekvivalent:

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

överlappar_högerLink to this heading#

\n

Tillgänglighet: PostGIS, PGRaster (Bilateral)

\n

Testar om geometrifältets avgränsningsbox överlappar eller är till höger om uppslagsgeometrins avgränsningsbox.

\n

Exempel:

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

PostGIS-ekvivalent:

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

överlappningar_överLink to this heading#

\n

Tillgänglighet: PostGIS, PGRaster (Konvertering)

\n

Testar om geometrifältets avgränsningsbox överlappar eller ligger ovanför uppslagsgeometrins avgränsningsbox.

\n

Exempel:

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

PostGIS-ekvivalent:

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

överlappningar_underLink to this heading#

\n

Tillgänglighet: PostGIS, PGRaster (Konvertering)

\n

Testar om geometrifältets avgränsningsbox överlappar eller ligger under uppslagsgeometrins avgränsningsbox.

\n

Exempel:

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

PostGIS-ekvivalent:

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

”strikt ovanLink to this heading#

\n

Tillgänglighet: PostGIS, PGRaster (Konvertering)

\n

Testar om geometrifältets begränsningsbox är strikt ovanför uppslagsgeometrins begränsningsbox.

\n

Exempel:

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

PostGIS-ekvivalent:

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

strikt_underLink to this heading#

\n

Tillgänglighet: PostGIS, PGRaster (Konvertering)

\n

Testar om geometrifältets avgränsningsbox är strikt under uppslagsgeometrins avgränsningsbox.

\n

Exempel:

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

PostGIS-ekvivalent:

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

Uppslagning av avståndLink to this heading#

\n

Tillgänglighet: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (inbyggd)

\n

För en översikt över hur du utför avståndsfrågor, se introduktion till avståndsfrågor.

\n

Distansuppslagningar har följande 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

Värdet som skickas till en avståndsuppslagning är en tupel; de två första värdena är obligatoriska och är geometrin att beräkna avstånd till och ett avståndsvärde (antingen ett tal i fältets enheter, ett Distance-objekt eller ett query expression). Om du vill skicka ett bandindex till uppslagningen använder du en 3-tupel där den andra posten är bandindexet.

\n

För varje avståndsuppslagning utom dwithin kan ett valfritt element, 'spheroid', inkluderas för att använda de mer exakta funktionerna för beräkning av sfäroidavstånd på fält med ett geodetiskt koordinatsystem.

\n

På PostgreSQL använder alternativet 'spheroid' ST_DistanceSpheroid istället för ST_DistanceSphere. Den enklare funktionen ST_Distance används med projicerade koordinatsystem. Rasters konverteras till geometrier för sfäroidbaserade uppslagningar.

\n
\n

avstånd_gtLink to this heading#

\n

Returnerar modeller där avståndet till geometrifältet från uppslagsgeometrin är större än det angivna avståndsvärdet.

\n

Exempel:

\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

SQL-ekvivalent

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

Distans(poly, geom) > 5

\n
\n
\n
\n

avstånd_gteLink to this heading#

\n

Returnerar modeller där avståndet till geometrifältet från uppslagsgeometrin är större än eller lika med det angivna avståndsvärdet.

\n

Exempel:

\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

SQL-ekvivalent

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

Distans(poly, geom) >= 5

\n
\n
\n
\n

avstånd_ltLink to this heading#

\n

Returnerar modeller där avståndet till geometrifältet från uppslagsgeometrin är mindre än det angivna avståndsvärdet.

\n

Exempel:

\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

SQL-ekvivalent

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

Distans(poly, geom) < 5

\n
\n
\n
\n

avstånd_lteLink to this heading#

\n

Returnerar modeller där avståndet till geometrifältet från uppslagsgeometrin är mindre än eller lika med det angivna avståndsvärdet.

\n

Exempel:

\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

SQL-ekvivalent

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

Distans(poly, geom) <= 5

\n
\n
\n
\n

inomLink to this heading#

\n

Returnerar modeller där avståndet till geometrifältet från uppslagsgeometrin ligger inom det angivna avståndet från varandra. Observera att du endast kan tillhandahålla Distance-objekt om de riktade geometrierna är i ett projicerat system. För geografiska geometrier bör du använda enheter i geometrifältet (t.ex. grader för WGS84) .

\n

Exempel:

\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

SQL-ekvivalent

PostGIS

ST_DWithin(poly, geom, 5)

Oracle

SDO_WITHIN_DISTANCE(poly, geom, 5)

SpatiaLite

PtDistWithin(poly, geom, 5)

\n
\n
\n
\n

Aggregerade funktionerLink to this heading#

\n

Django tillhandahåller några GIS-specifika aggregeringsfunktioner. För detaljer om hur du använder dessa aggregeringsfunktioner, se ämnesguiden om aggregering.

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

Sökord Argument

Beskrivning

”Tolerans

Detta nyckelord gäller endast Oracle. Det används för det toleransvärde som används av proceduren SDOAGGRTYPE; Oracle-dokumentationen innehåller mer information.

\n
\n

Exempel:

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

Samla inLink to this heading#

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

Tillgänglighet: PostGIS, MariaDB, MySQL, SpatiaLite

\n

Returnerar en GEOMETRYCOLLECTION eller ett MULTI geometriobjekt från geometrikolumnen. Detta är analogt med en förenklad version av aggregatet Union, förutom att det kan vara flera storleksordningar snabbare än att utföra en union eftersom det rullar upp geometrier till en samling eller ett multiobjekt, utan att bry sig om att lösa upp gränser.

\n\n
\n
\n

ExtentLink to this heading#

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

Tillgänglighet: PostGIS, Oracle, SpatiaLite

\n

Returnerar omfattningen av alla geo_field i QuerySet som en 4-tupel, bestående av den nedre vänstra koordinaten och den övre högra koordinaten.

\n

Exempel:

\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

Tillgänglighet: PostGIS

\n

Returnerar 3D-utbredningen av alla geo_field i QuerySet som en 6-tupel, bestående av den nedre vänstra koordinaten och den övre högra koordinaten (var och en med x-, y- och z-koordinater).

\n

Exempel:

\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

Tillgänglighet: PostGIS, SpatiaLite

\n

Returnerar en LineString som konstruerats från punktfältsgeometrierna i QuerySet. För närvarande har det ingen effekt att beställa frågeuppsättningen.

\n

Exempel:

\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

Tillgänglighet: PostGIS, Oracle, SpatiaLite

\n

Denna metod returnerar ett GEOSGeometry-objekt som består av en sammanslagning av alla geometrier i frågeuppsättningen. Observera att användningen av Union är processorkrävande och kan ta lång tid på stora frågeuppsättningar.

\n\n

Exempel:

\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

Fotnoter

\n\n
\n
\n
","rootId":"gis-queryset-api-reference","toc":[{"title":"Rumsliga uppslagningar","anchor":"spatial-lookups","children":[{"title":"Uppslagningar med raster","anchor":"lookups-with-rasters","children":[]},{"title":"bbcontains","anchor":"bbcontains","children":[]},{"title":"bboverlaps","anchor":"bboverlaps","children":[]},{"title":"innehållen","anchor":"contained","children":[]},{"title":"innehåller","anchor":"contains","children":[]},{"title":"innehåller_riktigt","anchor":"contains-properly","children":[]},{"title":"”täckt av","anchor":"coveredby","children":[]},{"title":"överdrag","anchor":"covers","children":[]},{"title":"korsningar","anchor":"crosses","children":[]},{"title":"disjunkt","anchor":"disjoint","children":[]},{"title":"likvärdiga","anchor":"equals","children":[]},{"title":"exact, same_as","anchor":"exact-same-as","children":[]},{"title":"skärningspunkter","anchor":"intersects","children":[]},{"title":"isempty","anchor":"isempty","children":[]},{"title":"isvalid","anchor":"isvalid","children":[]},{"title":"geom_typ","anchor":"geom-type","children":[]},{"title":"num_dimensions","anchor":"num-dimensions","children":[]},{"title":"överlappar","anchor":"overlaps","children":[]},{"title":"förhållande","anchor":"relate","children":[{"title":"MariaDB, PostGIS och SpatiaLite","anchor":"mariadb-postgis-and-spatialite","children":[]},{"title":"Oracle","anchor":"oracle","children":[]}]},{"title":"touches","anchor":"touches","children":[]},{"title":"inom","anchor":"within","children":[]},{"title":"vänster","anchor":"left","children":[]},{"title":"höger","anchor":"right","children":[]},{"title":"överlappar_vänster","anchor":"overlaps-left","children":[]},{"title":"överlappar_höger","anchor":"overlaps-right","children":[]},{"title":"överlappningar_över","anchor":"overlaps-above","children":[]},{"title":"överlappningar_under","anchor":"overlaps-below","children":[]},{"title":"”strikt ovan","anchor":"strictly-above","children":[]},{"title":"strikt_under","anchor":"strictly-below","children":[]}]},{"title":"Uppslagning av avstånd","anchor":"distance-lookups","children":[{"title":"avstånd_gt","anchor":"distance-gt","children":[]},{"title":"avstånd_gte","anchor":"distance-gte","children":[]},{"title":"avstånd_lt","anchor":"distance-lt","children":[]},{"title":"avstånd_lte","anchor":"distance-lte","children":[]},{"title":"inom","anchor":"dwithin","children":[]},{"title":"Aggregerade funktioner","anchor":"aggregate-functions","children":[{"title":"Samla in","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-referens","url":"/sv/6.1/ref/"},{"docname":"ref/contrib/index","title":"contrib paket","url":"/sv/6.1/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/sv/6.1/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/forms-api","title":"GeoDjango formulär API","url":"/sv/6.1/ref/contrib/gis/forms-api/"},"next":{"docname":"ref/contrib/gis/functions","title":"Geografiska databasfunktioner","url":"/sv/6.1/ref/contrib/gis/functions/"},"formats":{"html":"/sv/6.1/ref/contrib/gis/geoquerysets/","markdown":"/sv/6.1/ref/contrib/gis/geoquerysets.md","json":"/sv/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/sv/6.1/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"]}