简介本资源面向GIS数据处理人员与测绘工程从业者提供一套基于FME的SHP转KML完整工具方案重点解决矢量数据转换后地物名称无法同步标注的问题。包内共11个文件以FME工作流文件.fme、.fmw为核心配合SHP模板数据.shp、.shx、.dbf、.prj、.sbn、.sbx及字段要求说明图.png、日志.log与XML元数据压缩包约125KB结构紧凑、开箱即用。资源附有输入数据必含字段属性要求图示帮助使用者快速核对数据结构避免因字段缺失导致标注失败。目前已有2021人学习下载适合需要批量处理竣工图、将SHP成果转为带名称标注KML并用于地图展示的初中级用户参考可有效减少手工标注与重复调试成本。1. shp 转 kml 带名称标注为什么你导出的文件在 Google Earth 里全是无名线你手里有一份 shp 数据可能是从 ArcGIS 里刚做完的行政区划边界也可能是从 dwg 转过来的地块线甚至是从某个公开渠道下载的流域矢量。现在需要把它交给外业同事、规划部门或者甲方对方只认一个格式kml。你打开 ArcGIS Pro 的转换工具选 shp 转 kml输出发送。对方打开 Google Earth线是有了但每条线都没有名字点上去只显示一堆字段名和乱码。这就是 shp 转 kml 最典型的翻车现场——几何转过去了标注没转过去。这个问题的本质不是格式转换失败而是 shp 的属性表字段和 kml 的标注机制之间没有自动映射。shp 用 DBF 表存属性kml 用name和description标签存标注信息两者之间需要一个显式的字段指定动作。ArcGIS 的默认转换工具不会帮你做这个选择它只负责把几何和属性一股脑塞进 kml 的 description 里name 字段留空或者填一个无意义的 ID。这篇文章要解决的问题很具体把 shp 的某个字段比如“名称”“NAME”“地块编号”变成 kml 里可见的标注让每条线、每个面在 Google Earth 的侧边栏和地图上都能显示中文名称。适合两类人看一是经常用 ArcGIS 做数据交付但被标注问题反复折磨的 GIS 从业者二是需要用代码批量处理 shp 转 kml 并控制标注字段的开发者。下面从工具选型开始一路讲到批量脚本和避坑细节。2. 工具选型与字段映射ArcGIS、QGIS、GDAL 各自怎么处理名称标注2.1 ArcGIS Pro 的 shp 转 kml 工具到底把名称字段放哪了ArcGIS Pro 里做 shp 转 kml 有两个入口一是「转换工具箱」里的「图层转 KML」Layer to KML二是「地图转 KML」Map to KML。前者针对单个图层后者针对整个地图文档。很多人用错工具选了「地图转 KML」结果输出的是一个压缩的 KMZ里面包含了地图里所有图层的符号化效果但标注字段完全不受控。正确的做法是用「图层转 KML」。打开工具后关键参数是「输出文件」和「图层」。但你会发现工具面板里根本没有让你选标注字段的地方。这是因为 ArcGIS 的图层转 KML 工具依赖图层的标注属性——也就是说你必须在 ArcGIS Pro 的地图视图里先给这个图层配好标注标注字段选“名称”然后工具会把标注一起转成 kml 的name标签。具体操作步骤第一步把 shp 加载到 ArcGIS Pro 地图中。右键图层选择「属性」进入「标注」选项卡。勾选「标注此图层中的要素」标注字段选择你要作为名称的那一列比如“NAME”或“名称”。设置好字体大小和颜色确保在地图视图里能看到标注。第二步打开「图层转 KML」工具。输出文件后缀写.kmz或.kml图层选当前图层。在「输出比例」参数里如果你不确定选「使用地图比例」或者手动输入一个合适的比例尺比如 1:50000。比例尺太大会导致线简化过度太小则文件体积暴涨。第三步运行工具。输出的 kml 在 Google Earth 里打开侧边栏会显示你设置的标注字段值点击要素也会在气泡里显示名称。这里有一个血泪经验ArcGIS Pro 的图层转 KML 对中文字段的支持在部分版本里存在编码问题。如果你发现导出的 kml 里中文变成问号或乱码先把 shp 的属性表编码确认一遍。DBF 文件的默认编码是 UTF-8 还是 GBK直接影响输出。可以在 ArcGIS Pro 的「字段」视图里检查字段别名和实际值如果显示正常但导出乱码尝试在工具环境设置里把「输出坐标系」和「编码」显式指定。注意ArcGIS Pro 的图层转 KML 工具在 2.x 和 3.x 版本里对标注的处理逻辑有差异。2.x 更依赖地图标注3.x 增加了「要素标注」选项但核心逻辑不变——不配标注就没有名称。2.2 QGIS 的 shp 转 kml 为什么更适合控制名称字段QGIS 在 shp 转 kml 这件事上比 ArcGIS 直接得多。它有一个「另存为」功能可以在导出时直接指定 kml 的 name 字段和 description 字段。操作路径右键 shp 图层 → 导出 → 保存要素为 → 格式选 KML → 在「图层选项」里填写「名称字段」和「描述字段」。这个「名称字段」就是你要的答案。下拉菜单里会列出 shp 的所有属性字段选“名称”或“NAME”导出的 kml 里每个要素的name标签就是该字段的值。QGIS 还会自动处理中文编码只要你的 shp 属性表在 QGIS 里显示正常导出的 kml 基本不会乱码。QGIS 的另一个优势是支持批量导出。如果你有几十个 shp 要转可以用「处理工具箱」里的「批量保存要素为」工具一次性指定输入目录、输出目录和名称字段。但要注意批量工具里的「名称字段」参数需要每个图层单独设置不能全局统一——因为不同 shp 的字段名可能不一样。参数设置建议坐标系KML 强制使用 WGS84 地理坐标系EPSG:4326。如果你的 shp 是投影坐标系比如 CGCS2000 高斯投影QGIS 会自动重投影但建议在导出前手动确认一下。在「保存要素为」对话框里CRS 下拉选「WGS 84 (EPSG:4326)」。名称字段选那个存中文名称的列。如果该列有重复值kml 里会出现同名要素Google Earth 侧边栏会合并显示但不影响几何。描述字段可以选一个包含更多信息的字段比如“编号”或“备注”它会出现在点击要素后的气泡里。QGIS 导出的 kml 文件体积通常比 ArcGIS 小因为它不做额外的符号化渲染。如果你只需要几何和名称QGIS 是更干净的选择。2.3 GDAL ogr2ogr 命令行转 kml 并指定名称字段的完整参数如果你需要把 shp 转 kml 集成到自动化流程里GDAL 的 ogr2ogr 是最可控的工具。它没有图形界面所有参数都在命令行里适合批量处理和脚本调用。基本命令ogr2ogr -f KML output.kml input.shp -dsco NameField名称这条命令的意思是把 input.shp 转成 output.kml格式为 KML并且指定 KML 数据源创建选项DSCO里的 NameField 为“名称”字段。-dsco是 dataset creation option 的缩写NameField 是 KML 驱动特有的选项告诉 GDAL 用哪个字段作为name标签的值。如果你还需要把其他字段放进 description可以加-dsco DescriptionField备注。完整命令ogr2ogr -f KML output.kml input.shp \ -dsco NameField名称 \ -dsco DescriptionField备注 \ -t_srs EPSG:4326-t_srs EPSG:4326是强制重投影到 WGS84因为 KML 只认这个坐标系。如果你的 shp 已经是 WGS84可以省略但加上更保险。GDAL 处理中文编码的坑比较多。如果 shp 的 DBF 文件是 GBK 编码而你的系统默认是 UTF-8ogr2ogr 读出来的中文可能是乱码。解决办法是在命令前设置环境变量export SHAPE_ENCODINGGBK ogr2ogr -f KML output.kml input.shp -dsco NameField名称或者在 Windows 命令行里set SHAPE_ENCODINGGBK ogr2ogr -f KML output.kml input.shp -dsco NameField名称SHAPE_ENCODING是 GDAL 用来指定 shp 属性表编码的环境变量。GBK 和 UTF-8 是最常见的两种如果不确定可以用ogrinfo -al input.shp先看一下属性值是否正常显示。提示GDAL 3.x 版本对 KML 驱动的 NameField 支持更稳定。如果你用的是 2.x建议升级到 3.0 以上否则某些字段名带空格或特殊字符时会报错。3. 批量转换与名称标注的代码实现Python 脚本和字段处理3.1 用 geopandas 批量读 shp 并写出带名称的 kmlgeopandas 本身不直接支持 KML 写出但可以通过 fiona 驱动或者先转成 GeoJSON 再调 GDAL。更直接的方式是用geopandas读 shp然后用ogr2ogr的子进程调用或者用fiona写 KML。但 fiona 对 KML 的写支持有限最稳的还是用osgeo.ogr或者直接调 GDAL 命令行。下面这个脚本用geopandas读 shp检查名称字段是否存在然后调ogr2ogr批量转换。适合有几十个 shp 需要统一处理的场景。import os import subprocess import geopandas as gpd # 输入输出目录 input_dir ./shp_data output_dir ./kml_output os.makedirs(output_dir, exist_okTrue) # 名称字段的候选列表按优先级排列 name_field_candidates [名称, NAME, Name, 地块编号, 行政区] for filename in os.listdir(input_dir): if not filename.endswith(.shp): continue shp_path os.path.join(input_dir, filename) kml_name os.path.splitext(filename)[0] .kml kml_path os.path.join(output_dir, kml_name) # 读取 shp 查看字段 gdf gpd.read_file(shp_path, encodingGBK) columns gdf.columns.tolist() # 找到第一个存在的名称字段 name_field None for candidate in name_field_candidates: if candidate in columns: name_field candidate break if name_field is None: print(f跳过 {filename}未找到名称字段现有字段 {columns}) continue # 调 ogr2ogr 转换 cmd [ ogr2ogr, -f, KML, kml_path, shp_path, -dsco, fNameField{name_field}, -t_srs, EPSG:4326 ] # 设置编码环境变量 env os.environ.copy() env[SHAPE_ENCODING] GBK result subprocess.run(cmd, envenv, capture_outputTrue, textTrue) if result.returncode 0: print(f成功{filename} - {kml_name}名称字段{name_field}) else: print(f失败{filename}错误{result.stderr})这段代码的逻辑分三步先遍历输入目录里所有 shp 文件然后用 geopandas 读属性表按候选列表找名称字段最后拼 ogr2ogr 命令并执行。关键参数是-dsco NameField它决定了 kml 里name标签用哪一列。SHAPE_ENCODINGGBK是应对中文 shp 的编码问题如果你的数据是 UTF-8改成 UTF-8 或者删掉这行。name_field_candidates列表可以根据你的实际数据调整。有些 shp 的名称字段叫“XZQMC”行政区名称有些叫“DLMC”地类名称把常见的都加进去脚本会自动匹配。3.2 名称字段有重复值或空值时怎么处理实际数据里名称字段很少是完美的。常见问题有三个重复值、空值、特殊字符。重复值在 kml 里不会导致转换失败但 Google Earth 侧边栏会把同名要素折叠在一起。如果你希望每个要素独立显示可以在名称后面拼一个唯一 ID。修改脚本里的 NameField 处理逻辑# 在 gdf 里新建一个临时字段拼上索引 gdf[_kml_name] gdf[name_field].fillna(未命名) _ gdf.index.astype(str) # 把临时字段写回 shp 或者直接传给 ogr2ogr但这样需要先写一个临时 shp多一步 IO。更简单的方式是在 ogr2ogr 里用 SQL 表达式但 KML 驱动的 NameField 不支持表达式。所以如果重复值问题严重建议先用 geopandas 处理字段写一个临时文件再转。空值的处理更直接fillna(未命名)把空值替换成占位符。如果不处理kml 里name标签会是空字符串Google Earth 侧边栏显示为空白条目用户不知道那是什么。特殊字符主要是、、这三个它们在 XML 里有特殊含义。GDAL 的 KML 驱动会自动转义但如果你用其他工具生成 kml需要手动处理。比如名称是“AB地块”kml 里应该写成Aamp;B地块。GDAL 会自动做这个转义不用操心。3.3 用 ArcPy 在 ArcGIS 环境里批量导出带标注的 kml如果你的工作环境是 ArcGIS Pro并且已经买了 ArcPy 的许可可以用 ArcPy 调LayerToKML工具批量转换。这个方案的好处是不用离开 ArcGIS 生态坏处是必须先在地图里配好标注。import arcpy import os arcpy.env.overwriteOutput True input_folder rC:\data\shp output_folder rC:\data\kml os.makedirs(output_folder, exist_okTrue) # 创建一个临时地图文档 aprx arcpy.mp.ArcGISProject(CURRENT) map_obj aprx.listMaps()[0] for shp_file in os.listdir(input_folder): if not shp_file.endswith(.shp): continue shp_path os.path.join(input_folder, shp_file) kml_name os.path.splitext(shp_file)[0] .kmz kml_path os.path.join(output_folder, kml_name) # 添加到地图 layer map_obj.addDataFromPath(shp_path) # 设置标注字段 sym layer.symbology if hasattr(sym, renderer): # 这里需要根据实际图层类型调整 pass # 调 LayerToKML arcpy.conversion.LayerToKML(layer, kml_path) # 移除图层避免地图越来越卡 map_obj.removeLayer(layer) print(f导出{kml_name})这段代码的核心是arcpy.conversion.LayerToKML。但注意它依赖图层的标注属性。在 ArcPy 里设置标注字段比较绕需要操作layer.showLabels True和layer.labelClasses[0].expression。不同版本的 ArcPy 对标注的 API 不一样2.x 和 3.x 差异较大。如果你只是偶尔转几个文件手动在 ArcGIS Pro 里操作更快。批量场景下建议还是用 GDAL 方案不依赖 ArcGIS 许可跨平台也更方便。注意ArcPy 的 LayerToKML 输出的 KMZ 是压缩格式Google Earth 能直接打开。如果你需要未压缩的 KML把后缀改成 .kml 后手动解压或者用 GDAL 方案。4. 避坑与排查shp 转 kml 名称标注的 5 个常见翻车点4.1 现象Google Earth 侧边栏显示乱码中文变成问号原因shp 的 DBF 文件编码和转换工具读取时使用的编码不一致。DBF 常见编码有 GBK、UTF-8、Latin1。ArcGIS 默认按系统区域设置读中文 Windows 是 GBKQGIS 和 GDAL 默认按 UTF-8 读。如果 DBF 是 GBK 而工具按 UTF-8 读中文就乱了。解决先确认 DBF 编码。用 QGIS 打开 shp看属性表中文是否正常。如果 QGIS 正常而 GDAL 乱码在 ogr2ogr 命令前设SHAPE_ENCODINGGBK。如果 QGIS 也乱码说明 DBF 本身编码有问题用 QGIS 的「导出」功能重新保存一份 UTF-8 的 shp再转 kml。4.2 现象kml 里所有要素的 name 都是同一个值原因NameField 指定的字段在 shp 里是常量字段或者 ogr2ogr 的-dsco NameField参数写错了字段名。字段名大小写敏感NameFieldname和NameFieldNAME可能指向不同字段。解决先用ogrinfo -al input.shp查看字段列表确认字段名拼写。然后在命令里用完全匹配的字段名。如果字段名带空格用引号包起来-dsco NameField地块 名称。4.3 现象转换后的 kml 在 Google Earth 里线简化严重形状变形原因ArcGIS 的 LayerToKML 工具有一个「输出比例」参数默认值可能过大导致线被简化。GDAL 的 ogr2ogr 默认不做简化但如果 shp 本身节点就少kml 里也会显得粗糙。解决ArcGIS 里把输出比例调到 1:10000 或更小。GDAL 方案里检查 shp 的节点密度如果太稀疏先用 QGIS 的「密度化」工具加密节点再转 kml。KML 对节点数量没有硬限制但 Google Earth 渲染超过 10 万个节点的线会卡。4.4 现象面要素转 kml 后名称标注显示在面的中心但位置偏移原因KML 的name标签本身不控制标注位置Google Earth 自动把名称放在几何的质心。如果面形状不规则质心可能落在面外标注看起来就偏了。解决这是 Google Earth 的渲染逻辑无法通过 kml 标签直接控制。变通方法是在 shp 里加一个点图层每个面生成一个内部点QGIS 的「多边形内部点」工具把名称字段挂到点上然后把面和点一起转 kml。点要素的名称标注会精确显示在点位置。4.5 现象批量转换时部分文件报错「字段不存在」原因不同 shp 的名称字段名不一样脚本里写死了“名称”遇到字段叫“NAME”的文件就失败。解决用第 3 章脚本里的name_field_candidates列表做候选匹配。如果候选列表也覆盖不了先跑一个字段统计脚本把所有 shp 的字段名收集起来再手动映射。或者用ogrinfo批量输出字段列表生成一个映射表脚本读映射表决定每个文件用哪个字段。5. 进阶技巧用 pykml 手工构造带样式和名称的 kmlGDAL 和 ArcGIS 的方案能解决 90% 的 shp 转 kml 需求但如果你需要控制 kml 的样式——比如不同地块用不同颜色、名称标注带背景框、点击气泡里显示表格——就需要手工构造 kml。Python 的pykml库可以让你像写 XML 一样写 kml同时用 geopandas 读 shp 的几何和属性。安装 pykmlpip install pykml下面是一个完整示例读 shp为每个要素生成带名称和颜色的 Placemarkimport geopandas as gpd from pykml.factory import KML_ElementMaker as KML from lxml import etree from pykml import parser gdf gpd.read_file(input.shp, encodingGBK) gdf gdf.to_crs(epsg4326) # 创建 KML 根节点 kml_doc KML.kml( KML.Document( KML.name(地块数据), ) ) # 颜色映射根据某个字段值分配颜色 color_map { 住宅: ff0000ff, # 红色 商业: ffff0000, # 蓝色 工业: ff00ff00, # 绿色 } for idx, row in gdf.iterrows(): name row.get(名称, f要素{idx}) category row.get(类别, 其他) color color_map.get(category, ff888888) # 构造几何 geom row.geometry if geom.geom_type Polygon: coords list(geom.exterior.coords) coord_str .join([f{x},{y} for x, y in coords]) geometry KML.Polygon( KML.outerBoundaryIs( KML.LinearRing( KML.coordinates(coord_str) ) ) ) elif geom.geom_type LineString: coords list(geom.coords) coord_str .join([f{x},{y} for x, y in coords]) geometry KML.LineString( KML.coordinates(coord_str) ) else: continue # 构造 Placemark placemark KML.Placemark( KML.name(name), KML.description(f类别{category}), KML.Style( KML.LineStyle( KML.color(color), KML.width(2) ), KML.PolyStyle( KML.color(color) ) ), geometry ) kml_doc.Document.append(placemark) # 写出文件 with open(output.kml, wb) as f: f.write(etree.tostring(kml_doc, pretty_printTrue, xml_declarationTrue, encodingUTF-8))这段代码的核心逻辑用 geopandas 读 shp 并重投影到 WGS84然后遍历每一行根据几何类型构造 KML 的 Polygon 或 LineString把名称字段写入KML.name()把类别字段映射成颜色写入KML.Style()。最后用 lxml 序列化写出。关键参数说明color的格式是aabbggrr前两位是透明度ff 不透明后面是蓝、绿、红。比如红色是ff0000ff蓝色是ffff0000。这个格式和常见的 RGB 顺序相反容易写错。KML.name()里的文本就是 Google Earth 侧边栏显示的标注。如果名称太长Google Earth 会自动截断鼠标悬停显示完整。KML.description()支持 HTML可以写表格。比如KML.description(![CDATA[tabletrtd类别/tdtd住宅/td/tr/table]])这样点击要素后气泡里显示一个表格。pykml 方案的优势是完全可控名称、颜色、线宽、气泡内容、文件夹分组都能按需定制。缺点是代码量大适合有编程基础并且对 kml 样式有明确要求的人。如果你只是要名称标注GDAL 的-dsco NameField一行命令就够了。我自己的习惯是日常交付用 GDAL 命令行快速且稳定需要给甲方做演示或者出图级别的 kml才用 pykml 手工构造样式。两种方案都跑过几十个项目GDAL 翻车最多的地方是编码pykml 翻车最多的地方是颜色格式写反。记住aabbggrr这个顺序能省不少调试时间。希望帮到你。本文还有配套的精品资源点击获取