Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/uber/h3-py
Python bindings for H3, a hierarchical hexagonal geospatial indexing system
https://github.com/uber/h3-py
geocoding geospatial gis h3 hexagonal-architecture python uber
Last synced: about 2 months ago
JSON representation
Python bindings for H3, a hierarchical hexagonal geospatial indexing system
- Host: GitHub
- URL: https://github.com/uber/h3-py
- Owner: uber
- License: apache-2.0
- Created: 2018-06-12T22:39:59.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-05-19T17:00:27.000Z (about 2 months ago)
- Last Synced: 2024-05-19T17:42:38.925Z (about 2 months ago)
- Topics: geocoding, geospatial, gis, h3, hexagonal-architecture, python, uber
- Language: Python
- Homepage: https://uber.github.io/h3-py
- Size: 27.9 MB
- Stars: 763
- Watchers: 31
- Forks: 127
- Open Issues: 76
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- Contributing: docs/contributing.md
- License: LICENSE
Lists
- my-awesome-stars - uber/h3-py - Python bindings for H3, a hierarchical hexagonal geospatial indexing system (Python)
- awesome-stars - uber/h3-py - Python bindings for H3, a hierarchical hexagonal geospatial indexing system (Python)
README
# **h3-py**: Uber's H3 Hexagonal Hierarchical Geospatial Indexing System in Python
[](https://badge.fury.io/py/h3)
[](https://pypistats.org/packages/h3)
[](https://anaconda.org/conda-forge/h3-py)
[](https://github.com/uber/h3/releases/tag/v3.7.1)
[](https://github.com/uber/h3-py/blob/master/LICENSE)
[](https://github.com/uber/h3-py/actions)
[](https://codecov.io/gh/uber/h3-py)
----
## ANNOUNCEMENT: v4.0.0 beta released!
Install the latest beta version with `pip install h3 --pre`
or with
`pip install 'h3==4.0.0b3'`.
Feedback is welcome via
[Issues](https://github.com/uber/h3-py/issues/new),
[Discussions](https://github.com/uber/h3/discussions),
and
[Slack](https://join.slack.com/t/h3-core/shared_invite/zt-g6u5r1hf-W_~uVJmfeiWtMQuBGc1NNg).
----
Python bindings for the [H3 core library](https://h3geo.org/).
- Documentation: [uber.github.io/h3-py](https://uber.github.io/h3-py)
- GitHub repo: [github.com/uber/h3-py](https://github.com/uber/h3-py)
## Installation
From [PyPI](https://pypi.org/project/h3/):
```console
pip install h3
```
From [conda](https://github.com/conda-forge/h3-py-feedstock):
```console
conda config --add channels conda-forge
conda install h3-py
```
## Usage
```python
>>> import h3
>>> lat, lng = 37.769377, -122.388903
>>> resolution = 9
>>> h3.latlng_to_cell(lat, lng, resolution)
'89283082e73ffff'
```
## APIs
[api_comparison]: https://uber.github.io/h3-py/api_comparison
[api_reference]: https://uber.github.io/h3-py/api_reference
We provide [multiple APIs][api_comparison] in `h3-py`.
- All APIs have the same set of functions;
see the [API reference][api_reference].
- The APIs differ only in their input/output formats;
see the [API comparison page][api_comparison].
## Example gallery
Browse [a collection of example notebooks](https://github.com/uber/h3-py-notebooks),
and if you have examples or visualizations of your own, please feel free
to contribute!
[walkthrough]: https://nbviewer.jupyter.org/github/uber/h3-py-notebooks/blob/master/notebooks/usage.ipynb
We also have an introductory [walkthrough of the API][walkthrough].
## Versioning
`h3-py` wraps the [H3 core library](https://github.com/uber/h3),
which is written in C.
The C and Python projects each employ
[semantic versioning](https://semver.org/),
where versions take the form `X.Y.Z`.
The `h3-py` version string is guaranteed to match the C library string
in both *major* and *minor* numbers (`X.Y`), but may differ on the
*patch* (`Z`) number.
This convention provides users with information on breaking changes and
feature additions, while providing downstream bindings (like this one!)
with the versioning freedom to fix bugs.
Use `h3.versions()` to see the version numbers for both
`h3-py` and the C library. For example,
```python
>>> import h3
>>> h3.versions()
{'c': '3.6.3', 'python': '3.6.1'}
```