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

polygonToLine

先看结论

取面的外环与内环,转成独立的线要素。

最后验证 2026-11-03 · Turf.js 7.x · 更新 2026-10-27 · 引用本文
turf.polygonToLine(polygon, options) → Feature | FeatureCollection

参数

参数类型说明
polygonFeaturePolygon 或 MultiPolygon
options.propertiesobject附加到输出线的属性

返回值

单个 Polygon 返回 LineString 要素; 带洞的 Polygon 或多部件面返回 FeatureCollection。返回类型需按输入判断。

示例

var boundary = turf.polygonToLine(area);
var lines = boundary.type === 'FeatureCollection'
  ? boundary.features
  : [boundary];

console.log(lines.length);
console.log(turf.length(lines[0], { units: 'kilometers' }));

闭合性

输出的线首尾坐标相同,是闭合环。做沿线取点、分段时先去掉重复末点, 否则里程会多算一小段。

典型用途

面单独描边、做线缓冲区、沿线布设符号、提取边界坐标做碰撞检测, 都先转成线更直接。

洞也会转成线。带洞的面会输出内外两条线, 只想要外轮廓时需要按序号或环的方向过滤。

引用本文

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