@turf/line-distance

@turf/line-distance

lineDistance

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

Parameters

• geojson (Feature<(LineString | Polygon)> | FeatureCollection<(LineString | Polygon)>) feature 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');

//addToMap
line.properties.distance = length;
var addToMap = [line];

Returns number length feature

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

Changelog

4.3.0

🚀 New Modules

• Rhumb Line Modules (https://github.com/Turfjs/turf/pull/728)
  • @turf/rhumb-bearing
  • @turf/rhumb-distance
  • @turf/rhumb-destination
• @turf/polygon-tangents Finds the tangents of a (Multi)Polygon from a Point. (https://github.com/Turfjs/turf/pull/708)
• @turf/rewind Rewind LineString or Polygon outer ring ~clockwise~ counter-clockwise and inner rings ~counterclockwise~ clockwise (https://github.com/Turfjs/turf/pull/700 & https://github.com/Turfjs/turf/issues/66)
• @turf/isobands - Takes a grid FeatureCollection of Point features with z-values and an array of value breaks and generates filled contour isobands. (https://github.com/Turfjs/turf/pull/619)

🏅 New Features

• New function convertDistance to @turf/helpers (https://github.com/Turfjs/turf/pull/732)
• Add ignoreBoundary param @turf/inside (https://github.com/Turfjs/turf/pull/706)
• Add flattenEach/flattenReduce to @turf/meta. (https://github.com/Turfjs/turf/pull/712 & https://github.com/Turfjs/turf/issues/692)
• New Feature getGeom & getGeomType in @turf/invariant (https://github.com/Turfjs/turf/pull/720)
• Adds round(), radians2degrees() and degrees2radians() to turf-helpers (https://github.com/Turfjs/turf/pull/715)
• ⭐️ New Add FeatureCollection & GeometryCollection support to @turf/rewind (https://github.com/Turfjs/turf/pull/741)

🐛 Bug Fixes

• Fix @turf/circle translate properties (https://github.com/Turfjs/turf/pull/717)
• Apply equidistance @turf/buffer to polygons (https://github.com/Turfjs/turf/issues/660 & https://github.com/Turfjs/turf/pull/718)
• Fix jsts empty (Multi)Polygon error @turf/difference (https://github.com/Turfjs/turf/pull/725)
• Support Geometry Objects & Collection (https://github.com/Turfjs/turf/issues/710)
  • @turf/line-intersect (https://github.com/Turfjs/turf/pull/731)
  • @turf/line-chunk (https://github.com/Turfjs/turf/pull/726)
  • @turf/line-segment (https://github.com/Turfjs/turf/pull/727 & https://github.com/Turfjs/turf/pull/711)
  • @turf/line-overlap (https://github.com/Turfjs/turf/pull/711)
• New Reverse winding - Polygon CCW & Polygon CW @turf/rewind (https://github.com/Turfjs/turf/pull/741)
• ⭐️ New Fix Feature GeometryCollection to @turf/buffer (https://github.com/Turfjs/turf/pull/739)
• ⭐️ New Re-enable negative radius to @turf/buffer (https://github.com/Turfjs/turf/pull/736)