t# geo-uri-rs

A Rust crate (geo-uri) for uniform resource identifiers for geographic locations (geo URIs) according to IEEE RFC 5870. This crate allows for parsing and generating geo URIs in the correct format. Its parser is currently somewhat more liberal than the proposed standard.

It supports geolocations specified by latitude and longitude, but also optionally altitude and an uncertainty radius. The currently only supported coordinate reference system is WGS-84.

Usage

Just run the following to add this library to your project:

sh $ cargo add geo-uri Updating crates.io index Adding thiserror v??? to dependencies.

Parsing

Use either the FromStr or TryFrom traits to parse a geo URI string:

```rust use geo_uri::GeoUri;

let geouri = GeoUri::tryfrom("geo:52.107,5.134,3.6;u=1000").expect("valid geo URI"); asserteq!(geouri.latitude(), 52.107); asserteq!(geouri.longitude(), 5.134); asserteq!(geouri.altitude(), Some(3.6)); asserteq!(geouri.uncertainty(), Some(1000.0));

use std::str::FromStr; let geouri = GeoUri::fromstr("geo:52.107,5.134;u=2000.0").expect("valid geo URI"); asserteq!(geouri.latitude(), 52.107); asserteq!(geouri.longitude(), 5.134); asserteq!(geouri.altitude(), None); asserteq!(geouri.uncertainty(), Some(2000.0)); ```

It is also possible to call the parse function directly:

```rust use geo_uri::GeoUri;

let geouri = GeoUri::parse("geo:52.107,5.134,3.6").expect("valid geo URI"); asserteq!(geouri.latitude(), 52.107); asserteq!(geouri.longitude(), 5.134); asserteq!(geouri.altitude(), Some(3.6)); asserteq!(geo_uri.uncertainty(), None); ```

Generating

Use the GeoUriBuilder to construct a GeoUri struct.

Then, use either the ToString or Display trait to generate an geo URI string:

```rust use geo_uri::GeoUri;

let geouri = GeoUri::builder() .latitude(52.107) .longitude(5.134) .uncertainty(1000.0) .build() .unwrap(); asserteq!( geouri.tostring(), String::from("geo:52.107,5.134;u=1000") ); asserteq!( format!("{geo_uri}"), String::from("geo:52.107,5.134;u=1000") ); ```

License

geo-uri-rs is licensed under the MIT license (see the LICENSE file or http://opensource.org/licenses/MIT).