LayerMapping データインポートユーティリティLink to this heading#LayerMapping クラスは、ベクトル空間データファイル (例: shapefile) の内容を GeoDjango モデルにマッピングする方法を提供します。
このユーティリティは、ベクターレイヤーからジオメトリとフィールドを取り出し、別の座標系 (WGS84など) に変換し、GeoDjango モデルに挿入するまでのコードの繰り返しをなくしたいという作者の個人的なニーズから生まれました。
\n\n\nシェープファイルのような、GDALがサポートするデータソースが必要です (ここでは、3つのフィーチャを持つ単純なポリゴンシェープファイル、 test_poly.shp を使用しています):
>>> 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]]\nここで、対応する Django モデルを定義します (必ず 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\nLayerMapping を使用して、すべてのフィーチャを抽出し、データベースに配置します。
>>> 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#以下は LayerMapping オブジェクトのインスタンス生成時に使用できる引数とキーワードです。
引数 | \n説明 | \n
|---|---|
| \n地理情報モデルで、インスタンスではありません。 | \n
| \nThe path to the OGR-supported data source file\n(e.g., a shapefile). Also accepts\n | \n
| \n辞書: キーはモデルフィールドに対応する文字列で、値はOGRフィーチャ用の文字列フィールド名に対応します。もしくは、モデルフィールドがジオグラフィックの場合は、OGRジオメトリの種類に対応する必要があります。例: | \n
キーワード引数 | \n\n |
|---|---|
| \nデータソースから使用するレイヤーのインデックス (デフォルトは 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
| \n
| \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
| \n空間データをインポートする際に使用するデータベースを設定します。デフォルトは | \n
save() のキーワード引数Link 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.
Save のキーワード引数 | \n説明 | \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
| \nデフォルトでは、致命的でないエラー通知は | \n
| \n整数で設定すると、トランザクションは各ステップの間隔で発生します。たとえば、 | \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
| \n設定された場合、データベース上で実行される各モデル保存の後に情報が出力されます。 | \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 エラーLink to this heading#LayerMapping と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