Turf.js处理经纬度坐标偏移太麻烦？教你用turf.js中文API三步完成投影转换！

wowwwai GIS研习社 · 工具流程与项目排障

“Turf.js处理经纬度坐标偏移太麻烦？教你用turf.js中文API三步完成投影转换！”这类问题，本质上通常不是 Turf.js 计算错了，而是前端地图、GeoJSON 数据和空间分析函数使用的坐标参考不一致。本文用一个最常见的 WebGIS 场景讲清楚：如何用 Turf.js 在 WGS84 经纬度和 Web Mercator 之间完成投影转换，并避免缓冲区、距离、面积结果出现明显偏移。

引言：为什么 Turf.js 处理经纬度坐标会出现偏移

很多同学在 Leaflet、OpenLayers 或 Mapbox GL JS 中使用 Turf.js 做缓冲区、距离量算、点线面分析时，会遇到一个现象：GeoJSON 明明能显示在地图上，但经过 Turf.js 处理后，结果图层发生偏移，或者面积、距离看起来不合理。

常见原因有三个：

• 数据坐标系不是 WGS84 经纬度，但被当作 GeoJSON 直接传给 Turf.js。
• 地图底图使用 Web Mercator，而业务数据仍是经纬度坐标，显示和分析阶段混在一起。
• 把投影坐标单位米和经纬度单位度混用，例如用经纬度坐标直接做平面距离判断。

需要先明确一点：Turf.js 默认主要处理 GeoJSON，而 GeoJSON 通常应使用 WGS84 经纬度坐标，即经度、纬度顺序。Turf.js 提供的投影转换能力主要是 WGS84 经纬度与 Web Mercator 之间的转换，例如 turf.toMercator() 和 turf.toWgs84()。如果你要做 CGCS2000、高斯克吕格、UTM、地方独立坐标系之间的转换，应使用 Proj4js、后端 GDAL 或 PostGIS，而不是只依赖 Turf.js。

背景：Turf.js 中文 API 中和投影转换相关的函数

在 Turf.js 中，和投影转换最直接相关的函数主要有两个：

• turf.toMercator(geojson)：把 WGS84 经纬度 GeoJSON 转成 Web Mercator 坐标。
• turf.toWgs84(geojson)：把 Web Mercator GeoJSON 转回 WGS84 经纬度坐标。

这两个函数适合解决前端 WebGIS 中的一个具体问题：数据在经纬度和 Web Mercator 之间来回处理。例如，你希望某些几何计算在米单位的投影坐标下完成，或者你从某个服务拿到 Web Mercator 坐标后，需要转成标准 GeoJSON 供 Turf.js 的其他函数使用。

但它们不适合下面这些场景：

• CGCS2000 转 WGS84。
• 北京 54、西安 80 转 WGS84。
• 高斯克吕格 3 度带或 6 度带转经纬度。
• 地方坐标系、工程坐标系转互联网地图坐标。
• GCJ-02、BD-09 与 WGS84 之间的加密坐标纠偏。

如果你的“经纬度坐标偏移”来自国内互联网地图坐标加密，Turf.js 的投影转换函数也不能直接解决，需要使用合法合规的坐标纠偏方案，并确认数据来源和使用场景。

原理：Turf.js 投影转换到底在转换什么

理解 Turf.js 投影转换，要先分清两个概念：地理坐标系和投影坐标系。

• WGS84 经纬度：坐标通常写作 [经度, 纬度]，单位是度。例如 [116.391, 39.907]。
• Web Mercator：互联网地图常用投影，坐标单位近似为米。例如 [12956482, 4853051]。

GeoJSON 标准约定坐标顺序通常是 [longitude, latitude]，也就是经度在前、纬度在后。Turf.js 大多数函数也默认按这个方式理解输入数据。如果你把 [纬度, 经度] 传进去，地图位置就会跑到很远的地方。

turf.toMercator() 做的是从 WGS84 经纬度到 Web Mercator 的转换；turf.toWgs84() 做的是反向转换。它们不是万能坐标转换器，只是帮你处理 WebGIS 中最常见的一组坐标转换。

实用判断：如果你的坐标值大致在 -180 到 180、-90 到 90 范围内，多半是经纬度；如果坐标值是几百万、一千多万，多半是 Web Mercator 或其他投影坐标。

步骤：用 Turf.js 中文 API 三步完成投影转换

步骤一：确认输入 GeoJSON 是 WGS84 还是 Web Mercator

先看一条简单的 GeoJSON 点数据：

