GeoRust
A rust library for geocoding and reverse geocoding using the GeoNames dataset.
Usage
Run
Then you can use the library like this:
use ;
use ;
Documentation is available at docs.rs
Features
- Calculate the haversine distance between two locations
- Get the nearest postcode to a location
- Get the location of a postcode
- Get all postcodes within a certain radius of a location
- Get the nearest place to a location
- Get the location of a place
- Get all places within a certain radius of a location
- Get all PostalData structs within a certain radius of a location
Configuration
The library uses a cache directory to store downloaded GeoNames data.
By default, it uses a directory named geonames in the system's temporary directory.
You can override this by setting the GEOCODER_CACHE_DIR
environment variable.
To disable caching entirely, set the DISABLE_GEOCODER_CACHE
environment variable to any value.
Please note, you are encouraged to "be a good neighbour" and use caching to reduce the load on the GeoNames servers.
Contributing
Contributions are welcome! Please open an issue or submit a pull request.