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\nHere, LayerMapping transformed the three geometries from the shapefile\nin their original spatial reference system (WGS84) to the spatial reference\nsystem of the GeoDjango model (NAD83). If no spatial reference system is\ndefined for the layer, use the source_srs keyword with a\nSpatialReference object to specify one.
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
| \nThe path to the OGR-supported data source file\n(e.g., a shapefile). Also accepts\n | \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
| \nUse this to specify the source SRS manually (for\nexample, some shapefiles don’t come with a | \n
| \nSpecifies the character set encoding of the strings\nin the OGR data source. For example, | \n
| \nKan vara | \n
| \nSetting this to False will disable coordinate\ntransformations. In other words, geometries will\nbe inserted into the database unmodified from their\noriginal state in the data source. | \n
| \nSetting this to the name, or a tuple of names,\nfrom the given model will create models unique\nonly to the given name(s). Geometries from\neach feature will be added into the collection\nassociated with the unique model. Forces\nthe transaction mode to be | \n
| \nAnger den databas som ska användas vid import av rumsliga data. Standard är | \n
save() Nyckelord ArgumentLink to this heading#The save() method also accepts keywords. These keywords are\nused for controlling output logging, error handling, and for importing\nspecific feature ranges.
Spara sökordsargument | \nBeskrivning | \n
|---|---|
| \nMay be set with a slice or tuple of\n(begin, end) feature ID’s to map from\nthe data source. In other words, this\nkeyword enables the user to selectively\nimport a subset range of features in the\ngeographic data source. | \n
| \nWhen this keyword is set, status information\nwill be printed giving the number of features\nprocessed and successfully saved. By default,\nprogress information will be printed every 1000\nfeatures processed, however, this default may\nbe overridden by setting this keyword with an\ninteger for the desired interval. | \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
| \nStatus information will be written to this file\nhandle. Defaults to using | \n
| \nExecution of the model mapping will cease upon\nthe first error encountered. The default value\n( | \n
| \nOm den är inställd kommer information att skrivas ut efter varje modellsparning som utförs i databasen. | \n
As noted in the warning at the top of this section, Django stores all SQL\nqueries when DEBUG=True. Set DEBUG=False in your settings, and this\nshould stop excessive memory use when running LayerMapping scripts.
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")\nThen the solution is to increase the value of the max_allowed_packet\nsetting in your MySQL configuration. For example, the default value may\nbe something low like one megabyte – the setting may be modified in MySQL’s\nconfiguration file (my.cnf) in the [mysqld] section:
max_allowed_packet = 10M\n