djangodocs

Django 5.2
Gaeilge
Documentation contents

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 `cód ZIP`__ agus de `Múnla Airde Digit`__ mar ár samplaí:

Code
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 `WGS84`__ 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í `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).

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] _

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.

Acmhainní Breise:

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

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

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.

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.

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 <geography-type>`thíos le do thoil le haghaidh tuilleadh sonraí.

max_geom_collections

GeometryField.max_geom_collections

This option is forwarded to the form field generated for this model field, bounding how many geometry collections may be contained in submitted WKB/WKT inputs before raising 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. <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:

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:

Code
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>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í

View as Markdown Edit this page on GitHub Official version