LayerMapping 是一个数据导入实用程序Link to this heading#LayerMapping 类提供了一种将矢量空间数据文件（例如 shapefile）的内容映射到 GeoDjango 模型的方法。
这个实用程序是为了消除重复的代码，用于从矢量图层中提取几何和字段，将其转换为另一个坐标系统（例如 WGS84），然后插入到 GeoDjango 模型中而产生的。
\n\n\n您需要一个受 GDAL 支持的数据源，比如一个 shapefile（这里我们使用一个简单的多边形 shapefile，名为 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\n使用 LayerMapping 提取所有要素并将它们放入数据库中：
>>> 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 的三个几何图形从其原始空间参考系统（WGS84）转换为 GeoDjango 模型的空间参考系统（NAD83）。如果未为图层定义空间参考系统，请使用 source_srs 关键字并提供一个 SpatialReference 对象来指定一个。
LayerMapping APILink to this heading#以下是在实例化 LayerMapping 对象期间可以使用的参数和关键字：
参数 | \n描述 | \n
|---|---|
| \n地理模型，不是 实例 | \n
| \nOGR 支持的数据源文件的路径（例如，shapefile）。也接受 | \n
| \n一个字典：键是与模型字段对应的字符串，值对应于 OGR 要素的字符串字段名称，或者如果模型字段是地理字段，则应该对应于 OGR 几何类型，例如 | \n
关键字参数 | \n\n |
|---|---|
| \n要使用的数据源中的图层的索引（默认为0）。 | \n
| \n使用这个参数可以手动指定源空间参考系统（例如，一些 shapefile 文件不包含 | \n
| \n指定 OGR 数据源中字符串的字符集编码。例如， | \n
| \n可以是 | \n
| \n将其设置为 False 将禁用坐标转换。换句话说，几何图形将以其在数据源中的原始状态未经修改地插入到数据库中。 | \n
| \n将其设置为给定模型的名称或名称元组将创建仅与给定名称唯一的模型。每个要素的几何图形将添加到与唯一模型关联的集合中。强制事务模式为 | \n
| \n在导入空间数据时设置要使用的数据库。默认为 | \n
save() 关键字参数Link to this heading#save() 方法还接受关键字。这些关键字用于控制输出日志、错误处理和导入特定要素范围。
保存关键字参数 | \n描述 | \n
|---|---|
| \n可以设置为要从数据源中映射的（begin, end）要素 ID 的切片或元组。换句话说，这个关键字允许用户有选择地导入地理数据源中的子集范围内的要素。 | \n
| \n当设置了这个关键字时，将打印状态信息，显示已处理和成功保存的要素数量。默认情况下，将在处理每 1000 个要素时打印进度信息，但可以通过将这个关键字设置为所需间隔的整数来覆盖默认值。 | \n
| \n默认情况下，非致命错误通知将打印到 | \n
| \n如果设置为整数，事务将在每个步骤间隔之后发生。例如，如果 | \n
| \n状态信息将被写入到这个文件句柄。默认使用 | \n
| \n在遇到第一个错误时，模型映射的执行将停止。默认值（ | \n
| \n如果设置，将在执行数据库上的每个模型保存后打印信息。 | \n
如本节顶部的警告所述，当 DEBUG=True 时，Django 会存储所有的 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 设置的值。例如，默认值可能很低，比如一兆字节 —— 可以在 MySQL 的配置文件（my.cnf）中的 [mysqld] 部分修改该设置：
max_allowed_packet = 10M\n