h3 3.6.1a1

Hierarchical hexagonal geospatial indexing system

h3-py

Python bindings for the H3 Core Library.

For API reference, please see the H3 Documentation.

NOTE: This version (v.3.6.1) corresponds to the new Cython bindings, which will replace the old bindings (v3.4.3). This version is not yet published to PyPI.

Install from PyPI

TODO: instructions for installing from pre-built wheels

Install from GitHub

You need to have cc, make, cmake, and git in your $PATH when installing this package.

Then run:

pip install git+https://github.com/uber/h3-py.git

Try the library with:

>>> import h3
>>> h3.geo_to_h3(0, 0, 0)
'8075fffffffffff'

NumPy support

h3 has no runtime dependencies on other libraries, so a standard pip install will install no additional libraries.

The optional h3.api.numpy_int API requires numpy. To have numpy installed (if it isn't already) along with h3, run:

pip install git+https://github.com/uber/h3-py.git[numpy]

or

pip install git+https://github.com/uber/h3-py.git[all]

Example gallery

Browse a collection of example notebooks, and if you have examples or visualizations of your own, please feel free to contribute!

We also have a simple walkthrough of the API. For more information, please see the H3 Documentation.