17 unstable releases (5 breaking)
0.6.4 | May 10, 2024 |
---|---|
0.6.2 | Mar 31, 2024 |
0.4.0 | Aug 9, 2023 |
0.3.4 | Jul 28, 2023 |
0.3.1 | Mar 17, 2023 |
#6 in Geospatial
21,132 downloads per month
Used in 8 crates
3MB
8K
SLoC
h3o
Rust implementation of the H3 geospatial indexing system.
Design
This is not a binding of the reference implementation, but a reimplementation from scratch.
The goals are:
- To be safer/harder to misuse by leveraging the strong typing of Rust.
- To be 100% Rust (no C deps): painless compilation to WASM, easier LTO, …
- To be as fast (or even faster when possible) than the reference library.
Installation
Cargo
- Install the rust toolchain in order to have cargo installed by following this guide.
- run
cargo install h3o
Usage
use h3o::{LatLng, Resolution};
let coord = LatLng::new(37.769377, -122.388903).expect("valid coord");
let cell = coord.to_cell(Resolution::Nine);
Why this name?
Rust is an iron oxide. A Rust version of H3 is an H3 oxide, in other word $H_3O$ (a.k.a hydronium). Chemically speaking this is wrong ( $H_3O$ is produced by protonation of $H_2O$, not oxidation of $H_3$), but ¯\(ツ)/¯