Struct LonLat

pub struct LonLat {
    pub lon: f64,
    pub lat: f64,
}

This class represents a point on the unit sphere as a pair of latitude-longitude coordinates. Like the rest of the “geometry” package, the intent is to represent spherical geometry as a mathematical abstraction, so functions that are specifically related to the Earth’s geometry (e.g. easting/northing conversions) should be put elsewhere.

Fields

lon: f64

longitude in degrees

lat: f64

latitude in degrees

Implementations

impl LonLat

pub fn new(lon: f64, lat: f64) -> Self

The default constructor sets the latitude and longitude to zero. This is mainly useful when declaring arrays, STL containers, etc.

pub fn from_s2cellid(cellid: &S2CellId) -> LonLat

Convert a S2CellId to an LonLat

pub fn from_s2_point(p: &S2Point) -> LonLat

Convert a direction vector (not necessarily unit length) to an LonLat.

pub fn from_axis(&self, axis: u8) -> f64

return the value of the axis

pub fn normalize(&mut self)

Normalize the coordinates to the range [-180, 180] and [-90, 90] deg.

pub fn coords(self) -> (f64, f64)

Return the latitude or longitude coordinates in degrees.

pub fn is_valid(&self) -> bool

Return true if the latitude is between -90 and 90 degrees inclusive and the longitude is between -180 and 180 degrees inclusive.

pub fn to_point(&self) -> S2Point

Converts an LonLat to the equivalent unit-length vector. Unnormalized values (see Normalize()) are wrapped around the sphere as would be expected based on their definition as spherical angles. So for example the following pairs yield equivalent points (modulo numerical error): (90.5, 10) =~ (89.5, -170) (a, b) =~ (a + 360 * n, b) The maximum error in the result is 1.5 * DBL_EPSILON. (This does not include the error of converting degrees, E5, E6, or E7 to radians.)

Can be used just like an S2Point constructor. For example: S2Cap cap; cap.AddPoint(S2Point(latlon));

pub fn to_point_gl(&self) -> S2Point

An alternative to to_point() that returns a GPU compatible vector.

pub fn get_distance(&self, b: &LonLat) -> f64

Returns the distance (measured along the surface of the sphere) to the given LonLat, implemented using the Haversine formula. This is equivalent to

S1Angle(ToPoint(), o.ToPoint())

except that this function is slightly faster, and is also somewhat less accurate for distances approaching 180 degrees (see s1angle.h for details). Both LngLats must be normalized.

Trait Implementations

impl Add<f64> for LonLat

type Output = LonLat

The resulting type after applying the + operator.

fn add(self, rhs: f64) -> Self::Output

Performs the + operation.

impl Add for LonLat

type Output = LonLat

The resulting type after applying the + operator.

fn add(self, rhs: LonLat) -> Self::Output

Performs the + operation.

impl Clone for LonLat

fn clone(&self) -> LonLat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LonLat

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

Formats the value using the given formatter.

impl Default for LonLat

fn default() -> LonLat

Returns the “default value” for a type.

impl Div<f64> for LonLat

type Output = LonLat

The resulting type after applying the / operator.

fn div(self, rhs: f64) -> Self::Output

Performs the / operation.

impl Div for LonLat

type Output = LonLat

The resulting type after applying the / operator.

fn div(self, rhs: LonLat) -> Self::Output

Performs the / operation.

impl From<&LonLat> for S2Point

fn from(lonlat: &LonLat) -> Self

Converts to this type from the input type.

impl From<&S2CellId> for LonLat

fn from(c: &S2CellId) -> Self

Converts to this type from the input type.

impl From<&S2Point> for LonLat

fn from(p: &S2Point) -> Self

Converts to this type from the input type.

impl From<LonLat> for S2CellId

fn from(value: LonLat) -> Self

Converts to this type from the input type.

impl Mul<LonLat> for f64

type Output = LonLat

The resulting type after applying the * operator.

fn mul(self, rhs: LonLat) -> Self::Output

Performs the * operation.

impl Mul<f64> for LonLat

type Output = LonLat

The resulting type after applying the * operator.

fn mul(self, rhs: f64) -> Self::Output

Performs the * operation.

impl Neg for LonLat

type Output = LonLat

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Ord for LonLat

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for LonLat

fn eq(&self, other: &LonLat) -> bool

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

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 PartialOrd for LonLat

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Sub<f64> for LonLat

type Output = LonLat

The resulting type after applying the - operator.

fn sub(self, rhs: f64) -> Self::Output

Performs the - operation.

impl Sub for LonLat

type Output = LonLat

The resulting type after applying the - operator.

fn sub(self, rhs: LonLat) -> Self::Output

Performs the - operation.

impl Copy for LonLat

impl Eq for LonLat

impl StructuralPartialEq for LonLat