@turf/line-intersect

What is @turf/line-intersect?

@turf/line-intersect is a module from the Turf.js library that provides geospatial analysis tools. This specific module is used to find the intersection points between two or more lines. It is useful in various geospatial applications, such as mapping, urban planning, and geographic information systems (GIS).

What are @turf/line-intersect's main functionalities?

Find Intersection Points

This feature allows you to find the intersection points between two lines. In the code sample, two lines are defined, and the `lineIntersect` function is used to find their intersection points.

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

const line1 = turf.lineString([[0, 0], [2, 2]]);
const line2 = turf.lineString([[0, 2], [2, 0]]);

const intersections = turf.lineIntersect(line1, line2);
console.log(intersections);

Other packages similar to @turf/line-intersect

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 more comprehensive geometry processing capabilities compared to @turf/line-intersect, including operations like buffering, union, and difference.

martinez-polygon-clipping

Martinez Polygon Clipping is a library for performing boolean operations on polygons, such as intersection, union, and difference. While it focuses on polygon operations, it can also be used to find intersections between line segments within polygons, offering more specialized functionality compared to @turf/line-intersect.

README

@turf/line-intersect

lineIntersect

Takes any LineString or Polygon GeoJSON and returns the intersecting point(s).

Parameters

• line1 (Geometry | FeatureCollection | Feature<(LineString | MultiLineString | Polygon | MultiPolygon)>) any LineString or Polygon
• line2 (Geometry | FeatureCollection | Feature<(LineString | MultiLineString | Polygon | MultiPolygon)>) any LineString or Polygon

Examples

var line1 = {
  "type": "Feature",
  "properties": {},
  "geometry": {
    "type": "LineString",
    "coordinates": [[126, -11], [129, -21]]
  }
};
var line2 = {
  "type": "Feature",
  "properties": {},
  "geometry": {
    "type": "LineString",
    "coordinates": [[123, -18], [131, -14]]
  }
};
var intersects = turf.lineIntersect(line1, line2);

//addToMap
var addToMap = [line, line2, intersects]

Returns FeatureCollection<Point> point(s) that intersect both

---

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/line-intersect

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

$ npm install @turf/turf

Changelog

4.4.0

🚀 New Modules

• @turf/line-offset Adds a new lineOffset module as per this issue. Basically takes an input line and returns a new line offset by the distance. (PR https://github.com/Turfjs/turf/pull/729 - Author @rowanwins)
• @turf/polygonize Polygonizes (Multi)LineString(s) into Polygons. Implementation of GEOSPolygonize function (geos::operation::polygonize::Polygonizer). (PR https://github.com/Turfjs/turf/pull/767 - Author @NickCis)
• @turf/transform-rotate Rotates any geojson Feature or Geometry of a specified angle, around its centroid or a given pivot point; all rotations follow the right-hand rule. (Issue https://github.com/Turfjs/turf/issues/747 - Author @stebogit)
• @turf/transform-translate Moves any geojson Feature or Geometry of a specified distance along a Rhumb Line on the provided direction angle. (Issue https://github.com/Turfjs/turf/issues/747 - Author @stebogit)
• @turf/transform-scale Scale a GeoJSON from a given point by a factor of scaling (ex: factor=2 would make the GeoJSON 200% larger). If a FeatureCollection is provided, the origin point will be calculated based on each individual Feature. (Issue https://github.com/Turfjs/turf/issues/747 - Author @stebogit)

🏅 New Features

• Support z-coordinate as input for @turf/turf-tin (PR https://github.com/Turfjs/turf/pull/772)
• Adds properties parameter to @turf/centroid and @turf/center (PR https://github.com/Turfjs/turf/pull/769)
• Include Yarn.lock for all modules & Lerna uses Yarn (Issue https://github.com/Turfjs/turf/issues/704, https://github.com/Turfjs/turf/issues/765, PR https://github.com/Turfjs/turf/pull/766)
• Use Tap at root which enables code coverage reports (Issue https://github.com/Turfjs/turf/issues/328 & PR https://github.com/Turfjs/turf/pull/762)
• Support z-coordinate as input for @turf/pointplane (PR https://github.com/Turfjs/turf/pull/754)
• Add core tests - file management & package.json rules (PR https://github.com/Turfjs/turf/pull/749 & https://github.com/Turfjs/turf/pull/756)

🐛 Bug Fixes

• Website http://turfjs.org is back up and running (Issue https://github.com/Turfjs/turf/issues/777)
• @turf/rhumb-destination issue at 180th meridian (Issue https://github.com/Turfjs/turf/issues/770 & PR https://github.com/Turfjs/turf/pull/771)
• Getting too large numbers for Longitude (Issue https://github.com/Turfjs/turf/issues/758 & PR https://github.com/Turfjs/turf/pull/763)
• Throw error if FeatureCollection not array #751 (PR https://github.com/Turfjs/turf/pull/760)
• Change default param coordinates to 3 @turf/truncate (PR https://github.com/Turfjs/turf/pull/757)
• along returns a point that is not found by @turf/point-on-line (Issue https://github.com/Turfjs/turf/issues/691)
• Fix location of intersect point for @turf/point-on-line. (PR https://github.com/Turfjs/turf/pull/750)
• Handle empty geometries as undefined @turf/buffer (PR https://github.com/Turfjs/turf/pull/746)