@turf/nearest-point-to-line

nearestPointToLine

Returns the closest point, of a collection of points, to a line. The returned point has a dist property indicating its distance to the line.

Parameters

• points (FeatureCollection | GeometryCollection<Point>) Point Collection
• line (Feature | Geometry<LineString>) Line Feature
• options Object? Optional parameters
  • options.units string unit of the output distance property, can be degrees, radians, miles, or kilometers (optional, default 'kilometers')
  • options.properties Object Translate Properties to Point (optional, default {})

Examples

var pt1 = turf.point([0, 0]);
var pt2 = turf.point([0.5, 0.5]);
var points = turf.featureCollection([pt1, pt2]);
var line = turf.lineString([[1,1], [-1,1]]);

var nearest = turf.nearestPointToLine(points, line);

//addToMap
var addToMap = [nearest, line];

Returns Feature<Point> the closest point

pt

Translate Properties to final Point, priorities: 1. options.properties 2. inherent Point properties 3. dist custom properties created by NearestPointToLine

---

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/nearest-point-to-line

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

$ npm install @turf/turf