--- title: "Feidhmeanna Bunachar Sonraí" version: 6.0 locale: ga source: https://docs.djangoproject.com/ga/6.0/ref/contrib/gis/functions/ canonical: https://djangodocs.dev/ga/6.0/ref/contrib/gis/functions/ --- # Feidhmeanna Bunachar Sonraí 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. Sampla: ```pycon >>> from django.contrib.gis.db.models.functions import Length >>> Track.objects.annotate(length=Length("line")).filter(length__gt=100) ``` 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. ## Measurements ### `Limistéar` #### `class Area(expression, **extra)` *Availability*: MariaDB, [MySQL](https://dev.mysql.com/doc/refman/en/gis-polygon-property-functions.html#function_st-area), Oracle, [PostGIS](https://postgis.net/docs/ST_Area.html), 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 \`\` #### `class Distance(expr1, expr2, spheroid=None, **extra)` \< [https://dev.mysql.com/doc/refman/en/spatial-relation-functions-object-shapes.html#function\_st-distance](https://dev.mysql.com/doc/refman/en/spatial-relation-functions-object-shapes.html#function_st-distance)\> \< [https://postgis.net/docs/ST\_Distance.html](https://postgis.net/docs/ST_Distance.html)\>\* Infhaighteacht\*: MariaDB, , , 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](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. 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`: ```pycon >>> 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 ... ``` > **Note** > > Because the `distance` attribute is a > [`Distance`](/ga/6.0/ref/contrib/gis/measure/#django.contrib.gis.measure.Distance) object, you can easily > express the value in the units of your choice. For example, > `city.distance.mi` is the distance value in miles and > `city.distance.km` is the distance value in kilometers. See > [Rudaí Tomhais](/ga/6.0/ref/contrib/gis/measure/) for usage details and the list of > [Aonaid tacaithe](/ga/6.0/ref/contrib/gis/measure/#supported-units). ### `Fad geoiméadraithe` #### `class GeometryDistance(expr1, expr2, **extra)` \< [https://postgis.net/docs/geometry\_distance\_knn.html](https://postgis.net/docs/geometry_distance_knn.html)\>\*Infhaighteacht\*: 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 \`\` #### `class Length(expression, spheroid=True, **extra)` \< [https://dev.mysql.com/doc/refman/en/gis-linestring-property-functions.html#function\_st-length](https://dev.mysql.com/doc/refman/en/gis-linestring-property-functions.html#function_st-length)\> \< [https://postgis.net/docs/ST\_Length.html](https://postgis.net/docs/ST_Length.html)\>\*Infhaighteacht\*: MariaDB, , Oracle, , 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 \`\` #### `class Perimeter(expression, **extra)` \< [https://postgis.net/docs/ST\_Perimeter.html](https://postgis.net/docs/ST_Perimeter.html)\>\*Infhaighteacht\*: , 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. ## Caidrimh ### `Azimuth` #### `class Azimuth(point_a, point_b, **extra)` \< [https://postgis.net/docs/ST\_Azimuth.html](https://postgis.net/docs/ST_Azimuth.html)\>\* Infhaighteacht\*: , 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 teorannaitheach` #### `class BoundingCircle(expression, num_seg=48, **extra)` \< [https://postgis.net/docs/ST\_MinimumBoundingCircle.html](https://postgis.net/docs/ST_MinimumBoundingCircle.html)\> \< SDO\_GEOM-reference.html #GUID -82A61626-BB64-4793-B53D-A0DBEC91831A\>\*Infhaighteacht\*: , [Oracle](#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. ### `Centroid` #### `class Centroid(expression, **extra)` \< [https://dev.mysql.com/doc/refman/en/gis-polygon-property-functions.html#function\_st-centroid](https://dev.mysql.com/doc/refman/en/gis-polygon-property-functions.html#function_st-centroid)\> \< [https://postgis.net/docs/ST\_Centroid.html](https://postgis.net/docs/ST_Centroid.html)\>\* Infhaighteacht\*: MariaDB, , , Oracle, Spatialite Glacann sé le réimse nó léiriú geografach amháin agus filleann sé luach `centroid` an ghéiméadrachta. ### `Closestpoint` #### `class ClosestPoint(expr1, expr2, **extra)` \< [https://postgis.net/docs/ST\_ClosestPoint.html](https://postgis.net/docs/ST_ClosestPoint.html)\>\*Infhaighteacht\*: , 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éad `` #### `class Envelope(expression, **extra)` \< [https://dev.mysql.com/doc/refman/en/gis-general-property-functions.html#function\_st-envelope](https://dev.mysql.com/doc/refman/en/gis-general-property-functions.html#function_st-envelope)\> \< spatial-operators-reference.html #GUID -ACED800F-3435-44AA-9606-D40934A23ED0\> \< [https://postgis.net/docs/ST\_Envelope.html](https://postgis.net/docs/ST_Envelope.html)\>\*Infhaighteacht\*: MariaDB, , , , 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. ### `Linelocatepoint` #### `class LineLocatePoint(linestring, point, **extra)` \< [https://postgis.net/docs/ST\_LineLocatePoint.html](https://postgis.net/docs/ST_LineLocatePoint.html)\>\*Infhaighteacht\*: , 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. ### `PointonSurface` #### `class PointOnSurface(expression, **extra)` \< [https://postgis.net/docs/ST\_PointOnSurface.html](https://postgis.net/docs/ST_PointOnSurface.html)\>\*Infhaighteacht\*: , 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`. ## Oibríochtaí ### Difríocht \`\` #### `class Difference(expr1, expr2, **extra)` \< [https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function\_st-difference](https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function_st-difference)\> \< [https://postgis.net/docs/ST\_Difference.html](https://postgis.net/docs/ST_Difference.html)\>\* Infhaighteacht\*: MariaDB, , , 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 \`\` #### `class Intersection(expr1, expr2, **extra)` \< [https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function\_st-intersection](https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function_st-intersection)\> \< [https://postgis.net/docs/ST\_Intersection.html](https://postgis.net/docs/ST_Intersection.html)\>\* Infhaighteacht\*: MariaDB, , , Oracle, Spatialite Glacann sé le dhá réimse nó abairt gheografach agus cuireann sé an trasna geoiméadrach eatarthu ### `Difríocht chomhsha` #### `class SymDifference(expr1, expr2, **extra)` \< [https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function\_st-symdifference](https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function_st-symdifference)\> \< [https://postgis.net/docs/ST\_SymDifference.html](https://postgis.net/docs/ST_SymDifference.html)\>\* Infhaighteacht\*: MariaDB, , , 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 ### `Aontas` #### `class Union(expr1, expr2, **extra)` \< [https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function\_st-union](https://dev.mysql.com/doc/refman/en/spatial-operator-functions.html#function_st-union)\> \< [https://postgis.net/docs/ST\_Union.html](https://postgis.net/docs/ST_Union.html)\>\* Infhaighteacht\*: MariaDB, , , Oracle, Spatialite Glacann sé le dhá réimse nó abairt gheografach agus cuireann sé aontas an dá ghéiméadair ar ais. ## Eagarthóirí ### `ForcePolygOncw` #### `class ForcePolygonCW(expression, **extra)` \< [https://postgis.net/docs/ST\_ForcePolygonCW.html](https://postgis.net/docs/ST_ForcePolygonCW.html)\>\*Infhaighteacht\*: , 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ú. ### `Makevalid` #### `class MakeValid(expr)` \< [https://postgis.net/docs/ST\_MakeValid.html](https://postgis.net/docs/ST_MakeValid.html)\>\* Infhaighteacht\*: , 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 siom `` #### `class Reverse(expression, **extra)` \< [https://postgis.net/docs/ST\_Reverse.html](https://postgis.net/docs/ST_Reverse.html)\>\*Infhaighteacht\*: , Oracle, Spatialite Glacann sé le réimse nó léiriú geografach amháin agus filleann sé céimseata le comhordanáidí aisiom ### `Rotate` > **New in Django 6.0** #### `class Rotate(expression, angle, origin=None, **extra)` *Availability*: [PostGIS](https://postgis.net/docs/ST_Rotate.html) 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 \`\` #### `class Scale(expression, x, y, z=0.0, **extra)` \< [https://postgis.net/docs/ST\_Scale.html](https://postgis.net/docs/ST_Scale.html)\>\*Infhaighteacht\*: , 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 \`\` #### `class SnapToGrid(expression, *args, **extra)` \< [https://postgis.net/docs/ST\_SnapToGrid.html](https://postgis.net/docs/ST_SnapToGrid.html)\>\*Infhaighteacht\*: , 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. | 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. | ### `Transform` #### `class Transform(expression, srid, **extra)` \< [https://postgis.net/docs/ST\_Transform.html](https://postgis.net/docs/ST_Transform.html)\>\*Infhaighteacht\*: , 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\`. > **Note** > > What spatial reference system an integer SRID corresponds to may depend on > the spatial database used. In other words, the SRID numbers used for Oracle > are not necessarily the same as those used by PostGIS. ### `Aistriúch` #### `class Translate(expression, x, y, z=0.0, **extra)` \< [https://postgis.net/docs/ST\_Translate.html](https://postgis.net/docs/ST_Translate.html)\>\*Infhaighteacht\*: , 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. ## Formáid ionchuir ### `FromWKB` #### `class FromWKB(expression, srid=0, **extra)` \< [https://dev.mysql.com/doc/refman/en/gis-wkb-functions.html#function\_st-geomfromwkb](https://dev.mysql.com/doc/refman/en/gis-wkb-functions.html#function_st-geomfromwkb)\> \< [https://postgis.net/docs/ST\_GeomFromWKB.html](https://postgis.net/docs/ST_GeomFromWKB.html)\>\*Infhaighteacht\*: MariaDB, , Oracle, , 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. ### `FromWKT` #### `class FromWKT(expression, srid=0, **extra)` \< [https://dev.mysql.com/doc/refman/en/gis-wkt-functions.html#function\_st-geomfromtext](https://dev.mysql.com/doc/refman/en/gis-wkt-functions.html#function_st-geomfromtext)\> \< [https://postgis.net/docs/ST\_GeomFromText.html](https://postgis.net/docs/ST_GeomFromText.html)\>\*Infhaighteacht\*: MariaDB, , Oracle, , 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. ## Formáid aschuir ### `Asgeojson` #### `class AsGeoJSON(expression, bbox=False, crs=False, precision=8, **extra)` \< [https://dev.mysql.com/doc/refman/en/spatial-geojson-functions.html#function\_st-asgeojson](https://dev.mysql.com/doc/refman/en/spatial-geojson-functions.html#function_st-asgeojson)\> \< [https://postgis.net/docs/ST\_AsGeoJSON.html](https://postgis.net/docs/ST_AsGeoJSON.html)\>\*Infhaighteacht\*: MariaDB, , Oracle, , Spatialite Glacann sé le réimse nó léiriú geografach amháin agus cuireann sé léiriú [GeoJson](#geojson) ar an geoiméadracht \< \> 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: ```pycon >>> City.objects.annotate(json=AsGeoJSON("point")).get(name="Chicago").json {"type":"Point","coordinates":[-87.65018,41.85039]} ``` | 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. | ### `ASGML` #### `class AsGML(expression, version=2, precision=8, **extra)` \< [https://postgis.net/docs/ST\_AsGML.html](https://postgis.net/docs/ST_AsGML.html)\>\*Infhaighteacht\*: Oracle, , 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: ```pycon >>> qs = Zipcode.objects.annotate(gml=AsGML("poly")) >>> print(qs[0].gml) -147.78711,70.245363 ... -147.78711,70.245363 ``` | 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. | ### `Askml` #### `class AsKML(expression, precision=8, **extra)` \< [https://postgis.net/docs/ST\_AsKML.html](https://postgis.net/docs/ST_AsKML.html)\>\*Infhaighteacht\*: , 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: ```pycon >>> qs = Zipcode.objects.annotate(kml=AsKML("poly")) >>> print(qs[0].kml) -103.04135,36.217596,0 ... -103.04135,36.217596,0 ``` | 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. | ### `Assvg` #### `class AsSVG(expression, relative=False, precision=8, **extra)` \< [https://postgis.net/docs/ST\_AsSVG.html](https://postgis.net/docs/ST_AsSVG.html)\>\*Infhaighteacht\*: , 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. | 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. | ### `ASWKB` #### `class AsWKB(expression, **extra)` \< [https://dev.mysql.com/doc/refman/en/gis-format-conversion-functions.html#function\_st-asbinary](https://dev.mysql.com/doc/refman/en/gis-format-conversion-functions.html#function_st-asbinary)\> \< [https://postgis.net/docs/ST\_AsBinary.html](https://postgis.net/docs/ST_AsBinary.html)\>\*Infhaighteacht\*: MariaDB, , Oracle, , 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: ```pycon >>> 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@' ``` ### `ASWKT` #### `class AsWKT(expression, **extra)` \< [https://dev.mysql.com/doc/refman/en/gis-format-conversion-functions.html#function\_st-astext](https://dev.mysql.com/doc/refman/en/gis-format-conversion-functions.html#function_st-astext)\> \< [https://postgis.net/docs/ST\_AsText.html](https://postgis.net/docs/ST_AsText.html)\>\*Infhaighteacht\*: MariaDB, , Oracle, , 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: ```pycon >>> City.objects.annotate(wkt=AsWKT("point")).get(name="Chelyabinsk").wkt 'POINT (55.137555 61.451728)' ``` ### `Geohash` #### `class GeoHash(expression, precision=None, **extra)` *Availability*: MariaDB, [MySQL](https://dev.mysql.com/doc/refman/en/spatial-geohash-functions.html#function_st-geohash), [PostGIS](https://postgis.net/docs/ST_GeoHash.html), SpatiaLite (LWGEOM/RTTOPO) Glacann sé le réimse nó léiriú geografach amháin agus filleann sé léiriú ar an geoiméadracht. Rialaíonn an argóint eochairfhocal `cruinne` líon na gcarachtar sa toradh. > **Changed in Django 6.0** > > MariaDB 12.0.1+ support was added. ## Ilghnéitheach ### `Isempty` #### `class IsEmpty(expr)` \< [https://postgis.net/docs/ST\_IsEmpty.html](https://postgis.net/docs/ST_IsEmpty.html)\>\*Infhaighteacht\*: 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. ### `Isvalid` #### `class IsValid(expr)` *Availability*: MariaDB, [MySQL](https://dev.mysql.com/doc/refman/en/spatial-convenience-functions.html#function_st-isvalid), [PostGIS](https://postgis.net/docs/ST_IsValid.html), 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. > **Changed in Django 6.0** > > MariaDB 12.0.1+ support was added. ### `GeometryType` > **New in Django 6.0** #### `class GeometryType(expr)` *Availability*: [PostGIS](https://postgis.net/docs/GeometryType.html), Oracle 23c+, MariaDB, MySQL, SpatiaLite Accepts a geographic field or expression and returns its geometry type. ### Memsize \`\` #### `class MemSize(expression, **extra)` \< [https://postgis.net/docs/ST\_MemSize.html](https://postgis.net/docs/ST_MemSize.html)\>\*Infhaighteacht\*: 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. ### `Uimhreacha Geometrai` #### `class NumGeometries(expression, **extra)` \< [https://dev.mysql.com/doc/refman/en/gis-geometrycollection-property-functions.html#function\_st-numgeometries](https://dev.mysql.com/doc/refman/en/gis-geometrycollection-property-functions.html#function_st-numgeometries)\> \< [https://postgis.net/docs/ST\_NumGeometries.html](https://postgis.net/docs/ST_NumGeometries.html)\>\* Infhaighteacht\*: MariaDB, , , 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. ### `Numpoints` #### `class NumPoints(expression, **extra)` \< [https://dev.mysql.com/doc/refman/en/gis-linestring-property-functions.html#function\_st-numpoints](https://dev.mysql.com/doc/refman/en/gis-linestring-property-functions.html#function_st-numpoints)\> \< [https://postgis.net/docs/ST\_NPoints.html](https://postgis.net/docs/ST_NPoints.html)\>\* Infhaighteacht\*: MariaDB, , , 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\`.