{"title":"Feidhmeanna Bunachar Sonraí","version":"6.0","locale":"ga","docname":"ref/contrib/gis/functions","url":"/ga/6.0/ref/contrib/gis/functions/","canonical":"https://djangodocs.dev/ga/6.0/ref/contrib/gis/functions/","summary":"Ligeann na feidhmeanna doiciméadaithe ar an leathanach seo d'úsáideoirí rochtain a fháil ar fheidhmeanna bunachar sonraí geografacha le húsáid in anótaí,…","html":"

Feidhmeanna Bunachar SonraíLink to this heading#

\n

Ligeann na feidhmeanna doiciméadaithe ar an leathanach seo d'úsáideoirí rochtain a fháil ar fheidhmeanna bunachar sonraí geografacha le húsáid in anótaí, comhiomlánaithe nó scagairí i Django.

\n

Sampla:

\n
Python console
>>> from django.contrib.gis.db.models.functions import Length\n>>> Track.objects.annotate(length=Length("line")).filter(length__gt=100)\n
\n

Ní thacaíonn gach cúltaca le gach feidhm, mar sin déan tagairt do dhoiciméadú gach feidhme chun a fháil amach an dtacaíonn do chúlcheann bunachar sonraí leis an bhfeidhm is mian leat a úsáid. Má ghlaonn tú feidhm gheografach ar chúltaca nach dtacaíonn leis, gheobhaidh tú eisceacht NotImplementederror.

\n
\n

MeasurementsLink to this heading#

\n
\n

LimistéarLink to this heading#

\n
\n
\nclass Area(expression, **extra)Link to this definition#
\n
\n\n

Availability: MariaDB, MySQL,\nOracle, PostGIS, SpatiaLite

\n

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

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

\n
\n
\n

``Fad ``Link to this heading#

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

< 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

\n

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.

\n

< 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).

\n

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í).

\n

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:

\n
Python console
>>> from django.contrib.gis.db.models.functions import Distance\n>>> pnt = AustraliaCity.objects.get(name="Hobart").point\n>>> for city in AustraliaCity.objects.annotate(distance=Distance("point", pnt)):\n...     print(city.name, city.distance)\n...\nWollongong 990071.220408 m\nShellharbour 972804.613941 m\nThirroul 1002334.36351 m\n...\n
\n\n
\n
\n

Fad geoiméadraitheLink to this heading#

\n
\n
\nclass GeometryDistance(expr1, expr2, **extra)Link to this definition#
\n
\n\n

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

\n

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.

\n
\n
\n

``Fad ``Link to this heading#

\n
\n
\nclass Length(expression, spheroid=True, **extra)Link to this definition#
\n
\n\n

< 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

\n

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.

\n

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

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

\n
\n
\n

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

\n
\n
\nclass Perimeter(expression, **extra)Link to this definition#
\n
\n\n

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

\n

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.

\n
\n
\n
\n

CaidrimhLink to this heading#

\n
\n

AzimuthLink to this heading#

\n
\n
\nclass Azimuth(point_a, point_b, **extra)Link to this definition#
\n
\n\n

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

\n

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.

\n
\n
\n

Ciorcal teorannaitheachLink to this heading#

\n
\n
\nclass BoundingCircle(expression, num_seg=48, **extra)Link to this definition#
\n
\n\n

< 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+

\n

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

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

\n
\n
\n

CentroidLink to this heading#

\n
\n
\nclass Centroid(expression, **extra)Link to this definition#
\n
\n\n

< 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

\n

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

\n
\n
\n

ClosestpointLink to this heading#

\n
\n
\nclass ClosestPoint(expr1, expr2, **extra)Link to this definition#
\n
\n\n

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

\n

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

\n
\n
\n

`ImbléadLink to this heading#

\n
\n
\nclass Envelope(expression, **extra)Link to this definition#
\n
\n\n

< 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

\n

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.

\n
\n
\n

LinelocatepointLink to this heading#

\n
\n
\nclass LineLocatePoint(linestring, point, **extra)Link to this definition#
\n
\n\n

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

\n

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.

\n
\n
\n

PointonSurfaceLink to this heading#

\n
\n
\nclass PointOnSurface(expression, **extra)Link to this definition#
\n
\n\n

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

\n

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.

\n
\n
\n
\n

OibríochtaíLink to this heading#

\n
\n

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

\n
\n
\nclass Difference(expr1, expr2, **extra)Link to this definition#
\n
\n\n

< 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

\n

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

\n
\n
\n

``Idirdhearnadh ``Link to this heading#

\n
\n
\nclass Intersection(expr1, expr2, **extra)Link to this definition#
\n
\n\n

< 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

\n

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

\n
\n
\n

Difríocht chomhshaLink to this heading#

\n
\n
\nclass SymDifference(expr1, expr2, **extra)Link to this definition#
\n
\n\n

< 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

\n

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

\n
\n
\n

AontasLink to this heading#

\n
\n
\nclass Union(expr1, expr2, **extra)Link to this definition#
\n
\n\n

< 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

\n

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

\n
\n
\n
\n

EagarthóiríLink to this heading#

\n
\n

ForcePolygOncwLink to this heading#

\n
\n
\nclass ForcePolygonCW(expression, **extra)Link to this definition#
\n
\n\n

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

\n

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ú.

\n
\n
\n

MakevalidLink to this heading#

\n
\n
\nclass MakeValid(expr)Link to this definition#
\n
\n\n

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

\n

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.

\n
\n
\n

`Ag siomLink to this heading#

