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

```rust 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 $H3O$ (a.k.a hydronium). Chemically speaking this is wrong ( $H3O$ is produced by protonation of $H2O$, not oxidation of $H3$), but ¯\(ツ)/¯

License

BSD 3-Clause