@turf/distance

distance

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

Parameters

from (Coord | Point) origin point or coordinate
to (Coord | Point) destination point or coordinate
options Object Optional parameters (optional, default {})
- options.units string can be degrees, radians, miles, or kilometers (optional, default 'kilometers')

Examples

var from = turf.point([-75.343, 39.984]);
var to = turf.point([-75.534, 39.123]);
var options = {units: 'miles'};

var distance = turf.distance(from, to, options);

//addToMap
var addToMap = [from, to];
from.properties.distance = distance;
to.properties.distance = distance;

Returns number distance between the two points

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/distance

Or install the all-encompassing @turf/turf module that includes all modules as functions:

$ npm install @turf/turf

Current Tags

3.5.2-alpha.d2c36ee7 ... canary (8 years ago)
7.1.0 ... latest (3 months ago)
7.1.0-alpha.70 ... prerelease (3 months ago)

57 Versions

7.1.0 ... 3 months ago
7.1.0-alpha.70 ... 3 months ago
7.1.0-alpha.7 ... 5 months ago
7.0.0 ... 5 months ago
7.0.0-alpha.116 ... 6 months ago
7.0.0-alpha.115 ... 7 months ago
7.0.0-alpha.114 ... 8 months ago
7.0.0-alpha.113 ... 9 months ago
7.0.0-alpha.111 ... 10 months ago
7.0.0-alpha.110 ... a year ago
7.0.0-alpha.2 ... a year ago
7.0.0-alpha.1 ... a year ago
7.0.0-alpha.0 ... 2 years ago
6.5.0 ... 3 years ago
6.4.0 ... 3 years ago
6.3.0 ... 4 years ago
6.2.0 ... 4 years ago
6.2.0-alpha.3 ... 4 years ago
6.2.0-alpha.2 ... 4 years ago
6.2.0-alpha.1 ... 5 years ago
6.2.0-alpha.0 ... 5 years ago
6.0.1 ... 7 years ago
6.0.0 ... 7 years ago
5.1.5 ... 7 years ago
5.1.0 ... 7 years ago
5.0.4 ... 7 years ago
5.0.0 ... 7 years ago
4.7.3 ... 7 years ago
4.7.1 ... 7 years ago
4.7.0 ... 7 years ago
4.6.0 ... 7 years ago
4.5.2 ... 7 years ago
4.5.1 ... 7 years ago
4.4.0 ... 7 years ago
4.3.0 ... 8 years ago
4.2.0 ... 8 years ago
4.1.0 ... 8 years ago
4.0.1 ... 8 years ago
4.0.0 ... 8 years ago
3.14.0 ... 8 years ago
3.13.0 ... 8 years ago
3.10.5 ... 8 years ago
3.10.3 ... 8 years ago
3.10.0 ... 8 years ago
3.7.5 ... 8 years ago
3.7.3 ... 8 years ago
3.7.2 ... 8 years ago
3.7.0 ... 8 years ago
3.6.3 ... 8 years ago
3.6.1 ... 8 years ago
3.5.3 ... 8 years ago
3.5.2-alpha.d2c36ee7 ... 8 years ago
3.5.2 ... 8 years ago
3.3.3 ... 8 years ago
3.1.1 ... 8 years ago
3.0.16 ... 8 years ago
3.0.15 ... 8 years ago