Package Exports

distance-calculator-js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (distance-calculator-js) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

distance-calculator-js

Calculate the distance between two coordinates (points).

Introduction

This library uses Haversine formula to calculate the distance between two coordinates (points).

Installing

Using yarn.

$ yarn add distance-calculator-js

Using npm.

$ npm install distance-calculator-js

Getting Started

Using import.

import DistanceCalculator from 'distance-calculator-js';

Using require.

const DistanceCalculator = require('distance-calculator-js');

Examples

calculate(coordinates1, coordinates2, [unit]).

Using import.

import DistanceCalculator from 'distance-calculator-js';

// => Signed decimal degrees without compass direction
const Tokyo = { lat: 35.652832, long: 139.839478 };
const NewYork = { lat: 40.730610, long: -73.935242 };

const m = DistanceCalculator.calculate(Tokyo, NewYork);
// => 10847782 (in metres)

If you want to use a different unit, just simply pass it as a third argument of the calculate method.

Using import.

import DistanceCalculator, { SUPPORTED_UNIT } from 'distance-calculator-js';

// => Signed decimal degrees without compass direction
const Tokyo = { lat: 35.652832, long: 139.839478 };
const NewYork = { lat: 40.730610, long: -73.935242 };

const km = DistanceCalculator.calculate(Tokyo, NewYork, 'km');
// => 10848 (in kilometres)

const ft = DistanceCalculator.calculate(Tokyo, NewYork, SUPPORTED_UNIT.ft);
// => 35589836 (in feet)

Using require.

const DistanceCalculator = require('distance-calculator-js');

// => Signed decimal degrees without compass direction
const Tokyo = { lat: 35.652832, long: 139.839478 };
const NewYork = { lat: 40.730610, long: -73.935242 };

const km = DistanceCalculator.calculate(Tokyo, NewYork, 'km');
// => 10848 (in kilometres)

const ft = DistanceCalculator.calculate(Tokyo, NewYork, DistanceCalculator.SUPPORTED_UNIT.ft);
// => 35589836 (in feet)

Warning! All values are rounded, so the distance between Tokyo and New York will be 10847782.01587274 metres and will be rounded to 10847782 metres and 10847.7820159 kilometres will be rounded to 10848 kilometres.

Supported units

This is the list of all supported units. If you want to use a different unit, just simply pass it as a third argument of the calculate method.

m (metre) - default
km (kilometre)
M (mile)
ft (foot)

License

This library is licensed under the MIT License.

Acknowledgments

Inspiration by Chris Veness / Movable Type.