GeoDjango modell-API¶
Detta dokument utforskar detaljerna i GeoDjango Model API. I detta avsnitt kommer vi att anvĂ€nda följande geografiska modell av en âZIP-kodâ och en âdigital höjdmodellâ som exempel:
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()
Spatiala fÀlttyper¶
Spatiala fÀlt bestÄr av en serie geometriska fÀlttyper och en rasterfÀlttyp. Var och en av geometrifÀlttyperna motsvarar OpenGIS Simple Features-specifikationen [1]. Det finns ingen sÄdan standard för rasterdata.
GeometryField¶
Basklass för geometriska fÀlt.
PointField¶
Lagrar en Point.
LineStringField¶
Lagrar en LineString.
PolygonField¶
Lagrar en Polygon.
MultiPointField¶
Lagrar en MultiPoint.
MultiLineStringField¶
Lagrar en MultiLineString.
MultiPolygonField¶
Lagrar en MultiPolygon.
GeometryCollectionField¶
Lagrar en GeometryCollection.
RasterField¶
Lagrar en GDALRaster.
RasterField Àr för nÀrvarande endast implementerat för PostGIS backend.
Alternativ för rumslig fÀltindelning¶
Förutom de vanliga Alternativ för fÀlt som finns tillgÀngliga för Django-modellfÀlt, har spatiala fÀlt följande ytterligare alternativ. Alla Àr valfria.
srid¶
- BaseSpatialField.srid¶
StÀller in SRID [2] (Spatial Reference System Identity) för geometrifÀltet till det angivna vÀrdet. StandardvÀrdet Àr 4326 (Àven kÀnt som `WGS84`__, enheterna Àr i grader av longitud och latitud).
VÀlja en SRID¶
Att vĂ€lja en lĂ€mplig SRID för din modell Ă€r ett viktigt beslut som utvecklaren bör övervĂ€ga noga. SRID Ă€r en heltalsspecifikation som motsvarar det projektionssystem som kommer att anvĂ€ndas för att tolka data i den rumsliga databasen. [Projektionssystem ger sammanhang Ă„t de koordinater som anger en plats. Ăven om detaljerna i `geodesi`__ ligger utanför ramen för denna dokumentation, Ă€r det allmĂ€nna problemet att jorden Ă€r sfĂ€risk och att representationer av jorden (t.ex. papperskartor, webbkartor) inte Ă€r det.
De flesta kÀnner till hur man anvÀnder latitud och longitud för att referera till en plats pÄ jordens yta. Latitud och longitud Àr dock vinklar, inte avstÄnd. Med andra ord, medan den kortaste vÀgen mellan tvÄ punkter pÄ en plan yta Àr en rak linje, Àr den kortaste vÀgen mellan tvÄ punkter pÄ en krökt yta (som jorden) en bÄge i en stor cirkel. [4] Det krÀvs alltsÄ ytterligare berÀkningar för att fÄ fram avstÄnd i plana enheter (t.ex. kilometer och miles). Att anvÀnda ett geografiskt koordinatsystem kan medföra komplikationer för utvecklaren i ett senare skede. SpatiaLite har t.ex. inte möjlighet att utföra avstÄndsberÀkningar mellan geometrier som anvÀnder geografiska koordinatsystem, t.ex. att konstruera en frÄga för att hitta alla punkter inom 8 km frÄn en lÀnsgrÀns som lagrats som WGS84. [5]
Delar av jordens yta kan projiceras pĂ„ ett tvĂ„dimensionellt, eller kartesiskt, plan. Projicerade koordinatsystem Ă€r sĂ€rskilt lĂ€mpliga för regionspecifika tillĂ€mpningar, t.ex. om du vet att din databas endast kommer att omfatta geometrier i âNorra Kansasâ, kan du övervĂ€ga att anvĂ€nda ett projektionssystem som Ă€r specifikt för den regionen. Dessutom definieras projicerade koordinatsystem i kartesiska enheter (t.ex. meter eller fot), vilket underlĂ€ttar avstĂ„ndsberĂ€kningar.
Observera
Om du vill utföra godtyckliga avstÄndsfrÄgor med hjÀlp av icke-punktgeometrier i WGS84 i PostGIS och du vill ha anstÀndig prestanda, aktivera nyckelordet GeometryField.geography sÄ att geography database type anvÀnds istÀllet.
Mer om detta:
`spatialreference.org`__: En Django-driven databas med rumsliga referenssystem.
âKoordinatsystemet för det statliga planetâ: En webbplats som tĂ€cker de olika projektionssystem som anvĂ€nds i USA. En stor del av de amerikanska rumsliga data som pĂ„trĂ€ffas kommer att vara i ett av dessa koordinatsystem snarare Ă€n i ett geografiskt koordinatsystem som WGS84.
rumsligt_index¶
- BaseSpatialField.spatial_index¶
StandardvÀrdet Àr True. Skapar ett spatialt index för det angivna geometriska fÀltet.
Observera
Detta skiljer sig frÄn fÀltalternativet db_index eftersom spatiala index skapas pÄ ett annat sÀtt Àn vanliga databasindex. Spatiala index skapas vanligtvis med hjÀlp av en variant av R-trÀdet, medan vanliga databasindex vanligtvis anvÀnder B-trÀd.
Alternativ för geometrifÀlt¶
Det finns ytterligare alternativ tillgÀngliga för Geometry-fÀlt. Alla följande alternativ Àr valfria.
dim¶
- GeometryField.dim¶
Detta alternativ kan anvÀndas för att anpassa koordinatdimensionen i geometrifÀltet. Som standard Àr den instÀlld pÄ 2, för att representera tvÄdimensionella geometrier. För spatiala backends som stöder detta kan den sÀttas till 3 för tredimensionellt stöd.
Observera
För nÀrvarande Àr 3D-stödet begrÀnsat till PostGIS- och SpatiaLite-backends.
geografi¶
- GeometryField.geography¶
Om detta alternativ Àr instÀllt pÄ True skapas en databaskolumn av typen geography i stÀllet för geometry. Se avsnittet geography type nedan för mer information.
Observera
Geografistödet Àr begrÀnsat till PostGIS och tvingar SRID att vara 4326.
Geography-typ¶
Geografitypen ger inbyggt stöd för rumsliga egenskaper som representeras med geografiska koordinater (t.ex. WGS84-lÀngdgrad/latitud). [6] Till skillnad frÄn planet som anvÀnds av en geometrityp, anvÀnder geografin en sfÀrisk representation av sina data. AvstÄnds- och mÀtoperationer som utförs pÄ en geografikolumn anvÀnder automatiskt berÀkningar av storcirkelbÄgar och returnerar linjÀra enheter. Med andra ord, nÀr ST_Distance anropas pÄ tvÄ geografier returneras ett vÀrde i meter (i motsats till grader om det anropas pÄ en geometrikolumn i WGS84).
Eftersom geografiska berÀkningar krÀver mer matematik Àr endast en delmÀngd av PostGIS rumsliga uppslagsord tillgÀngliga för den geografiska typen. I praktiken innebÀr detta att utöver distance lookups Àr endast följande ytterligare spatial lookups tillgÀngliga för geografiska kolumner:
tÀckt avtÀcken
Om du behöver anvÀnda en spatial lookup eller aggregat som inte stöder geografin som indata kan du anvÀnda databasfunktionen Cast för att konvertera geografikolumnen till en geometrityp i frÄgan:
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
)
För mer information, PostGIS-dokumentationen innehĂ„ller ett anvĂ€ndbart avsnitt om att avgöra ânĂ€r man ska anvĂ€nda geografisk datatyp över geometrisk datatyp <https://postgis.net/docs/using_postgis_dbmanagement.html#PostGIS_GeographyVSGeometry>`_.
Fotnoter