经纬志
首页 / Turf.js / API 文档

combine

先看结论

把一组点合成 MultiPoint、一组线合成 MultiLineString。

最后验证 2026-11-03 · Turf.js 7.x · 更新 2026-10-27 · 引用本文
turf.combine(featureCollection) → Feature

参数

参数类型说明
featureCollectionFeatureCollection类型需一致

返回值

单个要素,几何类型为对应的 Multi 版本。 集合内类型混杂时只合并同类型部分,结果可能不完整。

示例

var pts = turf.featureCollection([
  turf.point([116.30, 39.90]),
  turf.point([116.40, 39.92]),
  turf.point([116.48, 39.88])
]);

var multi = turf.combine(pts);
console.log(multi.features[0].geometry.type);   // MultiPoint

用途

要素数量多时,合并成一个多部件对象能减少序列化体积与图层对象数量。 但拾取粒度随之变粗,选中一个部件等于选中整体。

与 dissolve 的区别

combine 只把几何拼在一起,不做拓扑融合,内部边界仍然存在; dissolve 会消除相邻面的公共边。

合并前确认坐标参考一致。混入不同投影的要素, 合并结果会在图上出现明显错位,而不是报错。

引用本文

经纬志(2026)。《combine》。https://www.jingweizhi.com/turf/api/combine.html(访问日期 2026-11-03)。