2 releases
0.5.1 | May 1, 2024 |
---|---|
0.5.0 | May 1, 2024 |
#130 in Geospatial
61 downloads per month
66KB
1K
SLoC
geocoding
This is an asynchronous version of https://github.com/georust/geocoding. Maintenance of this crate is best effort.
Rust utilities to enrich addresses, cities, countries, and landmarks with geographic coordinates through third-party geocoding web services. Project is in a very early stage.
License
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
lib.rs
:
This crate provides forward– and reverse-geocoding functionality for Rust.
Over time, a variety of providers will be added. Each provider may implement one or both
of the Forward
and Reverse
traits, which provide forward– and reverse-geocoding methods.
Note that for the reverse
method, the return type is simply Option<String>
,
as this is the lowest common denominator reverse-geocoding result.
Individual providers may implement additional methods, which return more
finely-structured and/or extensive data, and enable more specific query tuning.
Coordinate data are specified using the Point
struct, which has several
convenient From
implementations to allow for easy construction using primitive types.
A note on Coordinate Order
While individual providers may specify coordinates in either [Longitude, Latitude]
or
[Latitude, Longitude
] order,
Geocoding
always requires Point
data in [Longitude, Latitude]
(x, y
) order,
and returns data in that order.
Usage of rustls
If you like to use rustls instead of OpenSSL
you can enable the rustls-tls
feature in your Cargo.toml
:
[dependencies]
geocoding = { version = "*", default-features = false, features = ["rustls-tls"] }
Dependencies
~8–19MB
~250K SLoC