turf-distance

turf distance module

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
turf-distance
3.0.127 years ago10 years agoMinified + gzip package size for turf-distance in KB

Readme

turf-distance
build status
turf distance module

turf.distance(from, to, [units=kilometers])

Calculates the distance between two Point|points in degress, radians, miles, or kilometers. This uses the Haversine formula to account for global curvature.

Parameters

| parameter | type | description | | -------------------- | ------------------ | --------------------------------------------------------- | | from | Feature\.\ | origin point | | to | Feature\.\ | destination point | | [units=kilometers] | String | optional: can be degrees, radians, miles, or kilometers |

Example

var point1 = {
  "type": "Feature",
  "properties": {},
  "geometry": {
    "type": "Point",
    "coordinates": [-75.343, 39.984]
  }
};
var point2 = {
  "type": "Feature",
  "properties": {},
  "geometry": {
    "type": "Point",
    "coordinates": [-75.534, 39.123]
  }
};
var units = "miles";

var points = {
  "type": "FeatureCollection",
  "features": [point1, point2]
};

//=points

var distance = turf.distance(point1, point2, units);

//=distance

Returns Number, distance between the two points

Installation

Requires nodejs.
$ npm install turf-distance

Tests

$ npm test