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\nここでは、LayerMapping が、shapefile から取得した3つのジオメトリを、元の空間参照系 (WGS84) から GeoDjango モデルの空間参照系 (NAD83) に変換しました。もしレイヤーに空間参照系が定義されていない場合は、source_srs キーワードを使用し、SpatialReference オブジェクトで指定してください。
LayerMapping APILink to this heading#以下は LayerMapping オブジェクトのインスタンス生成時に使用できる引数とキーワードです。
引数 | \n説明 | \n
|---|---|
| \n地理情報モデルで、インスタンスではありません。 | \n
| \nOGR がサポートするデータソースファイル (シェープファイルなど) へのパス。 | \n
| \n辞書: キーはモデルフィールドに対応する文字列で、値はOGRフィーチャ用の文字列フィールド名に対応します。もしくは、モデルフィールドがジオグラフィックの場合は、OGRジオメトリの種類に対応する必要があります。例: | \n
キーワード引数 | \n\n |
|---|---|
| \nデータソースから使用するレイヤーのインデックス (デフォルトは 0) | \n
| \nソース SRS を手動で指定する場合に使用します (例えば、シェープファイルの中には | \n
| \nOGR データソースの文字列の文字セットエンコーディングを指定します。例えば、 | \n
| \n
| \n
| \nこれを False に設定すると、座標変換が無効になります。つまり、ジオメトリはデータソース内の元の状態から変更されずにデータベースに挿入されます。 | \n
| \n指定されたモデルの名前、または名前のタプルを設定すると、指定された名前 (複数可) のみに固有なモデルが作成されます。各フィーチャーのジオメトリは、一意のモデルに関連付けられたコレクションに追加されます。トランザクションモードを | \n
| \n空間データをインポートする際に使用するデータベースを設定します。デフォルトは | \n
save() のキーワード引数Link to this heading#save() メソッドはキーワードも受け付けます。これらのキーワードは、出力のロギングやエラー処理を制御したり、特定の機能範囲をインポートしたりするために使用します。
Save のキーワード引数 | \n説明 | \n
|---|---|
| \nデータソースからマップするフィーチャ ID のスライスまたはタプル (開始、終了) を設定できます。言い換えると、このキーワードを使用すると、地理データソース内のフィーチャのサブセット範囲を選択的にインポートできます。 | \n
| \nこのキーワードを設定すると、処理され、正常に保存されたフィーチャの数を示すステータス情報が出力されます。デフォルトでは、処理された 1000 フィーチャごとに進捗情報が表示されますが、このキーワードに希望の間隔の整数を設定することで、このデフォルトを上書きできます。 | \n
| \nデフォルトでは、致命的でないエラー通知は | \n
| \n整数で設定すると、トランザクションは各ステップの間隔で発生します。たとえば、 | \n
| \nステータス情報はこのファイルハンドルに書き込まれます。デフォルトでは | \n
| \nモデルマッピングの実行は、最初にエラーが発生した時点で停止します。デフォルト値 ( | \n
| \n設定された場合、データベース上で実行される各モデル保存の後に情報が出力されます。 | \n
このセクションの一番上の警告にあるように、 Django は DEBUG=True の場合、全ての SQL クエリを保存します。設定で DEBUG=False にすれば、 LayerMapping スクリプトを実行するときにメモリを過剰に消費しなくなるはずです。
max_allowed_packet エラーLink to this heading#LayerMapping とMySQLを使用する際に以下のエラーが発生した場合:
OperationalError: (1153, "Got a packet bigger than 'max_allowed_packet' bytes")\n解決策は、MySQLの設定である max_allowed_packet の値を増やすことです。たとえば、デフォルト値は1MBのように低い場合があります。この設定は MySQL の設定ファイル (my.cnf) の [mysqld] セクションで変更できます。
max_allowed_packet = 10M\n