Feidhmeanna Bunachar SonraíLink to this heading#

LimistéarLink to this heading#

class Area(expression, **extra)Link to this definition#

Availability: MariaDB, MySQL, Oracle, PostGIS, SpatiaLite

Glacann sé le réimse nó léiriú geografach amháin agus cuireann sé limistéar an réimse ar ais mar bheart: ~django.contrib.gis.Measure.Area.

Ní thacaíonn MySQL agus SpatialITE gan LWGEOM/RTTOPO le ríomhanna limistéar ar SRSEanna geografacha.

``Fad ``Link to this heading#

class Distance(expr1, expr2, spheroid=None, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/spatial-relation-functions-object-shapes.html#function_st-distance> < https://postgis.net/docs/ST_Distance.html>* Infhaighteacht*: MariaDB, `MySQL`__, `PostGIS`__, Oracle, Spatialite

Glacann sé le dhá réimse nó abairt gheografach agus filleann sé an fad eatarthu, mar a:class: ~django.contrib.gis.Measure.distance réad. Ar MySQL, cuirtear luach snámh amh ar ais nuair a bhíonn na comhordanáidí geodeiteach.

< https://postgis.net/docs/ST_DistanceSphere.html>Ar chúltaca a thacaíonn le ríomh achair ar chomhordanáidí geodéiseacha, roghnaítear an fheidhm cúltaca ceart go huathoibríoch ag brath ar luach SRID na ngeoiméadraí (m.sh. `ST_distanceSPHERE`__ ar PostGIS).

Nuair a ríomhtar achair le comhordanáidí geodéiseacha (uilleacha), mar atá leis an réamhshocraithe WGS84 (4326) SRID, is féidir leat an argóint eochairfhocal spheroid a shocrú chun cinneadh a dhéanamh an chóir an ríomh a bheith bunaithe ar réimse simplí (níos cruinne, níos dian-acmhainní) nó ar spheroid (níos cruinne, níos déine acmhainní).

Sa sampla seo a leanas, ríomhtar an fad ó chathair Hobart go gach ceann eile: ~django.contrib.gis.db.models.pointfield sa tacar ceisteanna Austráliacity:

>>> from django.contrib.gis.db.models.functions import Distance
>>> pnt = AustraliaCity.objects.get(name="Hobart").point
>>> for city in AustraliaCity.objects.annotate(distance=Distance("point", pnt)):
...     print(city.name, city.distance)
...
Wollongong 990071.220408 m
Shellharbour 972804.613941 m
Thirroul 1002334.36351 m
...

Fad geoiméadraitheLink to this heading#

class GeometryDistance(expr1, expr2, **extra)Link to this definition#

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

Glacann sé le dhá réimse nó abairt gheografach agus filleann sé an fad eatarthu. Nuair a úsáidtear é i gclásal an:meth: ~django.db.models.query.queryset.order_by, soláthraíonn sé tacair torthaí is gaire don chomharsa le cúnamh innéacs.

``Fad ``Link to this heading#

class Length(expression, spheroid=True, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/gis-linestring-property-functions.html#function_st-length> < https://postgis.net/docs/ST_Length.html>*Infhaighteacht*: MariaDB, `MySQL`__, Oracle, `PostGIS`__, Spatialite

Glacann sé le réimse nó léiriú líne geografach amháin nó illíne agus filleann sé a fhad mar a: aicme: ~django.contrib.gis.measur.distance beart.

Ar PostGIS agus Spatialite, nuair a bhíonn na comhordanáidí geodeiteach (uilleach), is féidir leat a shonrú an chóir go mbeadh an ríomh bunaithe ar réimse simplí (chomh cruinn, chomh dian ar acmhainní) nó ar spheroid (níos cruinne, níos déine acmhainní) leis an argóint eochairfhocal spheroid.

Ní thacaíonn MySQL le ríomhanna fad ar SRSEanna geografacha.

``Periméadar ``Link to this heading#

class Perimeter(expression, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach amháin agus cuireann sé imlíne an réimse geoimnéadais ar ais mar a:class: ~django.contrib.gis.Measure.distance réad.

AzimuthLink to this heading#

class Azimuth(point_a, point_b, **extra)Link to this definition#

< https://postgis.net/docs/ST_Azimuth.html>* Infhaighteacht*: `PostGIS`__, Spatialite (LWGEOM/RTTOPO)

Filleann sé an azimuth i radáin den deighleog atá sainmhínithe ag na geoiméadrachtaí pointe ar leith, nó None ``má tá an dá phointe ag teacht le chéile. Is uillinn é an azimuth a dtagraítear ó thuaidh agus tá sé dearfach deaclaíoch: thuaidh = ``0; thoir = π/2`; theas = π; thiar = 3π/2.

Ciorcal teorannaitheachLink to this heading#

class BoundingCircle(expression, num_seg=48, **extra)Link to this definition#

< https://postgis.net/docs/ST_MinimumBoundingCircle.html> < https://docs.oracle.com/en/database/oracle/oracle-database/21/spatl/ SDO_GEOM-reference.html #GUID -82A61626-BB64-4793-B53D-A0DBEC91831A>*Infhaighteacht*: `PostGis`__, Oracle, Spatialite 5.1+

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé an polagún ciorcal is lú ar féidir leis an geoiméadacht a bheith ina iomlán.

Ní úsáidtear an paraiméadar num_seg ach ar PostGIS.

CentroidLink to this heading#

class Centroid(expression, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/gis-polygon-property-functions.html#function_st-centroid> < https://postgis.net/docs/ST_Centroid.html>* Infhaighteacht*: MariaDB, `MySQL`__, `PostGIS`__, Oracle, Spatialite

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé luach centroid an ghéiméadrachta.

ClosestpointLink to this heading#

class ClosestPoint(expr1, expr2, **extra)Link to this definition#

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

Glacann sé le dhá réimse nó abairt gheografacha agus filleann sé an pointe déthoiseach ar ghéimseadra A atá is gaire do ghéimse

`ImbléadLink to this heading#

class Envelope(expression, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/gis-general-property-functions.html#function_st-envelope> < https://docs.oracle.com/en/database/oracle/oracle-database/21/spatl/ spatial-operators-reference.html #GUID -ACED800F-3435-44AA-9606-D40934A23ED0> < https://postgis.net/docs/ST_Envelope.html>*Infhaighteacht*: MariaDB, `MySQL`__, `Oracle`__, `PostGis`__, Spatialite

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé an geoiméadra a léiríonn bosca teorainneacha an geoiméadair.

LinelocatepointLink to this heading#

class LineLocatePoint(linestring, point, **extra)Link to this definition#

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

Tugann sé snámhphointe idir 0 agus 1 a léiríonn suíomh an phointe is gaire ar linestring` don point` a thugtar, mar chodán den fad líne 2D.

PointonSurfaceLink to this heading#

class PointOnSurface(expression, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé geoiméadacht Point ráthaithe go luíonn sé ar dhromchla an réimse; ar shlí eile filleann sé None.

``Difríocht ``Link to this heading#

class Difference(expr1, expr2, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function_st-difference> < https://postgis.net/docs/ST_Difference.html>* Infhaighteacht*: MariaDB, `MySQL`__, `PostGIS`__, Oracle, Spatialite

Glacann sé le dhá réimse nó abairt gheografacha agus filleann sé an difríocht geoiméadrach ar ais, is é sin an chuid de ghéimseata A nach ndéanann trasnán le céimse

``Idirdhearnadh ``Link to this heading#

class Intersection(expr1, expr2, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function_st-intersection> < https://postgis.net/docs/ST_Intersection.html>* Infhaighteacht*: MariaDB, `MySQL`__, `PostGIS`__, Oracle, Spatialite

Glacann sé le dhá réimse nó abairt gheografach agus cuireann sé an trasna geoiméadrach eatarthu

Difríocht chomhshaLink to this heading#

class SymDifference(expr1, expr2, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function_st-symdifference> < https://postgis.net/docs/ST_SymDifference.html>* Infhaighteacht*: MariaDB, `MySQL`__, `PostGIS`__, Oracle, Spatialite

Glacann sé le dhá réimse nó abairt gheografacha agus filleann sé an difríocht shioméadrach geoiméadrach (aontas gan an trasna) idir na paraiméadair

AontasLink to this heading#

class Union(expr1, expr2, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function_st-union> < https://postgis.net/docs/ST_Union.html>* Infhaighteacht*: MariaDB, `MySQL`__, `PostGIS`__, Oracle, Spatialite

Glacann sé le dhá réimse nó abairt gheografach agus cuireann sé aontas an dá ghéiméadair ar ais.

ForcePolygOncwLink to this heading#

class ForcePolygonCW(expression, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé leagan modhnaithe den pholagón/ilpholygón ina bhfuil na fáinní seachtracha go léir dírithe ar an gcéal agus go bhfuil gach fáinní istigh dírithe i gcoinne. Cuirtear geoiméadraí neamholgánacha ar ais gan athrú.

MakevalidLink to this heading#

class MakeValid(expr)Link to this definition#

< https://postgis.net/docs/ST_MakeValid.html>* Infhaighteacht*: `PostGIS`__, Spatialite (LWGEOM/RTTOPO)

Glacann sé le réimse nó léiriú geografach agus déanann sé iarracht an luach a thiontú ina geoiméadracht bailí gan aon cheann de na beartacha ionchuir a chail Cuirtear geoiméadraí atá bailí cheana féin ar ais gan athruithe. D'fhéadfadh go mbeadh polagóin shimplí ina ilpholygón agus d'fhéadfadh gné níos ísle a bheith ar an toradh ná an t-ionchur.

`Ag siomLink to this heading#

class Reverse(expression, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé céimseata le comhordanáidí aisiom

RotateLink to this heading#

class Rotate(expression, angle, origin=None, **extra)Link to this definition#

Availability: PostGIS

Rotates a geometry by a specified angle around the origin. Optionally, the rotation can be performed around a point, defined by the origin parameter.

``Scála ``Link to this heading#

class Scale(expression, x, y, z=0.0, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé céiméadra le comhordanáidí scáilte tríd iad a iolrú leis na paraiméadair x, y`, agus `z ``roghnach.

``SnaptoGrid ``Link to this heading#

class SnapToGrid(expression, *args, **extra)Link to this definition#

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

Accepts a single geographic field or expression and returns a geometry with all points snapped to the given grid. How the geometry is snapped to the grid depends on how many numeric (either float, integer, or long) arguments are given.

TransformLink to this heading#

class Transform(expression, srid, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach agus cód sláimhir SRID, agus filleann sé an geoiméadra claochlaithe ar ais chuig an gcóras tagartha spásúil a shonraítear leis an bparaiméadar ``srid`.

AistriúchLink to this heading#

class Translate(expression, x, y, z=0.0, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé céiméadracht lena chomhordanáidí a fhritháireamh leis na paraiméadair uimhriúla x, y`, agus `z ``roghnach.

FromWKBLink to this heading#

class FromWKB(expression, srid=0, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/gis-wkb-functions.html#function_st-geomfromwkb> < https://postgis.net/docs/ST_GeomFromWKB.html>*Infhaighteacht*: MariaDB, `MySQL`__, Oracle, `PostGIS`__, Spatialite

Cruthaíonn sé geoiméadracht ó ionadaíocht dénártha aitheanta (WKB) `_. Ligeann an argóint roghnach ``srid` SRID an geoiméadracht mar thoradh air a shonrú. Déantar neamhaird ar srid ar Oracle.

FromWKTLink to this heading#

class FromWKT(expression, srid=0, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/gis-wkt-functions.html#function_st-geomfromtext> < https://postgis.net/docs/ST_GeomFromText.html>*Infhaighteacht*: MariaDB, `MySQL`__, Oracle, `PostGIS`__, Spatialite

Cruthaíonn sé geoiméadracht ó ionadaíocht téacs aitheanta (WKT) `_. Ligeann an argóint roghnach ``srid` SRID an geoiméadracht mar thoradh air a shonrú. Déantar neamhaird ar srid ar Oracle.

AsgeojsonLink to this heading#

class AsGeoJSON(expression, bbox=False, crs=False, precision=8, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/spatial-geojson-functions.html#function_st-asgeojson> < https://postgis.net/docs/ST_AsGeoJSON.html>*Infhaighteacht*: MariaDB, `MySQL`__, Oracle, `PostGIS`__, Spatialite

Glacann sé le réimse nó léiriú geografach amháin agus cuireann sé léiriú GeoJson ar an geoiméadracht < https://geojson.org/> ar ais. Tabhair faoi deara nach struchtúr iomlán GeoJSON é an toradh ach ach príomhábhar “geoiméadracht” de struchtúr GeoJSON amháin. Féach freis:doc: /ref/contrib/gis/serializers.

Sampla:

>>> City.objects.annotate(json=AsGeoJSON("point")).get(name="Chicago").json
{"type":"Point","coordinates":[-87.65018,41.85039]}

ASGMLLink to this heading#

class AsGML(expression, version=2, precision=8, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé léiriú `Teanga Marcála Geografach (GML) `__ ar an geoiméadracht.

Sampla:

>>> qs = Zipcode.objects.annotate(gml=AsGML("poly"))
>>> print(qs[0].gml)
<gml:Polygon srsName="EPSG:4326"><gml:OuterBoundaryIs>-147.78711,70.245363 ...
-147.78711,70.245363</gml:OuterBoundaryIs></gml:Polygon>

AskmlLink to this heading#

class AsKML(expression, precision=8, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé léiriú `Teanga Marcála Eochairpholl (KML) `__ ar an geoiméadracht.

Sampla:

>>> qs = Zipcode.objects.annotate(kml=AsKML("poly"))
>>> print(qs[0].kml)
<Polygon><outerBoundaryIs><LinearRing><coordinates>-103.04135,36.217596,0 ...
-103.04135,36.217596,0</coordinates></LinearRing></outerBoundaryIs></Polygon>

AssvgLink to this heading#

class AsSVG(expression, relative=False, precision=8, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé léiriú `Grafaicí Vector Inscálaithe (SVG) `__ ar an geoiméadracht.

ASWKBLink to this heading#

class AsWKB(expression, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/gis-format-conversion-functions.html#function_st-asbinary> < https://postgis.net/docs/ST_AsBinary.html>*Infhaighteacht*: MariaDB, `MySQL`__, Oracle, `PostGIS`__, Spatialite

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé léiriú `dénártha aitheanta (WKB) `_ ar an geoiméadracht.

Sampla:

>>> bytes(City.objects.annotate(wkb=AsWKB("point")).get(name="Chelyabinsk").wkb)
b'\x01\x01\x00\x00\x00]3\xf9f\x9b\x91K@\x00X\x1d9\xd2\xb9N@'

ASWKTLink to this heading#

class AsWKT(expression, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/gis-format-conversion-functions.html#function_st-astext> < https://postgis.net/docs/ST_AsText.html>*Infhaighteacht*: MariaDB, `MySQL`__, Oracle, `PostGIS`__, Spatialite

Glacann sé le réimse nó léiriú geografach amháin agus cuireann sé léiriú `téacs aitheanta (WKT) `_ ar an geoiméadracht ar ais.

Sampla:

>>> City.objects.annotate(wkt=AsWKT("point")).get(name="Chelyabinsk").wkt
'POINT (55.137555 61.451728)'

GeohashLink to this heading#

class GeoHash(expression, precision=None, **extra)Link to this definition#

Availability: MariaDB, MySQL, PostGIS, SpatiaLite (LWGEOM/RTTOPO)

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé léiriú `Geohash`__ ar an geoiméadracht.

Rialaíonn an argóint eochairfhocal cruinne líon na gcarachtar sa toradh.

IsemptyLink to this heading#

class IsEmpty(expr)Link to this definition#

Availability: PostGIS, SpatiaLite

Glacann sé le réimse nó léiriú geografach agus déanann sé tástáil más geoiméadra folamh é an luach. Tugann sé ar ais True má tá a luach folamh agus False ar shlí eile.

IsvalidLink to this heading#

class IsValid(expr)Link to this definition#

Availability: MariaDB, MySQL, PostGIS, Oracle, SpatiaLite

Glacann sé le réimse nó léiriú geografach agus déanann sé tástáil má tá an luach cruthaithe go maith. Tugann sé ar ais True más geoiméadracht bailí é a luach agus False a shlí eile.

GeometryTypeLink to this heading#

class GeometryType(expr)Link to this definition#

Availability: PostGIS, Oracle 23c+, MariaDB, MySQL, SpatiaLite

Accepts a geographic field or expression and returns its geometry type.

``Memsize ``Link to this heading#

class MemSize(expression, **extra)Link to this definition#

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

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé an méid cuimhne (líon na mbetaí) a thógann an réimse geoiméadrach.

NumDimensionsLink to this heading#

class NumDimensions(expression, **extra)Link to this definition#

Availability: PostGIS, SpatiaLite

Accepts a single geometry field or expression and returns the number of dimensions used by the geometry.

Uimhreacha GeometraiLink to this heading#

class NumGeometries(expression, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/gis-geometrycollection-property-functions.html#function_st-numgeometries> < https://postgis.net/docs/ST_NumGeometries.html>* Infhaighteacht*: MariaDB, `MySQL`__, `PostGIS`__, Oracle, Spatialite

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé líon na ngeoiméadraí más bailiúchán é an réimse geoiméadrach (m.sh., réimse GEOMETRYCOLLECTION nó MULTI*). Tuairisceáin 1 le haghaidh geoiméadraí aonair.

Ar MySQL, filleann ``None ``le haghaidh geoiméadraí aonair.

NumpointsLink to this heading#

class NumPoints(expression, **extra)Link to this definition#

< https://dev.mysql.com/doc/refman/en/gis-linestring-property-functions.html#function_st-numpoints> < https://postgis.net/docs/ST_NPoints.html>* Infhaighteacht*: MariaDB, `MySQL`__, `PostGIS`__, Oracle, Spatialite

Glacann sé le réimse nó léiriú geografach amháin agus filleann sé líon na bpointí i gcéiméadra ar ais.

Ar MySQL, filleann None d'aon ghéimseadracht neamh-LíneString`.