gps-distance

gps-distance

A node module for performing distance calculations between GPS coordinates

Installation

npm install gps-distance

Examples

gps-distance supports two syntaxes for convenience. You can measure just between two points and supply in your GPS coordinates as direct arguments to distance in the form (source_lat, source_lon, destination_lat, destination_lon), or you can use an array of points each in [lat,lon] format. See the examples below.

Point to Point

var distance = require('gps-distance');

// Measure between two points:
var result = distance(45.527517, -122.718766, 45.373373, -121.693604);

// result is 81.78450202539503

Array of GPS points

// Measure a list of GPS points along a path:
var path = [
  [45.527517, -122.718766],
  [45.373373, -121.693604],
  [45.527517, -122.718766]
];

var result2 = distance(path);

// result2 is 163.56900405079006

Measuring Distance From a .GPX File

To compute the distance travelled in a tracked GPX file, use gps-distance with the gpx-stream module ( http://npmjs.org/package/gpx-stream/ ).

var GPXstream = require('gpx-stream');
var distance = require('gps-distance');

var points = new GPXstream();
var source = fs.createReadStream('./marathon.gpx');
var path = [];

source.pipe(points);

points.on('readable', function() {
  var point;

  while(point = points.read()) {
    path.push([point.lat, point.lon]);
  }
});

points.on('end', function() {
  console.log('Distance travelled: ' + distance(path) + ' km');
});

Notes

Distances are returned in kilometers and computed using the Haversine formula.