LayerMapping verktyg för dataimportLink to this heading#Klassen LayerMapping ger ett sätt att mappa innehållet i vektorbaserade rumsliga datafiler (t.ex. shapefiler) till GeoDjango-modeller.
Detta verktyg växte fram ur författarens personliga behov av att eliminera kodupprepningen som gick ut på att dra ut geometrier och fält från ett vektorlager, konvertera till ett annat koordinatsystem (t.ex. WGS84) och sedan infoga i en GeoDjango-modell.
\n\n\nDu behöver en GDAL-stödd datakälla, t.ex. en shapefil (här använder vi en enkel polygon-shapefil, test_poly.shp, med tre funktioner):
>>> from django.contrib.gis.gdal import DataSource\n>>> ds = DataSource("test_poly.shp")\n>>> layer = ds[0]\n>>> print(layer.fields) # Exploring the fields in the layer, we only want the 'str' field.\n['float', 'int', 'str']\n>>> print(len(layer)) # getting the number of features in the layer (should be 3)\n3\n>>> print(layer.geom_type) # Should be 'Polygon'\nPolygon\n>>> print(layer.srs) # WGS84 in WKT\nGEOGCS["GCS_WGS_1984",\n DATUM["WGS_1984",\n SPHEROID["WGS_1984",6378137,298.257223563]],\n PRIMEM["Greenwich",0],\n UNIT["Degree",0.017453292519943295]]\nNu definierar vi vår motsvarande Django-modell (se till att använda migrate):
from django.contrib.gis.db import models\n\n\nclass TestGeo(models.Model):\n name = models.CharField(max_length=25) # corresponds to the 'str' field\n poly = models.PolygonField(srid=4269) # we want our model in a different SRID\n\n def __str__(self):\n return "Name: %s" % self.name\nAnvänd LayerMapping för att extrahera alla funktioner och placera dem i databasen:
>>> from django.contrib.gis.utils import LayerMapping\n>>> from geoapp.models import TestGeo\n>>> mapping = {\n... "name": "str", # The 'name' model field maps to the 'str' layer field.\n... "poly": "POLYGON", # For geometry fields use OGC name.\n... } # The mapping is a dictionary\n>>> lm = LayerMapping(TestGeo, "test_poly.shp", mapping)\n>>> lm.save(verbose=True) # Save the layermap, imports the data.\nSaved: Name: 1\nSaved: Name: 2\nSaved: Name: 3\nHär har LayerMapping omvandlat de tre geometrierna från shapefilen i deras ursprungliga rumsliga referenssystem (WGS84) till GeoDjango-modellens rumsliga referenssystem (NAD83). Om inget rumsligt referenssystem har definierats för skiktet, använd nyckelordet source_srs med ett SpatialReference-objekt för att ange ett.
LayerMapping APILink to this heading#Följande är de argument och nyckelord som kan användas vid instansiering av LayerMapping objekt.
Argument | \nBeskrivning | \n
|---|---|
| \nDen geografiska modellen, inte en instans. | \n
| \nSökvägen till den OGR-stödda datakällfilen (t.ex. en shapefil). Accepterar även | \n
| \nEn ordbok: nycklarna är strängar som motsvarar modellfältet och värdena motsvarar strängfältsnamn för OGR-objektet, eller om modellfältet är geografiskt bör det motsvara OGR:s geometrityp, t.ex. | \n
Argument för nyckelord | \n\n |
|---|---|
| \nIndexet för det lager som ska användas från datakällan (standardvärde 0) | \n
| \nAnvänd detta för att ange källan SRS manuellt (till exempel, vissa shapefiler levereras inte med en | \n
| \nAnger teckenuppsättningskodningen för strängarna i OGR-datakällan. Exempelvis är | \n
| \nKan vara | \n
| \nOm du ställer in detta på False inaktiveras koordinattransformationer. Med andra ord kommer geometrier att infogas i databasen oförändrade från sitt ursprungliga tillstånd i datakällan. | \n
| \nOm du ställer in detta till namnet, eller en tupel av namn, från den givna modellen skapas modeller som är unika endast för det eller de angivna namnen. Geometrier från varje funktion kommer att läggas till i den samling som är associerad med den unika modellen. Tvingar transaktionsläget att vara | \n
| \nAnger den databas som ska användas vid import av rumsliga data. Standard är | \n
save() Nyckelord ArgumentLink to this heading#Metoden save() accepterar även nyckelord. Dessa nyckelord används för att styra loggning av utdata, felhantering och för att importera specifika funktionsområden.
Spara sökordsargument | \nBeskrivning | \n
|---|---|
| \nKan anges med en del eller en tupel av (början, slut) funktions-ID:n som ska mappas från datakällan. Med andra ord gör detta nyckelord det möjligt för användaren att selektivt importera en delmängd av funktioner i den geografiska datakällan. | \n
| \nNär detta nyckelord är inställt skrivs statusinformation ut som anger antalet funktioner som har bearbetats och sparats. Som standard skrivs statusinformationen ut var 1000:e bearbetad funktion, men denna standard kan åsidosättas genom att ange detta nyckelord med ett heltal för önskat intervall. | \n
| \nSom standard skrivs icke-fatala felmeddelanden ut till | \n
| \nOm det anges med ett heltal kommer transaktioner att ske vid varje stegintervall. Om t.ex. | \n
| \nStatusinformation kommer att skrivas till detta filhandtag. Standard är att använda | \n
| \nExekveringen av modellmappningen kommer att avbrytas vid det första felet som påträffas. Standardvärdet ( | \n
| \nOm den är inställd kommer information att skrivas ut efter varje modellsparning som utförs i databasen. | \n
Som nämnts i varningen högst upp i detta avsnitt lagrar Django alla SQL-frågor när DEBUG=True. Ställ in DEBUG=False i dina inställningar, och detta bör stoppa överdriven minnesanvändning när du kör LayerMapping skript.
max_allowed_packet felLink to this heading#Om du stöter på följande fel när du använder LayerMapping och MySQL:
OperationalError: (1153, "Got a packet bigger than 'max_allowed_packet' bytes")\nDå är lösningen att öka värdet på inställningen max_allowed_packet i din MySQL-konfiguration. Standardvärdet kan till exempel vara något så lågt som en megabyte – inställningen kan ändras i MySQL:s konfigurationsfil (my.cnf) i avsnittet [mysqld]:
max_allowed_packet = 10M\n