--- title: "API Múnla GeodJango" version: 5.2 locale: ga source: https://docs.djangoproject.com/ga/5.2/ref/contrib/gis/model-api/ canonical: https://djangodocs.dev/ga/5.2/ref/contrib/gis/model-api/ --- # API Múnla GeodJango 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 agus de mar ár samplaí: ``` from django.contrib.gis.db import models class Zipcode(models.Model): code = models.CharField(max_length=5) poly = models.PolygonField() class Elevation(models.Model): name = models.CharField(max_length=100) rast = models.RasterField() ``` ## Cineálacha Réimse spású 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. ### `Réimse Geoiméadraithe` #### `class GeometryField` An bunaicme do réimsí geoiméadrachta. ### `Pointfield` #### `class PointField` Stórais a: aicme: ~django.contrib.gis.geos.point. ### `Línestringfield` #### `class LineStringField` Stórais a: aicme: ~django.contrib.gis.geos.lineString. ### `Polygonfield` #### `class PolygonField` Stórais a: aicme: ~django.contrib.gis.geos.polygon. ### `Réimse Ilphoint` #### `class MultiPointField` Stórais a: aicme: ~django.contrib.gis.geos.multipoint. ### `Páirc Illíneach` #### `class MultiLineStringField` Stórais a: aicme: ~django.contrib.gis.geos.multilineString. ### `Multipolygonfield` #### `class MultiPolygonField` Stórais a: aicme: ~django.contrib.gis.geos.multipolygon. ### `Réimse Bailiúcháin Geoimetrach` #### `class GeometryCollectionField` Stórais a: aicme: ~django.contrib.gis.geos.geometryCollection. ### `Rasterfield` #### `class RasterField` Stórais a:aicme: ~django.contrib.gis.gdal.gdalraster. Ní chuirtear Rasterfield i bhfeidhm faoi láthair ach amháin don chúltaca PostGIS. ## Roghanna Réimse spásúla 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. ### `Srid` #### `BaseSpatialField.srid` 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 freisin, tá aonaid i gcéimeanna fadmhéad agus domhanleithead). #### SRID a roghnú 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í 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). 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 . \[#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\] \_ 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. > **Note** > > \Más mian leat ceisteanna achair treallacha a dhéanamh ag baint úsáide as geoiméadraí neamh-phointe i WGS84 i PostGIS agus ba mhaith leat feidhmíocht mhaith, cumasaigh an eochairfhocal: attr: Geometryfield.geography ionas go n-úsáidtear: ref: cineál bunachar sonraí tíreolaíochta ina ionad. Acmhainní Breise: - : Bunachar sonraí faoi thiomáint Django de chórais tagartha spásúla. - : 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. ### `Innéacsa_spáis` #### `BaseSpatialField.spatial_index` Réamhshocraithe go `True`. Cruthaíonn innéacs spásúil don réimse geoiméadrach ar leith. > **Note** > > Tá sé seo difriúil ón rogha réimse db\_index toisc go gcruthaítear innéacsanna spásúla ar bhealach difriúil ná innéacsanna bunachar sonraí rialta. Go sonrach, cruthaítear innéacsanna spásúla de ghnáth ag baint úsáide as leagan den R-Tree, agus is gnách go n-úsáideann innéacsanna bunachar sonraí rialta B-Crainn. ## Roghanna Réimse Céim Tá roghanna breise ar fáil do réimsí Geoiméadra. Tá na roghanna seo a leanas go léir roghnach. ### `` `dim `` #### `GeometryField.dim` 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. > **Note** > > Ag an am seo tá tacaíocht 3D teoranta do na cúltaca PostGIS agus Spatialite. ### `Geografa` #### `GeometryField.geography` 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 \\`thíos le do thoil le haghaidh tuilleadh sonraí. > **Note** > > Tá tacaíocht tíreolaíochta teoranta do PostGIS agus cuirfidh sé iallach ar an SRID a bheith 4326. ### `max_geom_collections` #### `GeometryField.max_geom_collections` > **New in Django 5.2.17** This option is forwarded to the [`form field`](/ga/5.2/ref/contrib/gis/forms-api/#django.contrib.gis.forms.Field.max_geom_collections) generated for this model field, bounding how many geometry collections may be contained in submitted WKB/WKT inputs before raising [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError). Since spatial field assignments are lazy, it is also checked when values are accessed, e.g. when saving an instance, but not when read from a database. It defaults to `198`. #### Cineál Tíreolaíochta 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). 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. \Go praiticiúil, \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: - [`bboverlaps`](/ga/5.2/ref/contrib/gis/geoquerysets/#std-fieldlookup-bboverlaps) - [`coveredby`](/ga/5.2/ref/contrib/gis/geoquerysets/#std-fieldlookup-coveredby) - [`covers`](/ga/5.2/ref/contrib/gis/geoquerysets/#std-fieldlookup-covers) - [`intersects`](/ga/5.2/ref/contrib/gis/geoquerysets/#std-fieldlookup-intersects) 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: ``` from django.contrib.gis.db.models import PointField from django.db.models.functions import Cast Zipcode.objects.annotate(geom=Cast("geography_field", PointField())).filter( geom__within=poly ) ``` \< [https://postgis.net/docs/using\_postgis\_dbmanagement.html#PostGIS\_GeographyVSGeometry](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 **Fonótaí** [^1]: OpenGIS Consortium, Inc., . \< \> [^2]: *Féach id.* ag Ch. 2.3.8, lch. 39 (Luachanna Coiméadrachta agus Córais Tagartha Spásúla). [^3]: De ghnáth, freagraíonn sláimhir SRID d'aitheantóir EPSG (). Mar sin féin, d'fhéadfadh sé a bheith bainteach freisin le réamh-mheastacháin saincheaptha a shainmhínítear i dtábla córais tagartha spásúla [^4]: Terry A. Slocum, Robert B. McMaster, Fritz C. Kessler, & Hugh H. Howard, *Cartografaíocht Téamach agus Amharc Geografach* (Halla Prentice, 2ú eagrán), ag Ch. 7.1.3. [^5]: Ní bhaineann an teorannú seo le PostGIS. [^6]: Féach do thoil do dhoiciméadú Cineál Tíreolaíochta PostGIS \_ le haghaidh tuilleadh son\< [https://postgis.net/docs/using\_postgis\_dbmanagement.html#PostGIS\_Geography](https://postgis.net/docs/using_postgis_dbmanagement.html#PostGIS_Geography)\> raí.