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

1次阅读

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

最近在项目中使用 ArcGIS 将 SHP 数据转为 KMZ 格式时，遇到了一个头疼的问题：转换后的 KMZ 文件在 Google Earth 中能正常显示图形要素，但所有标注都不见了。经过一番折腾，终于搞清楚了其中的原理和解决方法，今天就来分享一下完整的解决思路。

当我们将 SHP 文件通过 ArcGIS 转换为 KMZ 格式后，在 Google Earth 中打开时，经常遇到以下情况：

所有地理要素（点、线、面）都能正常显示
但原本在 SHP 文件中设置的标注（如地名、编号等）完全不见踪影
在 ArcGIS 中预览时标注显示正常，但导出后就是看不到

这个问题困扰了不少 GIS 开发者，我也是踩了这个坑后才开始深入研究。

要理解这个问题，我们需要先了解两种格式处理标注的根本差异：

Shapefile 的标注存储方式
SHP 文件本身不直接存储标注信息
标注是通过属性表中的字段动态生成的
ArcGIS 在显示时才实时渲染这些标注
KMZ/KML 的标注机制
KMZ 要求标注必须显式定义在标签中
需要将标注信息转换为 KML 的文本元素
默认转换过程不会自动处理这种映射关系
ArcGIS 转换时的关键环节
标注类 (Annotation Classes) 是否被正确识别
字段映射是否完整保留
坐标系转换是否导致标注位置偏移

对于不太熟悉编程的用户，可以通过 ArcGIS Pro 的界面操作来解决：

打开 ArcGIS Pro，加载你的 SHP 文件
右键点击图层 → 属性 → 标注选项卡
确保标注字段选择正确并启用标注
导出时选择 ” 图层转 KML” 工具
关键步骤：在工具参数中勾选 ” 保留标注 ” 选项
设置输出坐标系为 WGS84（KMZ 的默认要求）
执行转换并检查结果

注意：一定要在导出前在 ArcGIS 中确认标注显示正常，这是后续步骤的基础。

对于需要批量处理的情况，推荐使用 ArcPy 脚本。下面是完整的解决方案：

import arcpy
from arcpy import env

# 设置工作空间
env.workspace = "C:/data"

# 输入 SHP 文件和输出 KMZ 路径
input_shp = "points.shp"
output_kmz = "output.kmz"

# 关键步骤 1：确保标注属性正确
arcpy.ConvertLabelsToAnnotation_cartography(
    in_map_document="CURRENT",
    out_geodatabase="memory",
    anno_features="temp_anno"
)

# 关键步骤 2：设置字段映射
field_mapping = "\"NAME\"\"NAME\"true true false 255 Text 0 0,First,#," + \
               input_shp + ",NAME,-1,-1"

# 关键步骤 3：执行转换
arcpy.LayerToKML_conversion(
    layer_file=input_shp,
    out_kmz_file=output_kmz,
    layer_output_scale=1,
    is_composite=False,
    boundary_box_extent="DEFAULT",
    image_size=2048,
    dpi_of_client=96,
    include_attributes=True,
    include_labels=True  # 最关键参数！)

print("转换完成！")

脚本中的几个关键点：