\n
\n
\nclass Reverse(expression, **extra)Link to this definition#
\n
\n\n

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

\n

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

\n
\n
\n

RotateLink to this heading#

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

Availability: PostGIS

\n

Rotates a geometry by a specified angle around the origin. Optionally, the\nrotation can be performed around a point, defined by the origin\nparameter.

\n
\n
\n

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

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

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

\n

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.

\n
\n
\n

``SnaptoGrid ``Link to this heading#

\n
\n
\nclass SnapToGrid(expression, *args, **extra)Link to this definition#
\n
\n\n

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

\n

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

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

Líon na n-Argóintí

Cur síos

1

Méid amháin chun na greille X agus Y a ghabháil leo.

2

Méideanna X agus Y chun an greille a ghabháil chuig.

4

Méideanna X, Y agus an bhunús X, Y comhfhreagrach.

\n
\n
\n
\n

TransformLink to this heading#

\n
\n
\nclass Transform(expression, srid, **extra)Link to this definition#
\n
\n\n

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

\n

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`.

\n\n
\n
\n

AistriúchLink to this heading#

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

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

\n

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.

\n
\n
\n
\n

Formáid ionchuirLink to this heading#

\n
\n

FromWKBLink to this heading#

\n
\n
\nclass FromWKB(expression, srid=0, **extra)Link to this definition#
\n
\n\n

< 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

\n

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.

\n
\n
\n

FromWKTLink to this heading#

\n
\n
\nclass FromWKT(expression, srid=0, **extra)Link to this definition#
\n
\n\n

< 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

\n

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.

\n
\n
\n
\n

Formáid aschuirLink to this heading#

\n
\n

AsgeojsonLink to this heading#

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

< 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

\n

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.

\n

Sampla:

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

Argóint Eochairfho

Cur síos

bbox

Socraigh é seo go True más mian leat go gcuirfí an bosca teorainneacha san áireamh sa GeoJSON ar ais. Neamhaird a dhéanamh ar Oracle.

crs

Socraigh é seo go True más mian leat go gcuirfí an córas tagartha comhordaithe san áireamh sa GeoJSON ar ais. Neamhaird a dhéanamh ar MySQL agus Oracle.

`cruinne

Is féidir é a úsáid chun líon na ndigití suntasacha a shonrú do na comhordanáidí san ionadaíocht GeoJSON - is é 8 an luach réamhshocraithe. Neamhaird a dhéanamh ar Oracle.

\n
\n
\n
\n

ASGMLLink to this heading#

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

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

\n

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.

\n

Sampla:

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

Argóint Eochairfho

Cur síos

`cruinne

Sonraíonn sé líon na ndigití suntasacha do na comhordanáidí san ionadaíocht GML - is é 8 an luach réamhshocraithe. Neamhaird a dhéanamh ar Oracle.

leagan

Sonraíonn sé an leagan GML le húsáid: 2 (réamhshocraithe) nó 3.

\n
\n
\n
\n

AskmlLink to this heading#

\n
\n
\nclass AsKML(expression, precision=8, **extra)Link to this definition#
\n
\n\n

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

\n

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.

\n

Sampla:

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

Argóint Eochairfho

Cur síos

`cruinne

Is féidir an eochairfhocal seo a úsáid chun líon na ndigití suntasacha do na comhordanáidí san ionadaíocht KML a shonrú - is é 8 an luach réamhshocraithe.

\n
\n
\n
\n

AssvgLink to this heading#

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

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

\n

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.

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

Argóint Eochairfho

Cur síos

``gaolmhar ``

Má tá sé socraithe go “True”, cuirfear na sonraí cosáin i bhfeidhm i dtéarmaí gluaiseachtaí coibhneasta. Réamhshocraithe go False, rud a chiallaíonn go n-úsáidtear gluaiseachtaí iomlána ina ionad.

