Struct nav_types::WGS84

pub struct WGS84<N> { /* fields omitted */ }

Geodetic position

This struct represents a position in the geodetic system on the WGS84 ellipsoid. See: WGS84 for more information. The serde feature allows this to be Serialized / Deserialized. If serialized into json, it will look like this. Enabled thought the serde feature

{
   "latitude": 0.0,
   "longitude": 0.0,
   "altitude": 0.0
}

Note: latitude and longitude values will be in radians

Implementations

impl<N: RealField> WGS84<N> where
    f64: From<N>, 

pub fn from_degrees_and_meters(
    latitude: N,
    longitude: N,
    altitude: N
) -> WGS84<N>

Create a new WGS84 position

Arguments

• latitude in degrees
• longitude in degrees
• altitude in meters

Panics

This will panic if latitude or longitude are not defined on the WGS84 ellipsoid.

pub fn try_from_degrees_and_meters(
    latitude: N,
    longitude: N,
    altitude: N
) -> Option<WGS84<N>>

Try to create a new WGS84 position

Arguments

• latitude in degrees
• longitude in degrees
• altitude in meters

pub fn from_radians_and_meters(
    latitude: N,
    longitude: N,
    altitude: N
) -> WGS84<N>

Create a new WGS84 position

Arguments

• latitude in radians
• longitude in radians
• altitude in meters

Panics

This will panic if latitude or longitude are not defined on the WGS84 ellipsoid.

pub fn try_from_radians_and_meters(
    latitude: N,
    longitude: N,
    altitude: N
) -> Option<WGS84<N>>

Try to create a new WGS84 position

Arguments

• latitude in radians
• longitude in radians
• altitude in meters

pub fn latitude_degrees(&self) -> N

Get latitude of position, in degrees

pub fn longitude_degrees(&self) -> N

Get longitude of position, in degrees

pub fn distance(&self, other: &WGS84<N>) -> N

Distance between two WGS84 positions

This function uses the haversin formula to calculate the distance between two positions. For more control convert to ECEF and calculate the difference.

Examples

use nav_types::WGS84;

let oslo = WGS84::from_degrees_and_meters(59.95, 10.75, 0.0);
let stockholm = WGS84::from_degrees_and_meters(59.329444, 18.068611, 0.0);

println!("Great circle distance between Oslo and Stockholm: {:?}",
    oslo.distance(&stockholm));

impl<N: Copy> WGS84<N>

pub fn altitude(&self) -> N

Get altitude of position, in meters

pub fn latitude_radians(&self) -> N

Get latitude of position, in radians

pub fn longitude_radians(&self) -> N

Get longitude of position, in radians

Trait Implementations

impl<N, T> Add<T> for WGS84<N> where
    N: RealField,
    T: Into<ENU<N>>, 

type Output = WGS84<N>

The resulting type after applying the + operator.

fn add(self, right: T) -> Self

Performs the + operation.

impl<N, T> AddAssign<T> for WGS84<N> where
    N: RealField + AddAssign,
    T: Into<ENU<N>>, 

fn add_assign(&mut self, right: T)

Performs the += operation.

impl<N: Clone> Clone for WGS84<N>

fn clone(&self) -> WGS84<N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<N: Copy> Copy for WGS84<N>

impl<N: Debug> Debug for WGS84<N>

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

Formats the value using the given formatter.

impl<N: RealField> From<ECEF<N>> for WGS84<N>

fn from(ecef: ECEF<N>) -> WGS84<N>

Performs the conversion.

impl<N: RealField> From<NVector<N>> for WGS84<N>

fn from(f: NVector<N>) -> WGS84<N>

Performs the conversion.

impl<N: RealField> From<WGS84<N>> for ECEF<N>

fn from(wgs: WGS84<N>) -> ECEF<N>

Performs the conversion.

impl<N: RealField> From<WGS84<N>> for NVector<N>

fn from(f: WGS84<N>) -> NVector<N>

Performs the conversion.

impl<N: PartialEq> PartialEq<WGS84<N>> for WGS84<N>

fn eq(&self, other: &WGS84<N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &WGS84<N>) -> bool

This method tests for !=.

impl<N> StructuralPartialEq for WGS84<N>

impl<N, T> Sub<T> for WGS84<N> where
    N: RealField,
    T: Into<ENU<N>>, 

type Output = WGS84<N>

The resulting type after applying the - operator.

fn sub(self, right: T) -> WGS84<N>

Performs the - operation.

impl<N: RealField> Sub<WGS84<N>> for WGS84<N>

type Output = ENU<N>

The resulting type after applying the - operator.

fn sub(self, right: WGS84<N>) -> ENU<N>

Performs the - operation.

impl<N, T> SubAssign<T> for WGS84<N> where
    N: RealField + SubAssign,
    T: Into<ENU<N>>, 

fn sub_assign(&mut self, right: T)

Performs the -= operation.