还在用老方法计算面积距离？Turf.js文档核心API速查（附实战案例）

引言：告别繁琐计算，拥抱地理计算的未来

你是否还在为计算两个坐标点之间的距离而头疼？或者为了计算多边形的面积而手动编写复杂的数学公式？在日常开发中，无论是构建物流配送系统、分析用户分布，还是开发地图应用，地理空间计算都是绕不开的核心环节。

传统的几何计算方法不仅代码量大、容易出错，而且在处理复杂地理数据（如曲线、多面体）时显得力不从心。随着Web GIS（地理信息系统）的兴起，我们需要一种更高效、更标准的解决方案。

本文将为你介绍一款轻量级且功能强大的JavaScript库——Turf.js。它专为浏览器和Node.js环境设计，能让你在前端直接处理地理数据。我们将深入解析其核心API，并通过实战案例演示如何快速实现面积与距离的计算，帮助你大幅提升开发效率。

为什么选择 Turf.js？它解决了什么痛点？

在处理地理数据时，我们通常面临两大难题：一是算法实现的复杂性，二是数据格式的兼容性。Turf.js 基于 GeoJSON 标准设计，这是目前 Web 端最通用的地理数据交换格式。

它不需要后端服务器支持，直接在浏览器中运行，这意味着更快的响应速度和更低的服务器成本。对于开发者而言，它提供了一套完整的 API，涵盖了从简单的距离计算到复杂的插值分析、空间查询等功能。

使用 Turf.js，你可以轻松实现以下功能：

• 计算两点间的地理距离（大圆距离）。
• 计算多边形的面积（支持不同单位）。
• 判断点是否在多边形内（空间包含关系）。
• 生成等高线或等值区域图。
• 对地理数据进行平滑处理或抽稀。

Turf.js 核心 API 速查：面积与距离计算

在开始实战之前，我们需要了解两个最常用的 API。以下表格对比了这两个核心方法的用途、参数及返回值。

1. 计算两点间距离 (turf.distance)

计算距离时，我们不仅要考虑平面的直线距离，还要考虑地球的曲率。Turf.js 默认使用 Haversine 公式 计算大圆距离，精度非常高。

基本语法：

turf.distance(from, to, options);

参数说明：

• from: 起点坐标 (GeoJSON Point 格式)。
• to: 终点坐标 (GeoJSON Point 格式)。
• options: 可选配置对象，可设置单位 (units)，如 'kilometers' (千米), 'miles' (英里), 'degrees' (度)。

2. 计算多边形面积 (turf.area)

计算面积时，Turf.js 会自动处理多边形的复杂情况，包括带有孔洞的多边形。需要注意的是，计算结果默认以 平方米 为单位。

基本语法：

turf.area(geojson);

参数说明：

• geojson: 任何有效的 GeoJSON 对象（Polygon, MultiPolygon, Feature 等）。

实战案例：快速实现地理数据计算

理论说完了，我们直接上手代码。假设我们需要计算一个物流站点到配送点的距离，并计算该配送区域的覆盖面积。

步骤一：安装与引入 Turf.js

你可以通过 npm 安装，或者直接在浏览器中引入 CDN 链接。

使用 npm：

npm install @turf/turf

使用 CDN (浏览器环境)：

<script src="https://cdn.jsdelivr.net/npm/@turf/turf@6/turf.min.js"></script>

步骤二：编写计算逻辑

下面是一个完整的 Node.js 示例代码，演示了如何计算距离和面积。

代码示例：

// 引入 Turf.js
const turf = require('@turf/turf');

// 1. 定义起点和终点 (GeoJSON Point 格式)
const start = turf.point([116.4074, 39.9042]); // 北京天安门
const end = turf.point([121.4737, 31.2304]);   // 上海东方明珠

// 2. 计算距离 (单位：千米)
const options = { units: 'kilometers' };
const distance = turf.distance(start, end, options);

console.log(`两点间的距离是: ${distance.toFixed(2)} km`);

// 3. 定义一个矩形多边形 (例如：北京二环内大致区域)
const polygon = turf.polygon([[
    [116.30, 39.85],
    [116.50, 39.85],
    [116.50, 40.00],
    [116.30, 40.00],
    [116.30, 39.85]
]]);

// 4. 计算面积 (默认单位：平方米)
const area = turf.area(polygon);

console.log(`该多边形区域的面积是: ${area.toFixed(0)} 平方米`);
console.log(`换算成平方公里: ${(area / 1000000).toFixed(2)} km²`);

步骤三：结果分析

运行上述代码，你将得到精确的距离和面积数据。相比于手动使用半正矢公式，代码量减少了 80% 以上，且可读性极强。

扩展技巧：不为人知的高级用法

除了基础的计算，Turf.js 还有许多隐藏的宝藏功能，能帮你解决更棘手的问题。

技巧一：批量计算与空间查询

当你需要计算数千个点之间的距离，或者判断大量点是否落在某个区域内时，简单的循环可能会导致性能瓶颈。

优化方案： 使用 turf.collect 或 turf.pointsWithinPolygon。这两个 API 可以利用空间索引（R-Tree）进行极速查询，比传统的双重循环快几个数量级。例如，在地图上筛选出某个商圈内的所有用户点，只需一行代码即可完成。

技巧二：坐标系的陷阱 (WGS84 vs 投影坐标)

这是一个非常重要但常被忽视的细节。Turf.js 默认基于 WGS84 坐标系 (EPSG:4326)，即我们常用的经纬度。

注意事项： 虽然经纬度可以计算距离，但在某些高精度场景（如小范围建筑测绘）下，直接使用经纬度计算面积会有微小误差。如果你使用的是 Web墨卡托投影 (EPSG:3857，常见于 Google Maps、OpenLayers)，需要先使用 turf.projection.toWgs84 将坐标转换，计算后再转换回去，否则结果将完全错误。

FAQ：用户最常搜索的问题

1. Turf.js 是免费的吗？可以商用吗？

是的，Turf.js 是一个开源项目，采用 MIT 许可证。这意味着你可以免费将其用于个人项目或商业项目中，无需支付任何费用，只需在代码中保留版权声明即可。

2. Turf.js 和 Google Maps API 有什么区别？

Google Maps API 是一个功能全面的地图服务，提供地图展示、路线规划等，但请求次数有限制且收费。Turf.js 是一个纯数学计算库，它不提供地图底图，只负责地理数据的计算和分析。通常两者结合使用：用 Google Maps 展示地图，用 Turf.js 在前端处理数据后再渲染到地图上。

3. 为什么我的计算结果精度不准确？

精度问题通常由以下原因导致：

• 坐标顺序错误：GeoJSON 标准规定坐标顺序为 [经度, 纬度] (Longitude, Latitude)，而不是 [纬度, 经度]。
• 单位混淆：turf.distance 默认返回度数（degrees），必须在 options 中明确指定 units 为 'kilometers' 或 'meters'。
• 多边形未闭合：GeoJSON 要求多边形的第一个坐标点必须与最后一个坐标点相同，形成闭合环。

总结：让地理计算变得简单

地理空间计算不再是后端或专业 GIS 软件的专利。通过 Turf.js，前端开发者也能轻松驾驭复杂的地理逻辑。无论是计算简单的距离面积，还是处理复杂的空间关系，Turf.js 都能提供稳定、高效的解决方案。

现在就去尝试安装 Turf.js，将它集成到你的下一个项目中吧。告别繁琐的数学公式，用更优雅的代码处理地理数据！