Build Status

erlang-h3

The erlang-h3 library provides an Erlang binding for Uber’s H3 spatial coordinate library.

Install

Add erlang-h3 to your deps section in rebar.config:

{deps, [erlang-h3]}.

Building

Fork the repo and simply use make to build the library. You will need cmake installed to build the required h3 core package.

To run the tests run make test.

Usage

The h3 module exports most of the functions from the core H3 library.

Like the JavaScript version the Erlang binding uses degrees instead of radians when converting to and from geo-coordinates to h3 indexes.

Example using ./rebar3 shell after cloning the repo:

$ ./rebar3 shell
...

1> Paris = h3:from_geo({48.8566, 2.3522}, 9).
617550903642685439
2> h3:to_string(Paris).
"891fb466257ffff"
3> h3:to_geo(Paris).
{48.857078058197295,2.3529900909549206}