feature conversion

combine

npm install @turf/combine

接收一个 type 为 Point、LineString、Polygon 的要素集(FeatureCollection)，组合成 type 为 MultiPoint、MultiLineString、MultiPolygon的单一要素并返回

值得注意的是，当入参要素集存在不同类型的要素时，返回的要素不是单一要素，而是进行同要素归类。例如，入参两个 Point，两个 LineString，出参一个 MultiPoint，一个 MultiLineString

参数

返回

FeatureCollection<MultiPoint|MultiLineString|MultiPolygon>

范例

var fc = turf.featureCollection([
  turf.point([19.026432, 47.49134]),
  turf.point([19.074497, 47.509548])
]);
var combined = turf.combine(fc);
/*
{
  type: "FeatureCollection",
  features: [{
    type: "Feature",
    geometry: {
      type: "MultiPoint",
      coordinates: [
        [19.026432, 47.49134],
        [19.074497, 47.509548]
      ]
    }
  }]
}
*/

explode

npm install @turf/explode

接收任意要素(Feature)或要素集(FeatureCollection)，返回所有要素的顶点

参数

返回

FeatureCollection<Point>

范例

var polygon = turf.polygon([
  [
    [-81, 41],
    [-88, 36],
    [-84, 31],
    [-80, 33],
    [-77, 39],
    [-81, 41]
  ]
]);
var explode = turf.explode(polygon); // 返回六个顶点的要素集

flatten

npm install @turf/flatten

接收一个 type 为 MultiPoint、MultiLineString、MultiPolygon的要素，返回 type 为 Point、LineString、Polygon 的要素集(FeatureCollection)

参数

返回

FeatureCollection - 摊平的要素集

范例

var multiGeometry = turf.multiPolygon([
  [
    [
      [102.0, 2.0],
      [103.0, 2.0],
      [103.0, 3.0],
      [102.0, 3.0],
      [102.0, 2.0]
    ]
  ],
  [
    [
      [100.0, 0.0],
      [101.0, 0.0],
      [101.0, 1.0],
      [100.0, 1.0],
      [100.0, 0.0]
    ],
    [
      [100.2, 0.2],
      [100.8, 0.2],
      [100.8, 0.8],
      [100.2, 0.8],
      [100.2, 0.2]
    ]
  ]
]); // type 为 MultiPolygon
var flatten = turf.flatten(multiGeometry); // type 为 Polygon 的多个要素

lineToPolygon

npm install @turf/line-to-polygon

接收 type 为 LineString 或 MultiLineString 的线要素，转换成 type 为 Polygon 或 MultiPolygon 的面要素

值得注意的是，入参只能接收线要素，否则报错

参数

options

返回

Feature<Polygon|MultiPolygon>

范例

var line = turf.lineString([
  [125, -30],
  [145, -30],
  [145, -20],
  [125, -20],
  [125, -30]
]);
var polygon = turf.lineToPolygon(line); // type 为 Polygon 的面要素

polygonize

npm install @turf/polygonize

接收一个 type 为 LineString 或 [MultiLineString][multilintstring_link] 的要素，转换成 type 为 Polygon 的面要素集合

值得注意的是，lineToPolygon 方法返回要素，该方法返回要素集，且不能传入 options 的属性

参数

返回

FeatureCollection<Polygon>

范例

var line = turf.lineString([
  [125, -30],
  [145, -30],
  [145, -20],
  [125, -20],
  [125, -30]
]);
var polygon = turf.polygonize(line); // type 为 Polygon 的面要素

polygonToLine

npm install @turf/polygon-to-line

接收 type 为 Polygon 或 MultiPolygon 的面要素，转换成 type 为 LineString 的线要素 或 MultiLineString 的要素集FeatureCollection

参数

options

返回

FeatureCollection<LineString|MultiLineString>

范例

var poly = turf.polygon([
  [
    [125, -30],
    [145, -30],
    [145, -20],
    [125, -20],
    [125, -30]
  ]
]);
var line = turf.polygonToLine(poly); // type 为 LineString 的要素