DMS Coordinates

Rust package to manipulate D°M'S'' coordinates.

Basic usage

Single coordinate:

let dms = DMS::new(40, 43, 50.196_f64, 'N') // NY latitude
    .unwrap();
prinln!("{:#?}", dms);
prinln!("{}", dms.get_degrees());
prinln!("{}", dms.to_decimal_degrees());
prinln!("{}", dms.get_bearing());

Build D°M'S'' from decimal degrees coordinates

let dms = DMS::from_decimal_degrees(-73.935242_f64); // NY longitude
println!("{}", dms.get_seconds());
assert_eq!(dms.get_bearing(), 'N'); // 'N' bearing
assert_eq!(dms.get_degrees(), 73); // NY::lon D°
assert_eq!(dms.get_minutes(), 56); // NY::lon M'

3D coordinates

let dms = DMS3d::from_decimal_degrees(
    40.730610_f64, // NY
    -73.935242_f64, // NY
    Some(10.0)
);
assert_eq!(dms.latitude.get_degrees(), 40); // NY
assert_eq!(dms.latitude.get_minutes(), 43); // NY
assert_eq!(dms.latitude.get_bearing(), 'N');
assert!((dms.latitude.get_seconds() - 50.1960).abs() < 1E-3);
assert_eq!(dms.longitude.get_degrees(), 73); // NY
assert_eq!(dms.longitude.get_minutes(), 56); // NY
assert_eq!(dms.longitude.get_bearing(), 'W');
assert!((dms.longitude.get_seconds() - 6.8712).abs() < 1E-3);

(Projected) Distance (m) between two 3D coordinates:

let new_york = DMS3d::from_decimal_degrees(
    40.730610_f64,
    -73.935242_f64,
    Some(10.0)
);
let paris = DMS3d::from_decimal_degrees(
    48.856614, 
    2.3522219,
    Some(10.0)
);
println!("{}", new_york.distance(paris) / 1000.0);