Struct WGS84

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

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: RealFieldCopy> 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: RealFieldCopy, 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: RealFieldCopy + 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 duplicate of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<N, T> Sub<T> for WGS84<N>

where N: RealFieldCopy, 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: RealFieldCopy> Sub 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: RealFieldCopy + SubAssign, T: Into<ENU<N>>,

fn sub_assign(&mut self, right: T)

Performs the -= operation.

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

impl<N> StructuralPartialEq for WGS84<N>