@turf/line-distance

@turf/line-distance

lineDistance

Takes a LineString or Polygon and measures its length in the specified units.

Parameters

• line (Feature<(LineString | Polygon)> | FeatureCollection<(LineString | Polygon)>) line to measure
• units [string] can be degrees, radians, miles, or kilometers (optional, default kilometers)

Examples

var line = {
  "type": "Feature",
  "properties": {},
  "geometry": {
    "type": "LineString",
    "coordinates": [
      [-77.031669, 38.878605],
      [-77.029609, 38.881946],
      [-77.020339, 38.884084],
      [-77.025661, 38.885821],
      [-77.021884, 38.889563],
      [-77.019824, 38.892368]
    ]
  }
};

var length = turf.lineDistance(line, 'miles');

//=line

//=length

Returns number length of the input 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 module individually:

$ npm install @turf/line-distance

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

$ npm install @turf/turf