`cruinne

Is féidir an eochairfhocal seo a úsáid chun líon na ndigití suntasacha do na comhordanáidí san ionadaíocht SVG a shonrú - is é 8 an luach réamhshocraithe.

\n
\n
\n
\n

ASWKBLink to this heading#

\n
\n
\nclass AsWKB(expression, **extra)Link to this definition#
\n
\n\n

< 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

\n

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.

\n

Sampla:

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

ASWKTLink to this heading#

\n
\n
\nclass AsWKT(expression, **extra)Link to this definition#
\n
\n\n

< 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

\n

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.

\n

Sampla:

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

GeohashLink to this heading#

\n
\n
\nclass GeoHash(expression, precision=None, **extra)Link to this definition#
\n
\n\n

Availability: MariaDB, MySQL,\nPostGIS, SpatiaLite\n(LWGEOM/RTTOPO)

\n

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

\n

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

\n\n
\n
\n
\n

IlghnéitheachLink to this heading#

\n
\n

IsemptyLink to this heading#

\n
\n
\nclass IsEmpty(expr)Link to this definition#
\n
\n\n

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

\n

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.

\n
\n
\n

IsvalidLink to this heading#

\n
\n
\nclass IsValid(expr)Link to this definition#
\n
\n\n

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

\n

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.

\n\n
\n
\n

GeometryTypeLink to this heading#

\n\n
\n
\nclass GeometryType(expr)Link to this definition#
\n
\n\n

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

\n

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

\n
\n
\n

``Memsize ``Link to this heading#

\n
\n
\nclass MemSize(expression, **extra)Link to this definition#
\n
\n\n

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

\n

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.

\n
\n
\n

Uimhreacha GeometraiLink to this heading#

\n
\n
\nclass NumGeometries(expression, **extra)Link to this definition#
\n
\n\n

< 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

\n

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.

\n

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

\n
\n
\n

NumpointsLink to this heading#

\n
\n
\nclass NumPoints(expression, **extra)Link to this definition#
\n
\n\n

< 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

\n

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

\n

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

\n
\n
","rootId":"module-django.contrib.gis.db.models.functions","toc":[{"title":"Measurements","anchor":"measurements","children":[{"title":"Limistéar","anchor":"area","children":[]},{"title":"``Fad ``","anchor":"distance","children":[]},{"title":"Fad geoiméadraithe","anchor":"geometrydistance","children":[]},{"title":"``Fad ``","anchor":"length","children":[]},{"title":"``Periméadar ``","anchor":"perimeter","children":[]}]},{"title":"Caidrimh","anchor":"relationships","children":[{"title":"Azimuth","anchor":"azimuth","children":[]},{"title":"Ciorcal teorannaitheach","anchor":"boundingcircle","children":[]},{"title":"Centroid","anchor":"centroid","children":[]},{"title":"Closestpoint","anchor":"closestpoint","children":[]},{"title":"`Imbléad","anchor":"envelope","children":[]},{"title":"Linelocatepoint","anchor":"linelocatepoint","children":[]},{"title":"PointonSurface","anchor":"pointonsurface","children":[]}]},{"title":"Oibríochtaí","anchor":"operations","children":[{"title":"``Difríocht ``","anchor":"difference","children":[]},{"title":"``Idirdhearnadh ``","anchor":"intersection","children":[]},{"title":"Difríocht chomhsha","anchor":"symdifference","children":[]},{"title":"Aontas","anchor":"union","children":[]}]},{"title":"Eagarthóirí","anchor":"editors","children":[{"title":"ForcePolygOncw","anchor":"forcepolygoncw","children":[]},{"title":"Makevalid","anchor":"makevalid","children":[]},{"title":"`Ag siom","anchor":"reverse","children":[]},{"title":"Rotate","anchor":"rotate","children":[]},{"title":"``Scála ``","anchor":"scale","children":[]},{"title":"``SnaptoGrid ``","anchor":"snaptogrid","children":[]},{"title":"Transform","anchor":"transform","children":[]},{"title":"Aistriúch","anchor":"translate","children":[]}]},{"title":"Formáid ionchuir","anchor":"input-format","children":[{"title":"FromWKB","anchor":"fromwkb","children":[]},{"title":"FromWKT","anchor":"fromwkt","children":[]}]},{"title":"Formáid aschuir","anchor":"output-format","children":[{"title":"Asgeojson","anchor":"asgeojson","children":[]},{"title":"ASGML","anchor":"asgml","children":[]},{"title":"Askml","anchor":"askml","children":[]},{"title":"Assvg","anchor":"assvg","children":[]},{"title":"ASWKB","anchor":"aswkb","children":[]},{"title":"ASWKT","anchor":"aswkt","children":[]},{"title":"Geohash","anchor":"geohash","children":[]}]},{"title":"Ilghnéitheach","anchor":"miscellaneous","children":[{"title":"Isempty","anchor":"isempty","children":[]},{"title":"Isvalid","anchor":"isvalid","children":[]},{"title":"GeometryType","anchor":"geometrytype","children":[]},{"title":"``Memsize ``","anchor":"memsize","children":[]},{"title":"Uimhreacha Geometrai","anchor":"numgeometries","children":[]},{"title":"Numpoints","anchor":"numpoints","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/6.0/ref/"},{"docname":"ref/contrib/index","title":"Pacáistí contrib","url":"/ga/6.0/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeodJango","url":"/ga/6.0/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/geoquerysets","title":"Tagairt API GIS QuerySet","url":"/ga/6.0/ref/contrib/gis/geoquerysets/"},"next":{"docname":"ref/contrib/gis/measure","title":"Rudaí Tomhais","url":"/ga/6.0/ref/contrib/gis/measure/"},"formats":{"html":"/ga/6.0/ref/contrib/gis/functions/","markdown":"/ga/6.0/ref/contrib/gis/functions.md","json":"/ga/6.0/ref/contrib/gis/functions.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/ref/contrib/gis/functions.txt","official":"https://docs.djangoproject.com/ga/6.0/ref/contrib/gis/functions/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}