Struct Orthodrome 

pub struct Orthodrome {
    pub lon1: f64,
    pub lat1: f64,
    pub lon2: f64,
    pub lat2: f64,
    pub a: f64,
    pub dist: f64,
}

Orthodrome

Description

Represents an orthodrome, which is the shortest path between two points on a sphere.

Learn more here

Usage

The methods you have access to:

• Orthodrome::new: Create a new Orthodrome
• Orthodrome::from_points: Create an orthodrome from two points. The points must implement the GetXY trait
• Orthodrome::intermediate_point: input t 0->1. Find a point along the orthodrome.
• Orthodrome::bearing: returns the bearing in degrees between the two points
• Orthodrome::distance_to: Finds the distance between the two points in kilometers projected normalized (0->1)

The properties you have access to:

• Orthodrome::lon1: start longitude in radians
• Orthodrome::lat1: start latitude in radians
• Orthodrome::lon2: end longitude in radians
• Orthodrome::lat2: end latitude in radians
• Orthodrome::a: distance property
• Orthodrome::dist: distance property

use gistools::{geometry::LonLat, tools::Orthodrome};

let ortho = Orthodrome::new(-60., -40., 20., 10.);
assert_eq!(ortho.intermediate_point::<LonLat>(0.), LonLat::new(-59.99999999999999, -40., None));
assert_eq!(
    ortho.intermediate_point::<LonLat>(0.2),
    LonLat::new(-39.13793657428956, -33.728521975616516, None)
);

NOTE

There is no reason to use this outside verbosity. You can create an S1Angle or use the utility functions in LonLat

Links

• http://www.movable-type.co.uk/scripts/latlong.html

Fields

lon1: f64

start longitude in radians

lat1: f64

start latitude in radians

lon2: f64

end longitude in radians

lat2: f64

end latitude in radians

a: f64

distance property

dist: f64

distance property

Implementations

impl Orthodrome

pub fn new( start_lon: f64, start_lat: f64, end_lon: f64, end_lat: f64, ) -> Orthodrome

Create an orthodrome

pub fn from_points<P1: GetXY, P2: GetXY>(p1: &P1, p2: &P2) -> Orthodrome

Create an orthodrome from two points

The points must implement the GetXY trait

pub fn intermediate_point<P: NewXY>(&self, t: f64) -> P

input t 0->1. Find a point along the orthodrome.

Parameters

• t: distance along the orthodrome to find

Returns

Returns any Point type that implements the NewXY. X is the longitude in degrees. Y is the latitude in degrees.

pub fn bearing(&self) -> f64

returns the bearing in degrees between the two points

pub fn distance_to(&self) -> f64

Finds the distance between the two points in kilometers projected normalized (0->1)

Returns

The total distance between the two points

Trait Implementations

impl Clone for Orthodrome

fn clone(&self) -> Orthodrome

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Orthodrome

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Orthodrome

fn default() -> Orthodrome

Returns the “default value” for a type.