@turf/rhumb-destination

What is @turf/rhumb-destination?

@turf/rhumb-destination is a module from the Turf.js library that allows you to calculate the destination point given a starting point, distance, and bearing using rhumb lines. Rhumb lines are paths of constant bearing, which are useful for navigation and mapping applications.

What are @turf/rhumb-destination's main functionalities?

Calculate Rhumb Line Destination

This feature allows you to calculate the destination point from a given starting point, distance, and bearing using rhumb lines. The code sample demonstrates how to use the `rhumbDestination` function to find a point 50 kilometers east of the starting point.

const turf = require('@turf/turf');

const start = turf.point([-75.343, 39.984]);
const distance = 50;
const bearing = 90;
const units = 'kilometers';

const destination = turf.rhumbDestination(start, distance, bearing, {units: units});
console.log(destination);

Other packages similar to @turf/rhumb-destination

geolib

Geolib is a library for geospatial calculations. It provides functions for distance calculations, finding the center of a collection of points, and more. Unlike @turf/rhumb-destination, Geolib does not specifically focus on rhumb lines but offers a broader range of geospatial utilities.

geodesy

Geodesy is a library for geodesic calculations. It includes functions for calculating distances, bearings, and destinations on the Earth's surface. While it provides more general geodesic calculations, it does not specifically focus on rhumb lines like @turf/rhumb-destination.

spherical-geometry-js

Spherical Geometry is a library for performing spherical geometry calculations, including distance and area calculations on the Earth's surface. It focuses on spherical rather than rhumb line calculations, making it different from @turf/rhumb-destination.

README

@turf/rhumb-destination

rhumbDestination

Returns the destination Point having travelled the given distance along a Rhumb line from the origin Point with the (constant) given bearing.

Parameters

• origin (Geometry | Feature<Point> | Array<number>) starting point
• distance number distance from the starting point
• bearing number constant bearing angle ranging from -180 to 180 degrees from north
• units [string] miles, kilometers, degrees, or radians (optional, default kilometers)

Examples

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

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

//addToMap
var addToMap = [point, destination]
destination.properties['marker-color'] = '#00F';

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 module individually:

$ npm install @turf/rhumb-destination

Or install the Turf module that includes it as a function:

$ npm install @turf/turf

Changelog

4.6.0

🚀 New Modules

• @turf/clean-coords Removes redundant coordinates from any GeoJSON Geometry. (PR https://github.com/Turfjs/turf/pull/875 - Author @stebogit)
• @turf/interpolate Takes a set of points and estimates their 'property' values on a grid using the Inverse Distance Weighting (IDW) method.. (PR https://github.com/Turfjs/turf/pull/832 - Author @stebogit)
• @turf/clusters-dbscan Takes a set of Points and partition them into clusters according to DBSCAN's data clustering algorithm. (PR https://github.com/Turfjs/turf/pull/812 and https://github.com/Turfjs/turf/pull/851 - Author @DenisCarriere)

  special mention to this incredibly instructive and fun interactive map by @DenisCarriere 😎👏

• @turf/clusters Provides getCluster, clusterEach, and clusterReduce functions. (PR https://github.com/Turfjs/turf/pull/847 - Author @DenisCarriere)
• @turf/boolean-point-on-line Returns true if a point is on a line. Accepts a optional parameter to ignore the start and end vertices of the linestring. (PR https://github.com/Turfjs/turf/pull/858 - Author @rowanwins)
• @turf/boolean-overlap Takes two features and returns true or false whether or not they overlap, i.e. whether any pair of edges on the two polygons intersect. If there are any edge intersections, the polygons overlap. (PR https://github.com/Turfjs/turf/pull/856 and https://github.com/Turfjs/turf/pull/868 - Author @stebogit @tcql)
• @turf/boolean-equal Determine whether two geometries of the same type have identical X,Y coordinate values. (PR https://github.com/Turfjs/turf/pull/869 - Author @stebogit @tcql)

🏅 New Features/Enhancements

• Sets centered param default to true in @turf/point-grid (PR https://github.com/Turfjs/turf/pull/836 - Contributor @stebogit)
• Adds MultiLineString support for @turf/point-on-line (PR https://github.com/Turfjs/turf/pull/838 - Contributor @stebogit)
• Renames @turf/clusters => @turf/clusters-kmeans, plus adds deprecated warning message to @turf/clusters@4.5.2 (See Issue https://github.com/Turfjs/turf/issues/845)
• Changes output type of @turf/clusters-kmeans (See Issue https://github.com/Turfjs/turf/issues/850 - Contributor @DenisCarriere)
• Adds segmentEach and segmentReduce functions to @turf/meta (See Issue https://github.com/Turfjs/turf/issues/850 - Contributor @DenisCarriere)
• Adds tests and linting on JSDoc in TurfJS core from turf-www; see Issue https://github.com/Turfjs/turf/issues/859 (PR https://github.com/Turfjs/turf/issues/857 + https://github.com/Turfjs/turf/issues/864 + https://github.com/Turfjs/turf/issues/870 - Contributor @DenisCarriere @stebogit)
• Introduces null Geometry support across TurfJS modules (See Issue https://github.com/Turfjs/turf/issues/853) (PR https://github.com/Turfjs/turf/issues/866 - Contributor @DenisCarriere)
• Includes feature(Sub)Index in coordEach/coordReduce (@turf/meta) 🎉 (PR https://github.com/Turfjs/turf/issues/872 - Contributor @DenisCarriere)
• Adds bbox and id params plus geometry method to @turf/helpers (PR https://github.com/Turfjs/turf/issues/877 - Contributor @DenisCarriere)

🐛 Bug Fixes

• Applies @turf/truncate to @turf/line-split splitter input to avoid approximation errors. Fixed #852 (PR https://github.com/Turfjs/turf/pull/855)
• Fixes @turf-mask error (See Issue https://github.com/Turfjs/turf/issues/837) (PR https://github.com/Turfjs/turf/pull/865 - Contributor @thiagoxvo)
• Fixes create-new-module script error on LICENSE file creation (See Issue https://github.com/Turfjs/turf/issues/861) (commit df6986e)
• Fixes @turf/isobands error on commonProperties (See Issue https://github.com/Turfjs/turf/issues/831) (commit 1663f07)