Skip to content
Calculates the destination point given one point feature, distance in degrees, radians, miles, or kilometers, and bearing in degrees.
Branch: master
Clone or download
tcql Merge pull request #2 from Turfjs/add-si-km
added SI spelling of km -- kilometre
Latest commit 6b255c9 Jan 6, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
.travis.yml
LICENSE
README.md
bench.js
index.js
package.json
test.js

README.md

turf-destination

build status

turf destination module

turf.destination(start, distance, bearing, units)

Takes a Point and calculates the location of a destination point given a distance in degrees, radians, miles, or kilometers; and bearing in degrees. This uses the Haversine formula to account for global curvature.

Parameters

parameter type description
start Feature.<Point> starting point
distance Number distance from the starting point
bearing Number ranging from -180 to 180
units String miles, kilometers, degrees, or radians

Example

var point = {
  "type": "Feature",
  "properties": {
    "marker-color": "#0f0"
  },
  "geometry": {
    "type": "Point",
    "coordinates": [-75.343, 39.984]
  }
};
var distance = 50;
var bearing = 90;
var units = 'miles';

var destination = turf.destination(point, distance, bearing, units);
destination.properties['marker-color'] = '#f00';

var result = {
  "type": "FeatureCollection",
  "features": [point, destination]
};

//=result

Returns Feature.<Point>, destination point

Installation

Requires nodejs.

$ npm install turf-destination

Tests

$ npm test
You can’t perform that action at this time.