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:
\nfrom 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()\nSpatiala 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.
\nGeometryFieldLink to this heading#Basklass för geometriska fält.
\nPointFieldLink to this heading#Lagrar en Point.
LineStringFieldLink to this heading#Lagrar en LineString.
PolygonFieldLink to this heading#Lagrar en Polygon.
MultiPointFieldLink to this heading#Lagrar en MultiPoint.
MultiLineStringFieldLink to this heading#Lagrar en MultiLineString.
MultiPolygonFieldLink to this heading#Lagrar en MultiPolygon.
GeometryCollectionFieldLink to this heading#Lagrar en GeometryCollection.
RasterFieldLink to this heading#Lagrar en GDALRaster.
RasterField är för närvarande endast implementerat för PostGIS backend.
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.
\nsridLink to this heading#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).
\nSetting the SRID to -1 disables automatic SRID transformations when saving\ngeometries. The assigned geometry’s SRID is set to -1, discarding any\nexplicit SRID it had.
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.
\nDe 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]
\nDä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]
\nDelar 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.
\n\nMer om detta:
\nspatialreference.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_indexLink to this heading#Standardvärdet är True. Skapar ett spatialt index för det angivna geometrifältet.
Det finns ytterligare alternativ tillgängliga för Geometry-fält. Alla följande alternativ är valfria.
\ndimLink to this heading#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.
\n\ngeografiLink to this heading#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.
max_geom_collectionsLink to this heading#Detta alternativ vidarebefordras till formulärfältet som genereras för detta modellfält och begränsar hur många geometrisamlingar som kan ingå i inskickad WKB/WKT-indata innan ValueError utlöses. Eftersom tilldelningar till spatiala fält är lata kontrolleras det även när värden används, t.ex. när en instans sparas, men inte när de läses från en databas. Standardvärdet är 198.
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:
\ntäckt av
tä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\nfrom django.db.models.functions import Cast\n\nZipcode.objects.annotate(geom=Cast("geography_field", PointField())).filter(\n geom__within=poly\n)\nMer 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.
\nFotnoter
\n\n