Package Exports

@turf/intersect

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@turf/intersect) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@turf/intersect

intersect

Takes two polygon or multi-polygon geometries and finds their polygonal intersection. If they don't intersect, returns null.

Parameters

poly1 Feature<(Polygon | MultiPolygon)> the first polygon or multipolygon
poly2 Feature<(Polygon | MultiPolygon)> the second polygon or multipolygon
options Object Optional Parameters (optional, default {})
- options.properties Object Translate GeoJSON Properties to Feature (optional, default {})

Examples

var poly1 = turf.polygon([[
  [-122.801742, 45.48565],
  [-122.801742, 45.60491],
  [-122.584762, 45.60491],
  [-122.584762, 45.48565],
  [-122.801742, 45.48565]
]]);

var poly2 = turf.polygon([[
  [-122.520217, 45.535693],
  [-122.64038, 45.553967],
  [-122.720031, 45.526554],
  [-122.669906, 45.507309],
  [-122.723464, 45.446643],
  [-122.532577, 45.408574],
  [-122.487258, 45.477466],
  [-122.520217, 45.535693]
]]);

var intersection = turf.intersect(poly1, poly2);

//addToMap
var addToMap = [poly1, poly2, intersection];

Returns (Feature | null) returns a feature representing the area they share (either a Polygon or MultiPolygon). If they do not share any area, returns null.

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 module individually:

$ npm install @turf/intersect

Or install the Turf module that includes it as a function:

$ npm install @turf/turf