union

描述

🌐 Description

接受一组输入多边形并返回一个组合多边形。如果输入多边形不相连，该函数将返回一个多重多边形要素。

🌐 Takes a collection of input polygons and returns a combined polygon. If the input polygons are not contiguous, this function returns a multi-polygon feature.

参数

🌐 Parameters

名称	类型	描述
features	FeatureCollection<Polygon | MultiPolygon>	输入多边形要素
options?	Object	可选参数 (默认 {})
options.properties?	GeoJsonProperties	要分配给输出特性的属性 (默认 {})

返回

🌐 Returns

Feature<Polygon | MultiPolygon> | null 一个组合多边形或多多边形要素，如果没有要合并的输入多边形则为 null

示例

🌐 Examples

const poly1 = turf.polygon(
  [
    [
      [-82.574787, 35.594087],
      [-82.574787, 35.615581],
      [-82.545261, 35.615581],
      [-82.545261, 35.594087],
      [-82.574787, 35.594087],
    ],
  ],
  { fill: "#0f0" },
);

const poly2 = turf.polygon([
  [
    [-82.560024, 35.585153],
    [-82.560024, 35.602602],
    [-82.52964, 35.602602],
    [-82.52964, 35.585153],
    [-82.560024, 35.585153],
  ],
]);

const union = turf.union(turf.featureCollection([poly1, poly2]));

安装

🌐 Installation

$ npm install @turf/union

import { union } from "@turf/union";
const result = union(...);

$ npm install @turf/turf

import * as turf from "@turf/turf";
const result = turf.union(...);