← 精品代码功能 · 可复用实现库

精品功能 02：多格式地理数据解析（文本 / GeoJSON / GPX / KML）

• 出处：wechat-map-tools/miniprogram/utils/parse.js（379 行）
• 一句话：在小程序里（没有 DOM、没有 DOMParser）解析四种常见地理数据格式。
• 解决什么问题：用户从各处拿到的轨迹数据格式五花八门，要统一成

{ points: [...], tracks: [...], errors: [...] } 才能用。

核心实现

XML 用正则解析，但要同时支持成对标签和自闭合标签（第 25-33 行）：

/** 扫描同名标签，支持 <tag ...>...</tag> 和 <tag ... /> */
function eachTag(xml, tag, cb) {
  const re = new RegExp('<' + tag + '\\b([^>]*)>([\\s\\S]*?)</' + tag + '>|<' + tag + '\\b([^>]*)/>', 'g');
  let m;
  while ((m = re.exec(xml))) {
    const isPair = m[1] !== undefined;
    cb(attrsOf(isPair ? m[1] : (m[3] || '')), isPair ? m[2] : '');
  }
}

坐标文本容错解析（第 80-119 行）——这是最能体现"面向真实用户输入"的一段：

/**
 * 逐行解析，容错优先：
 *   116.39,39.9            （经度在前，默认）
 *   39.9 116.39            （纬度在前，自动识别）
 *   天安门 116.39,39.9     （前后多余的文字当名称）
 *   # 开头的行跳过
 * 两个值都在 ±90 内时无法自动判断（比如新疆 75.99,39.47），
 * 靠 options.latFirst 决定，UI 上给个开关。
 */

实现要点：按多种分隔符切分（/[\s,，;；\t|/]+/）、
用数值范围自动判断经纬顺序、无法判断时交给 UI 开关、
非法行记进 errors 而不是抛异常。

格式识别很简单（第 59-66 行）：首字符 {/[ → GeoJSON，
含 <gpx → GPX，含 <kml → KML，否则纯文本。

设计亮点

1. 无 DOM 依赖：正则代替 DOMParser，才能在 Node 里测试、在无浏览器环境运行
2. 容错优先，不抛异常：非法行进 errors 数组，合法行照常解析——永远给用户部分结果
3. 兼容真实世界的脏数据：中文逗号、# 注释、自闭合标签、实体转义
4. 无法判断时给开关：技术上做不到 100% 自动，就把决定权交给用户（latFirst）
5. 统一出口 parseAny()：调用方不用管格式

可复用性评估

• 依赖：零（纯函数 + 正则），可整文件复制
• 移植难度：低（换语言重写正则即可；正则逻辑通用）
• 测试：坐标文本 9 项、GeoJSON 6 项、GPX 7 项、KML 3 项（node tests/test-core.js）

开源化建议

• 与功能 01 合并成 geo-tools 发布
• README 列"支持格式矩阵"（哪些标签/几何类型支持）
• 已知限制要写明：正则解析不保证符合 XML 规范的边缘情况（注释里也承认了）

对照开源

• 浏览器环境可以用 DOMParser 解析 GPX/KML（更规范，但依赖 DOM）
• @tmcw/togeojson 是专门做"KML/GPX → GeoJSON"的库，功能更全
• 你的价值：零依赖 + 小程序环境可用 + 容错设计

相关课程

第 18 课（纯函数与脱离平台测试）