#coordinate #geographic #systems #convert #utm #different #mgrs

geoconvert

A lightweight library to convert between geographic coordinate systems

3 stable releases

1.0.2 Jan 23, 2024
1.0.0 Jan 7, 2024

#129 in Geospatial

Download history 68/week @ 2024-11-21 97/week @ 2024-11-28 81/week @ 2024-12-05 50/week @ 2024-12-12 24/week @ 2024-12-19 26/week @ 2024-12-26 337/week @ 2025-01-02 546/week @ 2025-01-09 109/week @ 2025-01-16 164/week @ 2025-01-23 282/week @ 2025-01-30 207/week @ 2025-02-06 153/week @ 2025-02-13 208/week @ 2025-02-20 217/week @ 2025-02-27 253/week @ 2025-03-06

882 downloads per month

MIT license

74KB
1.5K SLoC

geoconvert

Latest Version Docs

geoconvert is a lightweight library for converting between different geographic coordinate systems. Currently, there are three coordinate systems implemented:

  • LatLon
  • UtmUps
  • Mgrs

The implementation of this library is a translation of a subset of GeographicLib from C++ to Rust. Specifically, geoconvert implements some of the functionality of the GeoConvert command line tool.

Usage

You can create coordinates manually using a struct's create() function, then convert to other types using the to_*/from_* methods.

use geoconvert::{LatLon, Mgrs, UtmUps};

// This returns a result. When calling `create()`, the arguments are validated to ensure only a valid
// coordinate gets created.
let coord = LatLon::create(40.748333, -73.985278).unwrap();

// Convert to a UTM/UPS coordinate
let coord_utm = coord.to_utmups();
let coord_utm = UtmUps::from_latlon(&coord);

// Convert to an MGRS coordinate
// Note that for MGRS you must specify the precision
let coord_mgrs = coord.to_mgrs(6);
let coord_mgrs = Mgrs::from_latlon(&coord, 6);

Features

If you want serde compatibility with Serialize/Deserialize, activate the serde feature.

Testing Accuracy

To test the accuracy compared to GeographicLib yourself, you'll need a dataset of lat/lon and MGRS points. I have a gist that contains a sample dataset of ~100K points generated using Python and converted using GeoConvert. If you'd like to generate your own dataset to validate the accuracy, create files named mgrs.txt and latlon.txt, where mgrs.txt is a list of MGRS coordinates (one per line) and latlon.txt is a list of latitude longitude pairs, each pair internally delimited by a space (i.e. like <latitude> <longitude>). You can use GeoConvert to do the conversion, or use a different source for ground truth.

Once you have these files, place them into tests/ and run:

cargo test -- --include-ignored

The test will fail if the geoconvert conversion differs from the ground truth by a distance of 1mm or more (calculated using the haversine formula). It also prints the average distance error.

Dependencies

~0.7–1.3MB
~28K SLoC