@turf/boolean-intersects

What is @turf/boolean-intersects?

@turf/boolean-intersects is a module from the Turf.js library that provides geospatial analysis tools. This specific module is used to determine if two geometries intersect. It supports various types of geometries including points, lines, and polygons.

What are @turf/boolean-intersects's main functionalities?

Check if two polygons intersect

This feature checks if two polygons intersect. The code sample creates two polygons and uses the booleanIntersects function to determine if they intersect.

const turf = require('@turf/turf');

const polygon1 = turf.polygon([[
  [-2, 2],
  [2, 2],
  [2, -2],
  [-2, -2],
  [-2, 2]
]]);

const polygon2 = turf.polygon([[
  [1, 1],
  [3, 1],
  [3, -1],
  [1, -1],
  [1, 1]
]]);

const intersects = turf.booleanIntersects(polygon1, polygon2);
console.log(intersects); // true

Check if a line intersects a polygon

This feature checks if a line intersects a polygon. The code sample creates a line and a polygon and uses the booleanIntersects function to determine if they intersect.

const turf = require('@turf/turf');

const line = turf.lineString([
  [-1, 0],
  [1, 0]
]);

const polygon = turf.polygon([[
  [-2, 2],
  [2, 2],
  [2, -2],
  [-2, -2],
  [-2, 2]
]]);

const intersects = turf.booleanIntersects(line, polygon);
console.log(intersects); // true

Check if a point intersects a polygon

This feature checks if a point intersects a polygon. The code sample creates a point and a polygon and uses the booleanIntersects function to determine if they intersect.

const turf = require('@turf/turf');

const point = turf.point([1, 1]);

const polygon = turf.polygon([[
  [-2, 2],
  [2, 2],
  [2, -2],
  [-2, -2],
  [-2, 2]
]]);

const intersects = turf.booleanIntersects(point, polygon);
console.log(intersects); // true

Other packages similar to @turf/boolean-intersects

jsts

JSTS is a JavaScript library of spatial predicates and functions for processing geometry. It is a port of the Java Topology Suite (JTS). JSTS provides a wide range of geometric operations, including intersection checks, and is more comprehensive in terms of geometric processing compared to @turf/boolean-intersects.

martinez-polygon-clipping

Martinez Polygon Clipping is a library for performing boolean operations on polygons, such as union, intersection, difference, and xor. It is highly efficient and specifically designed for polygon operations, making it a good alternative for polygon intersection checks.

README

@turf/boolean-intersects

booleanIntersects

Boolean-intersects returns (TRUE) two geometries intersect.

Parameters

• feature1 (Geometry | Feature<any>) GeoJSON Feature or Geometry
• feature2 (Geometry | Feature<any>) GeoJSON Feature or Geometry

Examples

var point = turf.point([2, 2]);
var line = turf.lineString([[1, 1], [1, 2], [1, 3], [1, 4]]);

turf.booleanIntersects(line, point);
//=true

Returns boolean true/false

---

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/boolean-intersects

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

$ npm install @turf/turf

Changelog

6.4.0

🏅 New Features/Enhancements

• @turf/boolean-point-on-line Added an epislon option to help in floating point comparison. (PR https://github.com/Turfjs/turf/pull/2051 - Author @okcoker)

🐛 Bug Fixes

• @turf/line-slice-along Fixed a bug where the offset distance equal to the length of the line (PR https://github.com/Turfjs/turf/pull/2030 - Author @EricPKerr)

• @turf/helpers Fixed the conversion ratio for converting meters to yards and vice-versa (PR https://github.com/Turfjs/turf/pull/2046 - Author @anotherhale)

• @turf/center-median Fixed a missing TS type import (PR https://github.com/Turfjs/turf/pull/2044 - Author @Seairth)

• `@turf/bezier-spline Fix a bug ensuring the spline result reaches the end of the input (PR https://github.com/Turfjs/turf/pull/2090 - Author @the-nemz)

📖 Documentation

• @turf/transform-rotate and @turf/ellipse) Improve documentation for angle parameter (PR https://github.com/Turfjs/turf/pull/2016 - Author @pasieronen)

• @turf/line-chunk Fix an invalid anchor (PR https://github.com/Turfjs/turf/pull/2071 - Author @GraxMonzo)

• @turf/distance Enhance distance doco so supported inputs are clearer (PR https://github.com/Turfjs/turf/pull/2032 - Author @rowanwins)

🔔 Misc

• @turf/concave Replace deprecated topojson dependency (PR https://github.com/Turfjs/turf/pull/2037 - Author @elliots)

• Work towards enabling TS Strict Mode (PR https://github.com/Turfjs/turf/pull/2053 - Author @mfedderly)