@turf/point-to-line-distance
pointToLineDistance
Returns the minimum distance between a Point and a LineString, being the distance from a line the
minimum distance between the point and any segment of the LineString
.
Parameters
-
pt
(Feature<Point> | Array<number>) Feature or Geometry
-
line
Feature<LineString> GeoJSON Feature or Geometry
-
options
Object Optional parameters (optional, default {}
)
options.units
string can be anything supported by turf/convertLength
(ex: degrees, radians, miles, or kilometers) (optional, default "kilometers"
)options.method
string whether to calculate the distance based on geodesic (spheroid) or
planar (flat) method. Valid options are 'geodesic' or 'planar'. (optional, default "geodesic"
)
Examples
var pt = turf.point([0, 0]);
var line = turf.lineString([[1, 1],[-1, 1]]);
var distance = turf.pointToLineDistance(pt, line, {units: 'miles'});
Returns number distance between point and line
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/point-to-line-distance
Or install the all-encompassing @turf/turf module that includes all modules as functions:
$ npm install @turf/turf