@turf/tag
Version:
turf tag module
41 lines (38 loc) • 1.46 kB
text/typescript
import { FeatureCollection, Point, Polygon, MultiPolygon } from 'geojson';
/**
* Takes a set of {@link Point|points} and a set of {@link Polygon|polygons} and/or {@link MultiPolygon|multipolygons} and performs a spatial join.
*
* @function
* @param {FeatureCollection<Point>} points input points
* @param {FeatureCollection<Polygon|MultiPolygon>} polygons input (multi)polygons
* @param {string} field property in `polygons` to add to joined {<Point>} features
* @param {string} outField property in `points` in which to store joined property from `polygons`
* @returns {FeatureCollection<Point>} points with `containingPolyId` property containing values from `polyId`
* @example
* var pt1 = turf.point([-77, 44]);
* var pt2 = turf.point([-77, 38]);
* var poly1 = turf.polygon([[
* [-81, 41],
* [-81, 47],
* [-72, 47],
* [-72, 41],
* [-81, 41]
* ]], {pop: 3000});
* var poly2 = turf.polygon([[
* [-81, 35],
* [-81, 41],
* [-72, 41],
* [-72, 35],
* [-81, 35]
* ]], {pop: 1000});
*
* var points = turf.featureCollection([pt1, pt2]);
* var polygons = turf.featureCollection([poly1, poly2]);
*
* var tagged = turf.tag(points, polygons, 'pop', 'population');
*
* //addToMap
* var addToMap = [tagged, polygons]
*/
declare function tag(points: FeatureCollection<Point>, polygons: FeatureCollection<Polygon | MultiPolygon>, field: string, outField: string): FeatureCollection<Point>;
export { tag as default, tag };