fast-haversine

    1.0.0 • Public • Published

    Fast haversine

    The fastest implementation of the haversine algorithm to calculate distances between to coordinates.

    Install

    npm install fast-haversine

    Basic usage

    Given two coordinates, i.e. departure and arrival of a infamous helicopter trip, calculate the distance in meters:

    const distance = require('fast-haversine');
     
    const from = { lat: -34.607814, lon: -58.370301 };
    const to = { lat: -34.5161001, lon: -58.4847728 };
     
    distance(from, to); // quickly returns 14640 m

    API

    distance(from, to)

    Calculates the distance between the to given coordinates.

    The coordinates are objects containing lat and lon properties.

    Returns a number representing the distance in meters.

    Benchmarks

    Like benchmarks? Then run npm run benchmark. Current results are:

    $ npm run benchmark
    
    [ { name: '../lib', time: '100%', dist: '100%' },
      { name: 'haversine-distance', time: '139%', dist: '99%' },
      { name: 's-haversine', time: '151%', dist: '99%' },
      { name: 'gps-distance', time: '163%', dist: '99%' },
      { name: 'haversine', time: '190%', dist: '99%' },
      { name: 'geodesy', time: '221%', dist: '99%' },
      { name: 'coordist', time: '302%', dist: '100%' },
      { name: 'geodist', time: '307%', dist: '99%' },
      { name: 'node-geo-distance', time: '535%', dist: '99%' },
      { name: 'jeyo-distans', time: '828%', dist: '99%' } ]
    

    Install

    npm i fast-haversine

    DownloadsWeekly Downloads

    220

    Version

    1.0.0

    License

    WTFPL

    Last publish

    Collaborators

    • gabmontes