GeoDjango modell-API¶
Det hÀr dokumentet undersöker detaljerna i GeoDjango Model API. I hela detta avsnitt anvÀnds följande geografiska modell av ett postnummer 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).
Setting the SRID to -1 disables automatic SRID transformations when saving
geometries. The assigned geometryâs SRID is set to -1, discarding any
explicit SRID it had.
VÀlja en SRID¶
Att vÀlja ett lÀmpligt SRID för modellen Àr ett viktigt beslut som utvecklaren bör övervÀga noggrant. SRID Àr en heltalsspecifikation som motsvarar det projektionssystem som anvÀnds för att tolka data i den spatiala databasen. [3] Projektionssystem ger ett sammanhang Ät koordinaterna som anger en plats. Detaljerna i geodesi ligger utanför denna dokumentations rÀckvidd, men det grundlÀggande problemet Àr att jorden Àr sfÀrisk medan representationer av jorden (t.ex. papperskartor och webbkartor) inte Àr det.
De flesta kÀnner till att anvÀnda latitud och longitud för att ange en plats pÄ jordytan. Latitud och longitud Àr dock vinklar, inte avstÄnd. Med andra ord Àr den kortaste vÀgen mellan tvÄ punkter pÄ en plan yta en rak linje, medan den kortaste vÀgen mellan tvÄ punkter pÄ en krökt yta (som jorden) Àr en bÄge av en storcirkel. [4]
DÀrför krÀvs ytterligare berÀkningar för att fÄ avstÄnd i plana enheter (t.ex. kilometer och engelska mil). Att anvÀnda ett geografiskt koordinatsystem kan medföra komplikationer för utvecklaren senare. SpatiaLite kan till exempel inte utföra avstÄndsberÀkningar mellan geometrier som anvÀnder geografiska koordinatsystem, sÄsom att konstruera en frÄga för att hitta alla punkter inom 5 engelska mil frÄn en lÀnsgrÀns lagrad som WGS84. [5]
Delar av jordytan kan projiceras pÄ ett tvÄdimensionellt, eller kartesiskt, plan. Projekterade koordinatsystem Àr sÀrskilt praktiska för regionspecifika tillÀmpningar. Om du till exempel vet att databasen endast tÀcker geometrier i North Kansas kan du övervÀga att anvÀnda ett projektionssystem som Àr specifikt för den regionen. Dessutom definieras projekterade koordinatsystem i kartesiska enheter (som meter eller fot), vilket underlÀttar avstÄndsberÀkningar.
Anteckning
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 databas med spatiala referenssystem.
The State Plane Coordinate System: En webbplats som beskriver de olika projektionssystem som anvÀnds i USA. Mycket av de spatiala data frÄn USA som du möter kommer att anvÀnda nÄgot av dessa koordinatsystem i stÀllet för ett geografiskt koordinatsystem som WGS84.
rumsligt_index¶
- BaseSpatialField.spatial_index¶
StandardvÀrdet Àr True. Skapar ett spatialt index för det angivna geometrifÀltet.
Anteckning
Detta skiljer sig frÄn fÀltalternativet db_index eftersom spatiala index skapas pÄ ett annat sÀtt Àn vanliga databasindex. I synnerhet skapas spatiala index vanligen med en variant av R-trÀdet, medan vanliga databasindex vanligen 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 för geometrifÀltet. Som standard Àr det satt till 2 för att representera tvÄdimensionella geometrier. För spatiala backendar som stöder det kan det sÀttas till 3 för tredimensionellt stöd.
Anteckning
För nÀrvarande Àr 3D-stödet begrÀnsat till PostGIS- och SpatiaLite-backends.
geografi¶
- GeometryField.geography¶
Om vÀrdet Àr True skapar detta alternativ en databaskolumn av typen geography i stÀllet för geometry. Mer information finns i avsnittet geography-typen nedan.
Anteckning
Geografistödet Àr begrÀnsat till PostGIS och tvingar SRID att vara 4326.
max_geom_collections¶
- GeometryField.max_geom_collections¶
This option is forwarded to the form field generated for this model
field, bounding the geometry collection nesting depth 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.
Geography-typ¶
Geography-typen ger inbyggt stöd för spatiala objekt som representeras med geografiska koordinater (t.ex. WGS84-longitud/latitud). [6] Till skillnad frÄn det plan som anvÀnds av en geometry-typ anvÀnder geography-typen en sfÀrisk representation av sina data. AvstÄnds- och mÀtoperationer som utförs pÄ en geography-kolumn anvÀnder automatiskt berÀkningar med storcirkelbÄgar och returnerar linjÀra enheter. Med andra ord returneras ett vÀrde i meter nÀr ST_Distance anropas för tvÄ geography-objekt (i stÀllet för grader om det anropas för en geometry-kolumn 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
)
Mer information finns i PostGIS-dokumentationens anvÀndbara avsnitt om att avgöra nÀr datatypen geography ska anvÀndas i stÀllet för geometry.
Fotnoter