SHP 转 KML — 工具介绍

什么是 SHP 转 KML？

SHP（Shapefile）是 GIS 领域最常用的矢量数据格式，而 KML 是 Google Earth 和各类地图应用中广泛使用的标记语言。

本工具帮助你将 Shapefile 文件转换为 KML 格式，支持**点（Point）、线（LineString）、面（Polygon）**三种几何类型。每个 SHP 文件可以自定义样式（颜色、线宽、填充色等），导出时自动打包为一个 KML 文件，便于在地图上查看和分享。

适用场景

• 将 GIS 数据导入 Google Earth 进行可视化
• 在地图上展示点、线、面等空间要素
• 批量转换多个 SHP 文件并统一管理样式
• 为不同图层设置不同颜色和样式

支持的功能

• 同时导入多个 SHP 文件
• 自动检测点、线、面类型
• 自定义每种类型的显示样式
• 为每个文件设置独立的文件夹名称
• 一键导出合并的 KML 文件

SHP 转 KML — 使用方法

操作步骤

1. 上传 SHP 文件

点击「选择文件」按钮，选择你的 .shp 文件。你可以一次选择多个文件，或分批添加。

上传后系统会自动解析 SHP 文件，检测其中包含的地理要素类型（点/线/面）。

2. 配置样式

根据检测到的要素类型，系统会展示对应的样式配置选项：

• 点（Point）：选择点的显示颜色
• 线（LineString）：选择线条颜色和线条宽度
• 面（Polygon）：选择边框颜色、填充颜色和边框线宽

3. 设置文件夹名称

每个 SHP 文件对应 KML 中的一个文件夹（Folder）。你可以自定义文件夹的名称，方便在地图应用中区分不同图层。

4. 导出 KML

点击「导出 KML 文件」按钮，系统会将所有 SHP 文件按照配置的样式打包为一个 KML 文件并自动下载。

注意事项

• 仅支持 .shp 格式的文件
• 一个 SHP 文件若包含混合类型要素，以主要类型为准
• 点要素使用 Google 图钉图标
• 面要素填充色自动应用半透明效果

SHP 转 KML — 技术说明

技术栈

• SHP 解析：直接读取 Shapefile 的二进制格式（.shp 文件），按 record 逐条解析
• KML 生成：基于 XML 模板生成符合 OGC KML 2.2 标准的文件
• 颜色处理：CSS Hex 颜色 → KML AABBGGRR 格式转换

SHP 文件格式

Shapefile 由文件头（100 字节）和若干记录组成。文件头以 Big-Endian 9994 魔数开头。

每条记录包含：

• 记录头（8 字节）：记录编号 + 内容长度
• 记录内容：Shape Type + 坐标数据

支持的 Shape Type：

• 1 — Point
• 3 — PolyLine（LineString）
• 5 — Polygon
• 13 — PolyLineZ
• 15 — PolygonZ

KML 样式映射

几何类型	KML 元素	Style 类型
Point	<Point>	<IconStyle> — 白底图钉 + 颜色叠加
LineString	<LineString>	<LineStyle> — 颜色 + 宽度
Polygon	<Polygon> + <LinearRing>	<PolyStyle> — 填充色 + <LineStyle> 边框

代码架构

• ShpToKmlGenerator.ts — KML 生成与下载
• Shp2KmlPage.vue — 用户交互 UI
• 复用 gis2excel/GisFileReader.ts 的 SHP 解析
• 复用 table2kml_point/ColorParser.ts 的颜色转换