Struct FPCoordinate

pub struct FPCoordinate {
    pub lat: i32,
    pub lon: i32,
}

A fixed-point coordinate representation for geographical locations.

This struct stores latitude and longitude as fixed-point numbers (integers multiplied by 1,000,000) to avoid floating-point precision issues while maintaining 6 decimal places of precision.

Representation

• lat: Latitude in millionths of a degree (-90.000000 to +90.000000)
• lon: Longitude in millionths of a degree (-180.000000 to +180.000000)

Examples

use toolbox_rs::geometry::FPCoordinate;

// Create from raw fixed-point values
let coord = FPCoordinate::new(40730610, -73935242);

// Create from floating-point degrees
let ny = FPCoordinate::new_from_lat_lon(40.730610, -73.935242);

// Convert back to floating-point
let (lon, lat) = ny.to_lon_lat_pair();

Fields

lat: i32

lon: i32

Implementations

impl FPCoordinate

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

pub const fn min() -> Self

pub const fn max() -> Self

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

pub fn to_lon_lat_pair(&self) -> (f64, f64)

pub fn distance(first: &FPCoordinate, second: &FPCoordinate) -> f64

pub fn to_lon_lat_vec(&self) -> Vec<f64>

pub fn distance_to(&self, other: &FPCoordinate) -> f64

Calculates the great circle distance between two coordinates using the Haversine formula

The distance is returned in kilometers.

Examples

use toolbox_rs::geometry::FPCoordinate;

// Distance between New York and San Francisco
let ny = FPCoordinate::new_from_lat_lon(40.730610, -73.935242);
let sf = FPCoordinate::new_from_lat_lon(37.773972, -122.431297);

let distance = ny.distance_to(&sf);
assert!((distance - 4140.175).abs() < 0.001); // ~4140 km

// Distance to self is always 0
assert_eq!(ny.distance_to(&ny), 0.0);

Trait Implementations

impl<'__de, __Context> BorrowDecode<'__de, __Context> for FPCoordinate

fn borrow_decode<__D: BorrowDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given BorrowDecode.

impl Clone for FPCoordinate

fn clone(&self) -> FPCoordinate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FPCoordinate

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

Formats the value using the given formatter.

impl<__Context> Decode<__Context> for FPCoordinate

fn decode<__D: Decoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.

impl Display for FPCoordinate

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

Formats the value using the given formatter.

impl Encode for FPCoordinate

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), EncodeError>

Encode a given type.

impl PartialEq for FPCoordinate

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

impl Eq for FPCoordinate

impl StructuralPartialEq for FPCoordinate