Feidhmeanna Bunachar SonraíLink to this heading
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:
>>> 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.
MeasurementsLink to this heading
LimistéarLink to this heading
- class Area(expression, **extra)Link to this definition
< https://dev.mysql.com/doc/refman/en/gis-polygon-property-functions.html#function_st-area> < https://postgis.net/docs/ST_Area.html>*Infhaighteacht*: 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.
CaidrimhLink to this heading
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.
OibríochtaíLink to this heading
``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.
EagarthóiríLink to this heading
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
``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
Glacann sé le réimse nó léiriú geografach amháin agus filleann sé céiméadracht le gach pointe a ghearradh chuig an eangach ar leith. Braitheann an chaoi a ngearrtar an geoiméadracht chuig an eangach ar cé mhéad argóint uimhriúla (snámhphointe, sláimhir nó fada) a thugtar.
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. |
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.
Formáid ionchuirLink to this heading
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.
Formáid aschuirLink to this heading
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]}
Argóint Eochairfho |
Cur síos |
|---|---|
|
Socraigh é seo go |
|
Socraigh é seo go |
|
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. |
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>
Argóint Eochairfho |
Cur síos |
|---|---|
|
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. |
|
Sonraíonn sé an leagan GML le húsáid: 2 (réamhshocraithe) nó 3. |
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>
Argóint Eochairfho |
Cur síos |
|---|---|
|
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. |
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.
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 |
|
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. |
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
< https://dev.mysql.com/doc/refman/en/spatial-geohash-functions.html#function_st-geohash> < https://postgis.net/docs/ST_GeoHash.html>* Infhaighteacht*: `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.
IlghnéitheachLink to this heading
IsemptyLink to this heading
- class IsEmpty(expr)Link to this definition
< https://postgis.net/docs/ST_IsEmpty.html>*Infhaighteacht*: `PostGis`__
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
< https://dev.mysql.com/doc/refman/en/spatial-convenience-functions.html#function_st-isvalid> < https://postgis.net/docs/ST_IsValid.html>*Infhaighteacht*: `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.
``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.
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.
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`.