{"title":"API Múnla GeodJango","version":"5.2","locale":"ga","docname":"ref/contrib/gis/model-api","url":"/ga/5.2/ref/contrib/gis/model-api/","canonical":"https://djangodocs.dev/ga/5.2/ref/contrib/gis/model-api/","summary":"Scrúdaíonn an doiciméad seo sonraí an API Múnla GeoDjango.","html":"

API Múnla GeodJangoLink to this heading#

\n

Scrúdaíonn an doiciméad seo sonraí an API Múnla GeoDjango. Le linn na roinn seo, beimid ag úsáid an tsamhail gheografach seo a leanas de `cód ZIP`__ agus de `Múnla Airde Digit`__ mar ár samplaí:

\n
Code
from django.contrib.gis.db import models\n\n\nclass Zipcode(models.Model):\n    code = models.CharField(max_length=5)\n    poly = models.PolygonField()\n\n\nclass Elevation(models.Model):\n    name = models.CharField(max_length=100)\n    rast = models.RasterField()\n
\n
\n

Cineálacha Réimse spásúLink to this heading#

\n

Is éard atá i réimsí spásúla sraith cineálacha réimse geoiméadrachta agus cineál réimse raster amháin. Freagraíonn gach ceann de na cineálacha réimse geoiméadair do shonraíocht Gnéithe Simple OpenGIS [#fnogc] _. Níl aon chaighdeán den sórt sin ann do shonraí raster.

\n
\n

Réimse GeoiméadraitheLink to this heading#

\n
\n
\nclass GeometryFieldLink to this definition#
\n
\n\n

An bunaicme do réimsí geoiméadrachta.

\n
\n
\n

PointfieldLink to this heading#

\n
\n
\nclass PointFieldLink to this definition#
\n
\n\n

Stórais a: aicme: ~django.contrib.gis.geos.point.

\n
\n
\n

LínestringfieldLink to this heading#

\n
\n
\nclass LineStringFieldLink to this definition#
\n
\n\n

Stórais a: aicme: ~django.contrib.gis.geos.lineString.

\n
\n
\n

PolygonfieldLink to this heading#

\n
\n
\nclass PolygonFieldLink to this definition#
\n
\n\n

Stórais a: aicme: ~django.contrib.gis.geos.polygon.

\n
\n
\n

Réimse IlphointLink to this heading#

\n
\n
\nclass MultiPointFieldLink to this definition#
\n
\n\n

Stórais a: aicme: ~django.contrib.gis.geos.multipoint.

\n
\n
\n

Páirc IllíneachLink to this heading#

\n
\n
\nclass MultiLineStringFieldLink to this definition#
\n
\n\n

Stórais a: aicme: ~django.contrib.gis.geos.multilineString.

\n
\n
\n

MultipolygonfieldLink to this heading#

\n
\n
\nclass MultiPolygonFieldLink to this definition#
\n
\n\n

Stórais a: aicme: ~django.contrib.gis.geos.multipolygon.

\n
\n
\n

Réimse Bailiúcháin GeoimetrachLink to this heading#

\n
\n
\nclass GeometryCollectionFieldLink to this definition#
\n
\n\n

Stórais a: aicme: ~django.contrib.gis.geos.geometryCollection.

\n
\n
\n

RasterfieldLink to this heading#

\n
\n
\nclass RasterFieldLink to this definition#
\n
\n\n

Stórais a:aicme: ~django.contrib.gis.gdal.gdalraster.

\n

Ní chuirtear `Rasterfield ``i bhfeidhm faoi láthair ach amháin don chúltaca PostGIS.

\n
\n
\n
\n

Roghanna Réimse spásúlaLink to this heading#

\n

Chomh maith leis na rialt:ref: common-model-field-options atá ar fáil do réimsí samhail Django, tá na roghanna breise seo a leanas ag réimsí spásúla. Tá gach ceann roghnach.

\n
\n

SridLink to this heading#

\n
\n
\nBaseSpatialField.sridLink to this definition#
\n
\n\n

Socraíonn an SRID [#fnogcsrid] _ (Aitheantas Córais Tagartha Spásúil) an réimse geoiméadrach don luach a thugtar. Réamhshocraithe go 4326 (ar a dtugtar `WGS84`__ freisin, tá aonaid i gcéimeanna fadmhéad agus domhanleithead).

\n
\n

SRID a roghnúLink to this heading#

\n

Is cinneadh tábhachtach é SRID iomchuí a roghnú do do mhúnla ar chóir don fhorbróir machnamh go cúramach. Is sonraitheoir sláireach é an SRID a fhreagraíonn don chóras teilgean a úsáidfear chun na sonraí sa bhunachar sonraí spásúil a léirmhíniú. [#fnsrid] _ Tugann córais teilgean an comhthéacs do na comhordanáidí a shonraíonn suíomh. Cé go bhfuil sonraí `geodesy`__ thar raon feidhme na doiciméadaithe seo, is í an fhadhb ghinearálta ná go bhfuil an domhan sféarúil agus nach bhfuil léiriúcháin ar an domhan (m.sh., léarscáileanna páipéir, léarscáileanna gréasáin).

\n

Tá eolas ag mórchuid na ndaoine ar domhanleithead agus domhanfhad a úsáid chun tagairt a dhéanamh do shuíomh ar dhromchla an domhain. Mar sin féin, is uillinneacha iad domhanleithead agus domhanfhad, ní achair. Is é sin le rá, cé gur líne dhíreach an cosán is giorra idir dhá phointe ar dhromchla cothrom, is é an cosán is giorra idir dhá phointe ar dhromchla cuartha (mar shampla an talamh) ná arc de `ciorcal mór`__. [#fnthematic] _ Dá bhrí sin, teastaíonn ríomh breise chun achair a fháil in aonaid phlanar (m.sh., ciliméadar agus míle). D'fhéadfadh córas comhordaithe geografach a úsáid deacrachtaí a thabhairt don fhorbróir níos déanaí. Mar shampla, níl sé de chumas ag SpatiaLite ríomhanna achair a dhéanamh idir geoiméadraí ag baint úsáide as córais chomhordaithe geografacha, m.sh. ceist a thógáil chun gach pointe a aimsiú laistigh de 5 míle ó theorainn chontae atá stóráilte mar WGS84. [#fndist] _

\n

Féadfar codanna de dhromchla an domhain a réamh-mheas ar eitleán déthoiseach, nó Cartesian. Tá córais chomhordaithe réamh-mheasta áisiúil go háirithe d'fheidhmchláir atá sonrach le réigiún, m.sh., má tá a fhios agat nach gclúdóidh do bhunachar sonraí ach geoiméadraí i `Kansas Thuaidh `__, ansin féadfaidh tú smaoineamh ar chóras teilgean a úsáid Thairis sin, sainmhínítear córais chomhordaithe réamh-mheasta in aonaid Cairtesian (mar mhéadair nó cosa), ag maolú ríomhanna achair.

\n\n

Acmhainní Breise:

\n
    \n

  • `spatialreference.org`__: Bunachar sonraí faoi thiomáint Django de chórais tagartha spásúla.

    • \n

  • `An Córas Comhordaithe Pléanna Stáit`__: Suíomh Gréasáin a chlúdaíonn na córais teilgean éagsúla a úsáidtear sna Stáit Aontaithe. Beidh cuid mhaith de shonraí spásúla na SA a bhíonn i gceann de na córais chomhordaithe seo seachas i gcóras comhordaithe geografach mar WGS84.

    • \n
\n
\n
\n
\n

Innéacsa_spáisLink to this heading#

\n
\n
\nBaseSpatialField.spatial_indexLink to this definition#
\n
\n\n

Réamhshocraithe go True. Cruthaíonn innéacs spásúil don réimse geoiméadrach ar leith.

\n\n
\n
\n
\n

Roghanna Réimse CéimLink to this heading#

\n

Tá roghanna breise ar fáil do réimsí Geoiméadra. Tá na roghanna seo a leanas go léir roghnach.

\n
\n

`dimLink to this heading#

\n
\n
\nGeometryField.dimLink to this definition#
\n
\n\n

Is féidir an rogha seo a úsáid chun toise comhordaithe an réimse geoiméadrach a shaincheapadh. De réir réamhshocraithe, tá sé socraithe go 2, chun geoiméadraí déthoiseach a léiriú. Maidir le cúltaca spásúla a thacaíonn leis, féadfar é a shocrú go 3 le haghaidh tacaíochta tríthoiseach.

\n\n
\n
\n

GeografaLink to this heading#

\n
\n
\nGeometryField.geographyLink to this definition#
\n
\n\n

Má tá sé socraithe ar True, cruthóidh an rogha seo colún bunachar sonraí de chineál tíreolaíochta, seachas geoiméadracht. Féach an roinn:ref: `cineál tíreolaíochta <geography-type>`thíos le do thoil le haghaidh tuilleadh sonraí.

\n\n
\n
\n

max_geom_collectionsLink to this heading#

\n
\n
\nGeometryField.max_geom_collectionsLink to this definition#
\n
\n\n\n

This option is forwarded to the form field generated for this model\nfield, bounding how many geometry collections may be contained in submitted\nWKB/WKT inputs before raising ValueError. Since spatial field\nassignments are lazy, it is also checked when values are accessed, e.g. when\nsaving an instance, but not when read from a database. It defaults to 198.

\n
\n

Cineál TíreolaíochtaLink to this heading#

\n

Soláthraíonn an cineál tíreolaíochta tacaíocht dúchasach do ghnéithe spásúla a léirítear le comhordanáidí geografacha (m.sh., fad/domhanleithead WGS84) [#fngeography] _ Murab ionann agus an eitleán a úsáideann cineál geoiméadrach, úsáideann an cineál tíreolaíochta léiriú sféarúil dá shonraí. Fostaíonn oibríochtaí achair agus tomhais a dhéantar ar cholún tíreolaíochta ríomhanna stua ciorcail iontacha agus aonaid líneacha ar ais Is é sin le rá, nuair a ghlaofar ST_distance ar dhá gheograíocht, cuirtear luach i méadar ar ais (seachas céimeanna má ghairtear ar cholún geoiméadais i WGS84).

\n

Toisc go bhfuil níos mó matamaitice i gceist le ríomhanna tíreolaíochta, níl ach fo-thacar de na cuardaigh spásúla PostGIS ar fáil don chineál tíreolaíochta. <spatial-lookups>Go praiticiúil, <distance-lookups>ciallaíonn sé seo nach bhfuil ach na cuardach breise seo a leanas: ref: cuardaigh spásúla `ar fáil do cholúin tíreolaíochta, i dteann:ref: `cuardach achair:

\n\n

Más gá duit cuardach spásúil nó comhiomlán a úsáid nach dtacaíonn leis an gcineál tíreolaíochta mar ionchur, is féidir leat feidhm bhunachar sonraí: class: `~django.db.Models.functions.cast a úsáid chun an colún tíreolaíochta a thiontú go cineál geoiméadrach san fhiosrúchán:

\n
Code
from django.contrib.gis.db.models import PointField\nfrom django.db.models.functions import Cast\n\nZipcode.objects.annotate(geom=Cast("geography_field", PointField())).filter(\n    geom__within=poly\n)\n
\n

< https://postgis.net/docs/using_postgis_dbmanagement.html#PostGIS_GeographyVSGeometry>Le haghaidh tuilleadh faisnéise, tá rannán cabhrach sa dhoiciméadú PostGIS maidir le cinneadh a dhéanamh ar `cathain a úsáidfear cineál sonraí tíreolaíochta thar chineál sonraí geoiméad

\n

Fonótaí

\n\n
\n
\n
","rootId":"module-django.contrib.gis.db.models","toc":[{"title":"Cineálacha Réimse spású","anchor":"spatial-field-types","children":[{"title":"Réimse Geoiméadraithe","anchor":"geometryfield","children":[]},{"title":"Pointfield","anchor":"pointfield","children":[]},{"title":"Línestringfield","anchor":"linestringfield","children":[]},{"title":"Polygonfield","anchor":"polygonfield","children":[]},{"title":"Réimse Ilphoint","anchor":"multipointfield","children":[]},{"title":"Páirc Illíneach","anchor":"multilinestringfield","children":[]},{"title":"Multipolygonfield","anchor":"multipolygonfield","children":[]},{"title":"Réimse Bailiúcháin Geoimetrach","anchor":"geometrycollectionfield","children":[]},{"title":"Rasterfield","anchor":"rasterfield","children":[]}]},{"title":"Roghanna Réimse spásúla","anchor":"spatial-field-options","children":[{"title":"Srid","anchor":"srid","children":[{"title":"SRID a roghnú","anchor":"selecting-an-srid","children":[]}]},{"title":"Innéacsa_spáis","anchor":"spatial-index","children":[]}]},{"title":"Roghanna Réimse Céim","anchor":"geometry-field-options","children":[{"title":"`dim","anchor":"dim","children":[]},{"title":"Geografa","anchor":"geography","children":[]},{"title":"max_geom_collections","anchor":"max-geom-collections","children":[{"title":"Cineál Tíreolaíochta","anchor":"geography-type","children":[]}]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/5.2/ref/"},{"docname":"ref/contrib/index","title":"Pacáistí contrib","url":"/ga/5.2/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeodJango","url":"/ga/5.2/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/install/spatialite","title":"Suiteáil SpatiaLite","url":"/ga/5.2/ref/contrib/gis/install/spatialite/"},"next":{"docname":"ref/contrib/gis/db-api","title":"API Bunachar Sonraí GeodJango","url":"/ga/5.2/ref/contrib/gis/db-api/"},"formats":{"html":"/ga/5.2/ref/contrib/gis/model-api/","markdown":"/ga/5.2/ref/contrib/gis/model-api.md","json":"/ga/5.2/ref/contrib/gis/model-api.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/contrib/gis/model-api.txt","official":"https://docs.djangoproject.com/ga/5.2/ref/contrib/gis/model-api/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}