const pointWgs84 = turf.point([116.391, 39.907], {
  name: "北京示例点"
});

这个点的坐标是 [116.391, 39.907]，符合经度、纬度范围，因此可以认为是 WGS84 经纬度。它可以直接用于 Turf.js 的大部分球面量算函数，例如 turf.distance()、turf.length()、turf.area() 等。

再看另一组坐标：

const pointMercator = turf.point([12956555.35, 4852591.60], {
  name: "Web Mercator 示例点"
});

这组坐标明显不是经纬度，因为数值已经达到千万级，通常不能直接当作 WGS84 GeoJSON 传给普通 Turf.js 分析函数。

步骤二：使用 turf.toMercator 转为 Web Mercator

如果你手里有 WGS84 经纬度 GeoJSON，希望转成 Web Mercator，可以这样写：

const pointWgs84 = turf.point([116.391, 39.907], {
  name: "北京示例点"
});

const point3857 = turf.toMercator(pointWgs84);

console.log(point3857);

转换后，point3857 的坐标单位变成近似米，适合与 Web Mercator 坐标数据进行叠加或对齐检查。

如果是面数据或线数据，也可以直接传入：

const polygonWgs84 = turf.polygon([[
  [116.38, 39.90],
  [116.40, 39.90],
  [116.40, 39.92],
  [116.38, 39.92],
  [116.38, 39.90]
]], {
  name: "示例面"
});

const polygon3857 = turf.toMercator(polygonWgs84);

turf.toMercator() 会遍历 GeoJSON 中的坐标并完成转换，不需要你手动处理每一个点。

步骤三：使用 turf.toWgs84 转回经纬度并显示

前端地图或 GeoJSON 服务通常仍希望拿到 WGS84 经纬度格式的数据。这时可以把 Web Mercator 结果转回 WGS84：

const pointWgs84Again = turf.toWgs84(point3857);

console.log(pointWgs84Again);

完整流程可以写成下面这样：

const input = turf.point([116.391, 39.907], {
  name: "北京示例点"
});

// 1. 经纬度转 Web Mercator
const mercator = turf.toMercator(input);

// 2. 在投影坐标下做你的处理或检查
console.log("Web Mercator 坐标：", mercator.geometry.coordinates);

// 3. 转回 WGS84 经纬度，便于 GeoJSON 输出或地图叠加
const output = turf.toWgs84(mercator);

console.log("WGS84 坐标：", output.geometry.coordinates);

这就是 Turf.js 投影转换在前端项目中的最小可复现写法。实际项目里，你可以把输入从点扩展到线、面、FeatureCollection。

步骤：FeatureCollection 批量投影转换示例

真实项目中更常见的是一组点、线、面组成的 FeatureCollection。Turf.js 可以直接处理整个集合：

const features = turf.featureCollection([
  turf.point([116.391, 39.907], { id: 1 }),
  turf.point([121.473, 31.230], { id: 2 }),
  turf.point([113.264, 23.129], { id: 3 })
]);

const features3857 = turf.toMercator(features);

const featuresWgs84 = turf.toWgs84(features3857);

console.log(features3857);
console.log(featuresWgs84);

如果你在 OpenLayers 中使用 EPSG:3857 底图，而接口返回的是 WGS84 GeoJSON，可以先确认框架本身是否已经提供坐标转换能力。不要在地图框架和 Turf.js 中重复转换，否则也会造成坐标偏移。

常见坑：Turf.js 经纬度坐标偏移的排查重点

坑一：经纬度顺序写反

GeoJSON 坐标顺序是 [经度, 纬度]，不是 [纬度, 经度]。这是 Turf.js 经纬度坐标偏移中最常见的低级错误。

// 正确：经度在前，纬度在后
const correct = turf.point([116.391, 39.907]);

// 错误：纬度在前，经度在后
const wrong = turf.point([39.907, 116.391]);

坑二：把 Web Mercator 当成 WGS84

如果坐标长这样：

[12956555.35, 4852591.60]

它就不应该直接传给需要 WGS84 经纬度的 Turf.js 函数。应先用 turf.toWgs84() 转换：

const mercatorPoint = turf.point([12956555.35, 4852591.60]);
const wgs84Point = turf.toWgs84(mercatorPoint);

坑三：重复做投影转换

如果数据已经是 WGS84，你又误以为它是 Web Mercator 并执行 turf.toWgs84()，结果一定会错。反过来也一样。投影转换前必须先判断输入坐标是什么坐标系。

