如果你在开发地图应用时，遇到过GPS拿到的坐标放到百度地图上偏移了几百米，或者高德地图上标注的位置与腾讯地图不匹配，那你一定深有体会——不同地图服务之间的坐标系，简直是一场灾难。
原因很简单：国内对于地理坐标有特殊政策，所有电子地图必须对位置做偏移处理。WGS84是全球通用的GPS标准坐标系，而国内的高德地图、腾讯地图使用的是GCJ02（火星坐标系），百度地图则在GCJ02基础上又进行了二次加密，形成了BD09坐标系。这三种坐标系之间的差异可能造成几十到几百米的偏移，而且这种偏移不是简单的加减某个值就能校正的。
好在，有 gcoord 这个轻量级的神器。
gcoord 是什么？
gcoord（geographic coordinates）是一个专门处理地理坐标系转换的 JavaScript 库，它能在 WGS84、GCJ02、BD09 等主流坐标系之间自由转换，还能处理 GeoJSON 数据。最令人心动的是，gzip 后只有 3kb，没有任何外部依赖，能在 Node.js、所有现代浏览器（IE8+）甚至 React Native 环境中运行。
无论是做前端地图开发，还是后端数据批量处理，gcoord 都能轻松搞定。
安装与基本使用
通过 npm 安装：
bash
npm install gcoord --save
或者在页面中直接通过 script 标签引入（记得指定版本号）：
html
<script src="https://unpkg.com/gcoord/dist/gcoord.global.prod.js"></script>
引入后，核心 API 只有一个：gcoord.transform(input, from, to)。它将输入的坐标或 GeoJSON 对象，从当前坐标系 from 转换到目标坐标系 to。
三种主流坐标系的转换实战
1. WGS84 → GCJ02（GPS 转高德/腾讯地图）
手机 GPS 获取的坐标是 WGS84，而高德地图使用的是 GCJ02。以下代码将 GPS 坐标转换为高德地图可用的坐标：
javascript
import gcoord from 'gcoord';
// 原始坐标，假设为 WGS84 坐标
const wgs84Point = [116.397428, 39.90923];
// 将 WGS84 坐标转换为 GCJ02 坐标
const gcj02Point = gcoord.transform(wgs84Point, gcoord.WGS84, gcoord.GCJ02);
console.log(gcj02Point); // [116.403663, 39.914546]
2. GCJ02 → BD09（高德/腾讯转百度地图）
javascript
const gcj02Point = [116.403663, 39.914546];
const bd09Point = gcoord.transform(gcj02Point, gcoord.GCJ02, gcoord.BD09);
console.log(bd09Point); // [116.410369, 39.921336]
3. WGS84 → BD09（GPS 直接转百度地图）
javascript
var result = gcoord.transform(
[116.403988, 39.914266],
gcoord.WGS84,
gcoord.BD09
);
console.log(result); // [116.41661560068297, 39.92196580126834]
批量转换 GeoJSON 数据
如果你需要处理大量地理数据，比如从后端拿到整个城市的 POI 数据，gcoord 支持直接转换整个 GeoJSON 对象，无需手动遍历每个坐标点：
javascript
import gcoord from 'gcoord';
// 示例 GeoJSON 数据
const geojson = {
type: 'FeatureCollection',
features: [
{
type: 'Feature',
geometry: {
type: 'Point',
coordinates: [116.397428, 39.90923]
}
}
]
};
// 批量转换所有坐标点
gcoord.transform(geojson, gcoord.WGS84, gcoord.BD09);
这种方法会直接修改输入的 GeoJSON 对象，不会创建多余的数据副本，内存占用极低。如果你需要处理超大型 GeoJSON 文件，gcoord 还支持结合 Node.js 的 Stream 流式处理，避免内存溢出。
真实场景应用
很多人已经将 gcoord 应用到了实际项目中。比如，有人在做微信小程序时遇到腾讯地图定位偏差问题，通过引入 gcoord 进行坐标转换就顺利解决了。还有人将 WGS84 的数据图层叠加到高德地图底图上时，利用 gcoord 实时转换坐标，彻底告别了图层错位的烦恼。
更直观的例子，地图查询工具网站 www.mapchaxun.cn/bathLocatio… 就是使用 gcoord 进行坐标系转换，让用户在不同地图坐标系之间自由切换查询，无需关心底层坐标差异。
写在最后
gcoord 虽小，但解决了地图开发中一个非常棘手的问题。它只有 3kb，API 只有一个 transform，没有学习成本，却能让你告别坐标偏移的噩梦。无论你是开发高德地图、百度地图还是腾讯地图，gcoord 都是你项目中最值得加入的小工具之一。
