# 坐标系转换指南总目录（apiCode=1252）
> 免费 · 支持 WGS84 / GCJ02（火星坐标系）/ BD09（百度坐标系）三者互相转换，并支持两点直线距离计算 · 官方自营：昆明秀派科技有限公司 · 阅读时间：约 3 分钟（本页为目录）
## 接口一句话速览
**坐标系转换**（apiCode=1252）是 ShowAPI 官方自营的免费接口，提供 2 个接入点：
1. **坐标系转换（接入点 1）**：把 GPS/Google 的 WGS84、腾讯高德的 GCJ02、百度的 BD09 三者互相转换，单次最多 20 个点。
2. **两点直线距离（接入点 2）**：基于两个经纬度坐标返回直线距离（米）。
适用于地理信息、导航、地图展示、轨迹、配送范围等几乎所有与"位置"相关的场景。本系列共 12 篇指南，从 5 分钟上手到避坑、集成、可视化全覆盖。
## 全部文章（按阅读顺序）
### 入门层
1. [坐标系转换：5 分钟接入，从第一条 WGS84→GCJ02 结果开始](https://www.showapi.com/guides/coord-convert-quickstart-1252) — 注册、拿 AppKey、首次调用、解析返回。
2. [坐标系转换：返回结构与 ret_code 全解（含批量 resultList 字段）](https://www.showapi.com/guides/coord-convert-response-1252) — `showapi_res_body`、数组字段、ret_code 含义。
### 场景实战层
3. [高德/腾讯/百度/Google 地图坐标互通：坐标系转换在地图集成中的全链路设计](https://www.showapi.com/guides/coord-convert-map-platform-1252) — 四类地图对应坐标系与端到端集成。
4. [坐标系转换（批量）：一次性转换最多 20 个 GPS 点位](https://www.showapi.com/guides/coord-convert-batch-1252) — `;` 分批、指数退避重试。
5. [两点直线距离：如何计算两坐标间的真实公里数？](https://www.showapi.com/guides/coord-convert-distance-1252) — 接入点 2 用法与"必须同系"的坑。
6. [Python 实战：把一份 CSV 里的 GPS 经纬度批量转成高德坐标](https://www.showapi.com/guides/coord-convert-csv-1252) — 读 CSV → 分批转 → 写回新列。
### 技术深挖层
7. [WGS84 / GCJ02（火星坐标）/ BD09 到底是什么？为什么必须转换？](https://www.showapi.com/guides/coord-convert-concepts-1252) — 三种坐标系来源与偏移原理。
8. [坐标系转换避坑：点位偏移 500 米、距离算错、坐标系混用](https://www.showapi.com/guides/coord-convert-pitfalls-1252) — 4 类常见误用 + 修正代码。
### 生态集成层
9. [通过 MCP 在 AI 客户端（Cherry Studio / ChatBox）里直接调用坐标系转换](https://www.showapi.com/guides/coord-convert-mcp-1252) — 免代码接入 AI 工作流。
10. [导入 OpenAPI 文档：用 Apifox / Postman 管理坐标系转换接口](https://www.showapi.com/guides/coord-convert-openapi-1252) — 工程化治理与 Mock。
### 最佳实践层
11. [免费接口的成本管控：坐标系转换的本地缓存与批量合并策略](https://www.showapi.com/guides/coord-convert-cache-1252) — 幂等缓存、去重、档位说明。
12. [前端可视化：把转换后的坐标点在地图上画出来](https://www.showapi.com/guides/coord-convert-map-render-1252) — 对应系 SDK 打点、聚合。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页（apiCode=1252） | https://www.showapi.com/apiGateway/view/1252 |
| 接入点 1：坐标系转换 | https://www.showapi.com/apiGateway/view/1252/1 |
| 接入点 2：两点直线距离 | https://www.showapi.com/apiGateway/view/1252/2 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/1252.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/1252.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费档位说明 | https://www.showapi.com/island/free-api |
| 调用帮助 | https://www.showapi.com/helpcenter/view#/3960/1 |
## 阅读建议
- **第一次用**：按 1 → 2 → 7 顺序，先跑通再理解原理。
- **做地图功能**：重点看 3（全链路）、12（前端渲染）、8（避坑）。
- **批量 / 数据清洗**：看 4（批量）、6（CSV）、11（缓存省额度）。
- **AI / 工程化集成**：看 9（MCP）、10（OpenAPI）。
- **算距离**：看 5（两点距离），记得先统一坐标系。
- **本系列共 12 篇**：你正在阅读[坐标系转换指南总目录](https://www.showapi.com/guides/coord-convert-guides-1252)
