ArcGIS SHP转KMZ标注丢失问题：原理分析与Python解决方案

1次阅读

没有评论

共计 2020 个字符，预计需要花费 6 分钟才能阅读完成。

最近在将 ArcGIS 的 SHP 数据转换为 KMZ 格式时，发现转换后的文件在 Google Earth 中打开时，原本在 ArcMap 中设置好的标注（Labels）全部消失了。具体表现为：

属性字段（Attribute Fields）未正确继承到 KML 中
符号系统（Symbol System）完全失效
标注位置（Label Placement）发生偏移

这个问题在 GIS 数据迁移和共享中非常常见，特别是需要将数据提供给非 GIS 专业人员查看时。

SHP 文件 的标注信息存储方式：
存储在 Layer Properties 的 Labeling 选项卡中
标注表达式（Label Expression）可以包含多个字段的组合
标注位置是基于要素几何（Feature Geometry）动态计算的
KMZ/KML的标注实现方式：
通过 <name> 节点存储主要标注
附加标注需要通过 <ExtendedData> 节点存储
样式（Style）和标注（Label）是分离的
标注位置是静态的，不会随视图变化而调整

ArcGIS Pro 转换工具：
默认只转换几何和基础属性
标注设置需要显式指定才会保留
符号系统转换时使用近似替代
QGIS 转换工具：
提供更多 KML 导出选项
可以保留更多样式信息
但标注位置计算方式不同

import arcpy
import os
import logging

# 配置日志
logging.basicConfig(filename='shp2kmz.log', level=logging.INFO)

try:
    # 输入参数
    input_shp = r"C:\data\points.shp"
    output_kmz = r"C:\output\points.kmz"
    label_field = "NAME"  # 指定用于标注的字段

    # 创建临时图层并设置标注
    lyr = arcpy.MakeFeatureLayer_management(input_shp, "temp_layer")
    arcpy.management.AddField(lyr, "kml_label", "TEXT")
    arcpy.management.CalculateField(lyr, "kml_label", f"!{label_field}!", "PYTHON3")

    # 设置图层属性（关键步骤）lyr_obj = arcpy.mapping.Layer(lyr)
    lyr_obj.showLabels = True
    lyr_obj.labelClasses[0].expression = "[kml_label]"

    # 转换为 KML
    arcpy.LayerToKML_conversion(
        lyr_obj, 
        output_kmz,
        layer_output_scale=1,
        is_composite=True,
        boundary_box_extent="DEFAULT",
        image_size=2048,
        dpi_of_client=96,
        ignore_zvalue=True
    )

    logging.info(f"成功导出 KMZ 文件: {output_kmz}")

except Exception as e:
    logging.error(f"转换失败: {str(e)}")
    raise

# 需要先安装 GDAL 完整版
ogr2ogr -f "KML" output.kml input.shp \
  --config KML_DISPLAY_NAME "NAME" \
  --config KML_DESCRIPTION "DESCRIPTION_FIELD" \
  -dsco NameField=kml_label \
  -dsco DescriptionField=desc_field

# 然后手动打包为 KMZ
zip -r output.kmz output.kml doc.kml styles