gcoord - 中国地图坐标系转换

---

name: gcoord description: Use when converting coordinates between WGS84, GCJ02, BD09, BD09MC, or WebMercator coordinate systems for Chinese map services (Baidu, Amap, Google China, etc.)

---

Gcoord - 地理坐标系转换

Overview

处理中国互联网地图坐标系不统一的问题，支持 WGS84/GCJ02/BD09/BD09MC/WebMercator 等坐标系之间的精确转换。

When to Use

digraph gcoord_flow {
    "Need to convert coordinates?" [shape=diamond];
    "Using Chinese map service?" [shape=diamond];
    "Use this skill" [shape=box];
    "Use standard tools" [shape=box];
    "Need to convert coordinates?" -> "Using Chinese map service?" [label="yes"];
    "Using Chinese map service?" -> "Use this skill" [label="yes"];
    "Using Chinese map service?" -> "Use standard tools" [label="no"];
}

Use when:

GPS 坐标需要显示在高德/百度/腾讯地图上

从一个地图平台切换到另一个平台

统一不同来源的坐标数据

处理 GeoJSON 或批量坐标数据

Coordinate Systems Reference

| 代码 | 中文名称 | 别名 | 适用平台 | |------|----------|------|----------| | WGS84 | 地球坐标系 | GPS, wgs84, 地球坐标 | GPS 设备原始坐标 | | GCJ02 | 火星坐标系 | 高德, amap, 腾讯, gcj02, 火星坐标 | 高德地图、腾讯地图 | | BD09 | 百度坐标系 | 百度, baidu, bd09 | 百度地图 | | BD09MC | 百度米制坐标 | bd09mc, 百度米制 | 百度地图米制 | | WebMercator | 墨卡托投影 | 墨卡托, webmercator, epsg3857 | Web 地图投影 |

Supported Input/Output Formats

| 格式 | 示例 | 说明 | |------|------|------| | 坐标数组 | [116.403988, 39.914266] | JSON 数组格式 | | 单点坐标 | 116.403988, 39.914266 | 逗号或空格分隔 | | GeoJSON | { "type": "Point", "coordinates": [...] } | 完整 GeoJSON 对象 | | 批量文本 | 每行一个坐标 | 多行文本处理 |

输出格式默认与输入格式相同。

Usage Examples

Command Format

/gcoord [坐标] --from [源坐标系] --to [目标坐标系]
示例
/gcoord 116.403988,39.914266 --from wgs84 --to bd09
/gcoord [116.403988, 39.914266] from gps to 百度

Natural Language Format

"帮我把这个坐标转换成高德坐标系"
"GPS 坐标转百度地图"
"WGS84 转 GCJ02"

Interactive Examples

# Missing parameters - Claude will prompt
"帮我转换坐标 116.403988,39.914266"
→ Claude prompts for source and target coordinate systems
Clear target from context
"把 116.403988,39.914266 在百度地图上显示"
→ Claude only asks for source (target is clearly BD09)
Explicit parameters - no prompts
/gcoord 116.403988,39.914266 --from WGS84 --to BD09
→ Direct conversion, no questions asked

Interactive Parameter Selection

When to Ask User

在使用 AskUserQuestion 工具前，先尝试从用户输入中推断坐标系。只有在无法推断时才询问：

优先级判断: 1. 命令行参数明确指定 (--from, --to) 2. 自然语言中明确提及 (GPS、高德、百度、WGS84、GCJ02 等) 3. 上下文推断 (文件名如 *-gcj02.geojson、前文对话) 4. 无法推断 → 使用 AskUserQuestion

Question Format

当需要询问坐标系时，使用以下格式：

源坐标系询问:

AskUserQuestion({
  questions: [{
    question: "请选择源坐标系（您当前的坐标使用什么坐标系？）",
    header: "源坐标系",
    multiSelect: false,
    options: [
      {
        label: "WGS84 (GPS)",
        description: "GPS 设备原始坐标，地球坐标"
      },
      {
        label: "GCJ02 (高德/腾讯)",
        description: "高德地图、腾讯地图坐标系"
      },
      {
        label: "BD09 (百度)",
        description: "百度地图坐标系"
      },
      {
        label: "BD09MC (百度米制)",
        description: "百度地图米制坐标"
      },
      {
        label: "WebMercator (墨卡托)",
        description: "Web 地图投影坐标"
      }
    ]
  }]
})

目标坐标系询问:

使用相同的选项

修改 question 为 "请选择目标坐标系（您要转换到哪个坐标系？）"

header 改为 "目标坐标系"

Natural Language Recognition Patterns

在询问前，检查用户是否通过自然语言指定了坐标系：

源坐标系关键词:

"GPS坐标", "WGS84", "地球坐标", "原始坐标" → WGS84

"高德", "腾讯", "火星坐标", "gcj02" → GCJ02

"百度", "baidu", "bd09" → BD09

"墨卡托", "Web Mercator" → WebMercator

目标坐标系关键词:

"转成高德", "在高德地图显示", "for Amap" → GCJ02

"转成百度", "在百度地图显示", "for Baidu" → BD09

"转成GPS", "转成WGS84", "to WGS84" → WGS84

Interaction Examples

场景 1: 完全未指定

用户: 帮我转换 116.403988,39.914266
Claude:
1. 无法从输入推断源和目标坐标系
2. 询问源坐标系 → 用户选择: WGS84
3. 询问目标坐标系 → 用户选择: GCJ02
4. 调用: node index.js --input "116.403988,39.914266" --from WGS84 --to GCJ02

场景 2: 仅指定目标

用户: 把 116.403988,39.914266 在百度地图上显示
Claude:
1. 从上下文推断: 目标 = BD09 (明确)
2. 源坐标系不明确 → 询问用户
3. 用户选择: WGS84
4. 调用: node index.js --input "116.403988,39.914266" --from WGS84 --to BD09

场景 3: 明确指定（不询问）

用户: GPS转高德: 116.403988,39.914266
Claude:
1. 从自然语言识别: 源=WGS84, 目标=GCJ02
2. 直接调用: node index.js --input "116.403988,39.914266" --from WGS84 --to GCJ02

Implementation

对于精确转换，使用 index.js 脚本调用 gcoord 库：

node index.js --input "[116.403988, 39.914266]" --from WGS84 --to BD09

Common Mistakes

| 错误 | 正确做法 | |------|----------| | GPS 坐标直接放百度地图 | 先转为 BD09 坐标系 | | 混淆经度纬度顺序 | 始终是 [经度, 纬度] | | 忘记 GeoJSON 是原地修改 | 转换后原始对象会改变 |

Legal Notice

使用时请遵守《中华人民共和国测绘法》和 GB 20263―2006 标准。