坑四：把 Turf.js 当作万能坐标转换库

Turf.js 的 toMercator 和 toWgs84 主要解决 WGS84 与 Web Mercator 的转换。如果你的数据来自 ArcGIS、QGIS、测绘成果或 CAD 工程文件，坐标系可能是 CGCS2000、高斯克吕格、UTM 或地方坐标系。此时应使用更专业的坐标转换工具。

坑五：忽略国内地图坐标加密问题

如果你的点位在高德、腾讯、百度地图上偏移几十米到几百米，可能不是投影问题，而是 WGS84、GCJ-02、BD-09 坐标体系差异。Turf.js 投影转换不能直接解决这类加密坐标偏移。

方法比较：Turf.js、Proj4js、GDAL、PostGIS 怎么选

简单来说，如果你只是在 WebGIS 前端处理 WGS84 和 Web Mercator，Turf.js 投影转换就足够；如果你要处理正式测绘坐标系，优先考虑 Proj4js、GDAL、PostGIS 或 QGIS。

检查清单：上线前确认 Turf.js 投影转换没有问题

• 确认输入 GeoJSON 坐标顺序是 [经度, 纬度]。
• 确认输入坐标值范围，判断是 WGS84 还是 Web Mercator。
• 只在必要时使用 turf.toMercator() 或 turf.toWgs84()，避免重复转换。
• 确认地图框架是否已经做了坐标转换，不要和 Turf.js 重复处理。
• 如果数据来自 ArcGIS、QGIS 或测绘成果，先查看原始坐标系定义。
• 如果偏移发生在国内互联网地图上，单独检查 GCJ-02、BD-09 与 WGS84 问题。
• 用一个已知坐标点做测试，例如城市地标点，确认转换前后位置是否合理。
• 不要把“单位米”和“单位度”的计算结果混在一起比较。

FAQ：Turf.js 投影转换常见问题

Turf.js 可以把 CGCS2000 转 WGS84 吗？

不建议只用 Turf.js 做这个转换。Turf.js 的 toMercator 和 toWgs84 主要处理 WGS84 与 Web Mercator。如果要做 CGCS2000 转 WGS84，应使用 Proj4js、GDAL、PostGIS 或 QGIS，并确认 EPSG 编码、中央经线、分带方式等参数。

为什么 Turf.js 计算缓冲区后图形偏移？

先检查输入坐标是否为 WGS84 经纬度，以及坐标顺序是否写成了 [经度, 纬度]。如果你把投影坐标直接传给 Turf.js 的经纬度分析函数，缓冲区位置和形状都可能异常。

turf.toMercator 后还能直接作为 GeoJSON 显示吗？

技术上它仍是 GeoJSON 结构，但坐标已经不是标准 WGS84 经纬度。是否能直接显示取决于你的地图框架和图层配置。很多情况下，Web 前端输出或接口传输仍建议转回 WGS84。

Leaflet 中需要手动调用 turf.toMercator 吗？

大多数 Leaflet GeoJSON 图层使用 WGS84 经纬度输入，Leaflet 会处理显示投影。除非你明确知道后续计算需要 Web Mercator 坐标，否则不要随意手动转换，避免重复投影导致坐标偏移。

OpenLayers 和 Turf.js 一起使用时怎么避免偏移？

OpenLayers 内部常用 EPSG:3857 显示，而 GeoJSON 数据可能是 EPSG:4326。建议明确读取数据时的 dataProjection 和 featureProjection，再决定是否需要 Turf.js 参与转换。不要在 OpenLayers 已经转换后，又用 Turf.js 再转一次。

Turf.js 投影转换会改变属性字段吗？

通常不会。turf.toMercator() 和 turf.toWgs84() 主要改变几何坐标，属性字段会保留。但实际开发中仍建议打印转换前后的 GeoJSON，确认 properties 没有在其他处理步骤中丢失。

结论：Turf.js 投影转换适合解决明确的 WGS84 与 Web Mercator 问题

Turf.js 处理经纬度坐标偏移并不复杂，关键是先判断问题来源。对于 WGS84 经纬度与 Web Mercator 之间的转换，使用 turf.toMercator() 和 turf.toWgs84() 就能完成基本流程：确认坐标系、执行转换、转回输出。

但如果你的偏移来自 CGCS2000、高斯克吕格、地方坐标系或国内地图加密坐标，Turf.js 投影转换就不是完整答案。正确做法是先识别坐标系，再选择合适工具。这样才能避免“代码看起来没错，地图结果却偏了”的问题。