@turf/rhumb-bearing

What is @turf/rhumb-bearing?

@turf/rhumb-bearing is a module from the Turf.js library that calculates the bearing between two geographical points along a rhumb line (a line of constant bearing). This is useful for navigation and mapping applications where you need to determine the direction from one point to another.

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

Calculate Rhumb Bearing

This feature calculates the rhumb bearing between two geographical points. The code sample demonstrates how to use the `rhumbBearing` function to find the bearing from point1 to point2.

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

const point1 = turf.point([0, 0]);
const point2 = turf.point([10, 10]);
const bearing = turf.rhumbBearing(point1, point2);
console.log(bearing);

Other packages similar to @turf/rhumb-bearing

geolib

Geolib is a library for geospatial calculations. It provides a variety of functions for distance, bearing, and other geographical calculations. Unlike @turf/rhumb-bearing, Geolib offers a broader range of geospatial utilities but may not be as specialized in rhumb line calculations.

geodesy

Geodesy is a library for geodesic and rhumb line calculations. It offers detailed and precise methods for calculating distances, bearings, and other geospatial metrics. Compared to @turf/rhumb-bearing, Geodesy provides more comprehensive geodesic calculations but may be more complex to use.

README

@turf/rhumb-bearing

rhumbBearing

Takes two points and finds the bearing angle between them along a Rhumb line i.e. the angle measured in degrees start the north line (0 degrees)

Parameters

• start (Geometry | Feature<Point> | Array<number>) starting Point
• end (Geometry | Feature<Point> | Array<number>) ending Point
• final [boolean] calculates the final bearing if true (optional, default false)

Examples

var point1 = {
  "type": "Feature",
  "properties": {
    "marker-color": "#F00"
  },
  "geometry": {
    "type": "Point",
    "coordinates": [-75.343, 39.984]
  }
};
var point2 = {
  "type": "Feature",
  "properties": {
    "marker-color": "#00F"
  },
  "geometry": {
    "type": "Point",
    "coordinates": [-75.534, 39.123]
  }
};

var bearing = turf.rhumbBearing(point1, point2);

//addToMap
point1.properties.bearing = bearing
point2.properties.bearing = bearing
var addToMap = [point1, point2]

Returns number bearing from north in decimal degrees, between -180 and 180 degrees (positive clockwise)

---

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-bearing

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

$ npm install @turf/turf

Changelog

4.4.0

🚀 New Modules

• @turf/line-offset Adds a new lineOffset module as per this issue. Basically takes an input line and returns a new line offset by the distance. (PR https://github.com/Turfjs/turf/pull/729 - Author @rowanwins)
• @turf/polygonize Polygonizes (Multi)LineString(s) into Polygons. Implementation of GEOSPolygonize function (geos::operation::polygonize::Polygonizer). (PR https://github.com/Turfjs/turf/pull/767 - Author @NickCis)
• @turf/transform-rotate Rotates any geojson Feature or Geometry of a specified angle, around its centroid or a given pivot point; all rotations follow the right-hand rule. (Issue https://github.com/Turfjs/turf/issues/747 - Author @stebogit)
• @turf/transform-translate Moves any geojson Feature or Geometry of a specified distance along a Rhumb Line on the provided direction angle. (Issue https://github.com/Turfjs/turf/issues/747 - Author @stebogit)
• @turf/transform-scale Scale a GeoJSON from a given point by a factor of scaling (ex: factor=2 would make the GeoJSON 200% larger). If a FeatureCollection is provided, the origin point will be calculated based on each individual Feature. (Issue https://github.com/Turfjs/turf/issues/747 - Author @stebogit)

🏅 New Features

• Support z-coordinate as input for @turf/turf-tin (PR https://github.com/Turfjs/turf/pull/772)
• Adds properties parameter to @turf/centroid and @turf/center (PR https://github.com/Turfjs/turf/pull/769)
• Include Yarn.lock for all modules & Lerna uses Yarn (Issue https://github.com/Turfjs/turf/issues/704, https://github.com/Turfjs/turf/issues/765, PR https://github.com/Turfjs/turf/pull/766)
• Use Tap at root which enables code coverage reports (Issue https://github.com/Turfjs/turf/issues/328 & PR https://github.com/Turfjs/turf/pull/762)
• Support z-coordinate as input for @turf/pointplane (PR https://github.com/Turfjs/turf/pull/754)
• Add core tests - file management & package.json rules (PR https://github.com/Turfjs/turf/pull/749 & https://github.com/Turfjs/turf/pull/756)

🐛 Bug Fixes

• Website http://turfjs.org is back up and running (Issue https://github.com/Turfjs/turf/issues/777)
• @turf/rhumb-destination issue at 180th meridian (Issue https://github.com/Turfjs/turf/issues/770 & PR https://github.com/Turfjs/turf/pull/771)
• Getting too large numbers for Longitude (Issue https://github.com/Turfjs/turf/issues/758 & PR https://github.com/Turfjs/turf/pull/763)
• Throw error if FeatureCollection not array #751 (PR https://github.com/Turfjs/turf/pull/760)
• Change default param coordinates to 3 @turf/truncate (PR https://github.com/Turfjs/turf/pull/757)
• along returns a point that is not found by @turf/point-on-line (Issue https://github.com/Turfjs/turf/issues/691)
• Fix location of intersect point for @turf/point-on-line. (PR https://github.com/Turfjs/turf/pull/750)
• Handle empty geometries as undefined @turf/buffer (PR https://github.com/Turfjs/turf/pull/746)