collect
描述
¥Description
将点要素集合 (FeatureCollection) 中指定属性的点合并到多边形要素集合 (FeatureCollection) 中。给定点的 inProperty
和多边形的 outProperty
,这将查找位于每个多边形内的每个点,收集这些点的 inProperty
值,并将它们作为数组添加到多边形的 outProperty
中。
¥Merges a specified property from a FeatureCollection of points into a
FeatureCollection of polygons. Given an inProperty
on points and an outProperty
for polygons, this finds every point that lies within each polygon, collects the
inProperty
values from those points, and adds them as an array to outProperty
on the polygon.
参数
¥Parameters
名称 | 类型 | 描述 |
---|---|---|
polygons | FeatureCollection<多边形> | 要聚合值的多边形 |
points | FeatureCollection<点> | 要捕捉的点聚合 |
inProperty | string | 嵌套的属性 |
outProperty | string | 嵌套的属性 |
返回
¥Returns
FeatureCollection<多边形> 基于 outField
属性的多边形
¥FeatureCollection<Polygon> polygons with properties listed based on outField
示例
¥Examples
var poly1 = turf.polygon([
[
[0, 0],
[10, 0],
[10, 10],
[0, 10],
[0, 0],
],
]);
var poly2 = turf.polygon([
[
[10, 0],
[20, 10],
[20, 20],
[20, 0],
[10, 0],
],
]);
var polyFC = turf.featureCollection([poly1, poly2]);
var pt1 = turf.point([5, 5], { population: 200 });
var pt2 = turf.point([1, 3], { population: 600 });
var pt3 = turf.point([14, 2], { population: 100 });
var pt4 = turf.point([13, 1], { population: 200 });
var pt5 = turf.point([19, 7], { population: 300 });
var pointFC = turf.featureCollection([pt1, pt2, pt3, pt4, pt5]);
var collected = turf.collect(polyFC, pointFC, "population", "values");
var values = collected.features[0].properties.values;
//=values => [200, 600]
安装
¥Installation
$ npm install @turf/collect
import { collect } from "@turf/collect";
const result = collect(...);
$ npm install @turf/turf
import * as turf from "@turf/turf";
const result = turf.collect(...);