turf/packages/turf-destination
James Beard b7f1b4eafb v7.3.1
2025-11-27 17:43:27 +11:00
..
2025-05-16 08:59:12 +02:00
2017-03-05 23:40:09 -05:00
2025-11-27 17:43:27 +11:00
2025-05-16 08:59:12 +02:00

@turf/destination

destination

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

  • origin Coord starting point

  • distance number distance from the origin point

  • bearing number ranging from -180 to 180

  • options Object Optional parameters (optional, default {})

    • options.units Units Supports all valid Turf Units (optional, default 'kilometers')
    • options.properties Object Translate properties to Point (optional, default {})

Examples

var point = turf.point([-75.343, 39.984]);
var distance = 50;
var bearing = 90;
var options = {units: 'miles'};

var destination = turf.destination(point, distance, bearing, options);

//addToMap
var addToMap = [point, destination]
destination.properties['marker-color'] = '#f00';
point.properties['marker-color'] = '#0f0';

Returns Feature<Point> destination point


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

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

$ npm install @turf/turf