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 transformerade LayerMapping de tre geometrierna från shapefilen i deras ursprungliga spatiala referenssystem (WGS84) till det spatiala referenssystemet för GeoDjango-modellen (NAD83). Om inget spatialt referenssystem är definierat för lagret använder du 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 instanser av | \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ällans SRS manuellt (vissa shapefiler levereras till exempel utan filen | \n
| \nAnger teckenkodsningen för strängarna i OGR-datakällan. Till exempel är | \n
| \nKan vara | \n
| \nOm detta anges till False inaktiveras koordinattransformationer. Med andra ord infogas geometrier i databasen utan ändringar från deras ursprungliga tillstånd i datakällan. | \n
| \nOm detta anges till namnet, eller en tuppel med namn, från den angivna modellen skapas modeller som är unika endast för det angivna namnet eller de angivna namnen. Geometrier från varje objekt läggs till i samlingen som är kopplad till den unika modellen. Tvingar transaktionsläget till | \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 utdata-loggning, felhantering och import av specifika intervall av objekt.
Spara sökordsargument | \nBeskrivning | \n
|---|---|
| \nKan anges med ett snitt eller en tuppel av objekt-ID:n | \n
| \nNär detta nyckelord anges skrivs statusinformation ut med antalet objekt som behandlats och sparats. Som standard skrivs förloppsinformation ut för var 1 000:e bearbetat objekt, men detta standardvärde kan åsidosättas genom att ange 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 skrivs till detta filhandtag. Standardvärdet är | \n
| \nKörningen av modellmappningen avbryts vid det första fel 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 anges i varningen i början av detta avsnitt lagrar Django alla SQL-frågor när DEBUG=True. Sätt DEBUG=False i inställningarna så bör den stora minnesanvändningen upphöra när LayerMapping-skript körs.
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")\nLösningen är då att öka värdet för inställningen max_allowed_packet i MySQL-konfigurationen. Standardvärdet kan till exempel vara så lågt som en megabyte – inställningen kan ändras i MySQL-konfigurationsfilen (my.cnf), i avsnittet [mysqld]:
max_allowed_packet = 10M\n