Struct GeoCoord 

pub struct GeoCoord {
    pub lat: f64,
    pub lon: f64,
    pub alt: f64,
}

A geographic coordinate in WGS-84 (latitude / longitude in degrees, altitude in meters).

Construction

Method	Validation	Altitude
new	debug_assert only	explicit
from_lat_lon	debug_assert only	0.0
new_checked	returns Option	explicit
From<(f64, f64)>	debug_assert only	0.0
From<(f64, f64, f64)>	debug_assert only	explicit
From<[f64; 2]>	debug_assert only	0.0
From<[f64; 3]>	debug_assert only	explicit

Default

Default returns Null Island: (0, 0, 0).

Display

Formats as "51.100000 N 17.000000 E 100.0m" (absolute lat/lon with hemisphere suffix).

Fields

lat: f64

Latitude in degrees, positive north ([-90, 90]).

lon: f64

Longitude in degrees, positive east ([-180, 180]).

alt: f64

Altitude above the WGS-84 ellipsoid, in meters.

Implementations

impl GeoCoord

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

Create a new geographic coordinate.

Panics (debug only)

Debug-asserts that latitude is in [-90, 90] and longitude is in [-180, 180], with a small tolerance for floating-point rounding. In release builds the values are unchecked – use new_checked when the inputs come from untrusted sources.

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

Convenience constructor without altitude (defaults to 0.0).

pub fn new_checked(lat: f64, lon: f64, alt: f64) -> Option<Self>

Checked constructor that returns None for out-of-range values.

Valid ranges: latitude [-90, 90], longitude [-180, 180]. Altitude is unrestricted.

pub fn is_web_mercator_valid(&self) -> bool

Whether this coordinate is within the valid range for Web Mercator projection.

Returns true when |lat| <= 85.051129 and |lon| <= 180.

pub fn clamped_mercator(&self) -> Self

Clamp latitude to the Web Mercator valid range and wrap longitude to [-180, 180].

Note: latitude is clamped (saturated), but longitude is wrapped via modular arithmetic so that e.g. 200.0 becomes -160.0. Altitude is preserved unchanged.

Trait Implementations

impl Clone for GeoCoord

fn clone(&self) -> GeoCoord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GeoCoord

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

Formats the value using the given formatter.

impl Default for GeoCoord

fn default() -> Self

Returns Null Island: (lat=0, lon=0, alt=0).

impl<'de> Deserialize<'de> for GeoCoord

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for GeoCoord

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

Formats as "51.100000 N 17.000000 E 100.0m".

impl From<[f64; 2]> for GeoCoord

fn from(arr: [f64; 2]) -> Self

Create from [lat, lon] with altitude 0.

impl From<[f64; 3]> for GeoCoord

fn from(arr: [f64; 3]) -> Self

Create from [lat, lon, alt].

impl From<(f64, f64)> for GeoCoord

fn from((lat, lon): (f64, f64)) -> Self

Create from (lat, lon) with altitude 0.

impl From<(f64, f64, f64)> for GeoCoord

fn from((lat, lon, alt): (f64, f64, f64)) -> Self

Create from (lat, lon, alt).

impl From<GeoCoord> for [f64; 3]

fn from(c: GeoCoord) -> Self

Convert to [lat, lon, alt].

impl From<GeoCoord> for (f64, f64, f64)

fn from(c: GeoCoord) -> Self

Convert to (lat, lon, alt).

impl PartialEq for GeoCoord

fn eq(&self, other: &GeoCoord) -> 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 Serialize for GeoCoord

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for GeoCoord

impl StructuralPartialEq for GeoCoord