mirror of
https://github.com/Turfjs/turf.git
synced 2026-01-25 16:07:00 +00:00
@turf/tag
tag
Takes a set of points and a set of polygons and/or multipolygons and performs a spatial join.
Parameters
pointsFeatureCollection<Point> input pointspolygonsFeatureCollection<(Polygon | MultiPolygon)> input (multi)polygonsfieldstring property inpolygonsto add to joined {} featuresoutFieldstring property inpointsin which to store joined property frompolygons
Examples
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]
Returns FeatureCollection<Point> points with containingPolyId property containing values from polyId
This module is part of the Turfjs project, an open source module collection dedicated to geographic algorithms. It is maintained in the Turfjs/turf repository, where you can create PRs and issues.
Installation
Install this single module individually:
$ npm install @turf/tag
Or install the all-encompassing @turf/turf module that includes all modules as functions:
$ npm install @turf/turf