https://github.com/transitland/mapzen-geohash
Python package containing simple tools for encoding and decoding geohashes
https://github.com/transitland/mapzen-geohash
geohash python
Last synced: 4 months ago
JSON representation
Python package containing simple tools for encoding and decoding geohashes
- Host: GitHub
- URL: https://github.com/transitland/mapzen-geohash
- Owner: transitland
- License: mit
- Created: 2015-03-03T21:28:10.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-04-18T02:13:58.000Z (6 months ago)
- Last Synced: 2025-05-30T00:19:08.893Z (5 months ago)
- Topics: geohash, python
- Language: Python
- Homepage: https://pypi.python.org/pypi/mzgeohash
- Size: 11.7 KB
- Stars: 63
- Watchers: 9
- Forks: 21
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Mapzen Geohash
[](https://circleci.com/gh/transitland/mapzen-geohash)
A geohash is a convenient method for encoding geographic coordinates, where each character in the geohash adds additional precision. This makes geohashes well suited for indexing mechanisms, grouping geographically located entities, and compactly encoding coordinates based on the level of detail required.
More information about Geohashes:
* http://www.movable-type.co.uk/scripts/geohash.html
* http://en.wikipedia.org/wiki/Geohash
* http://geohash.org/
This Python package contains simple tools for encoding and decoding geohashes.
## Installation
Installation using pip:
```
pip install mzgeohash
```
Alternatively, [download from PyPi](https://pypi.python.org/pypi/mzgeohash) or clone this repository, and install using setup.py:
```
python ./setup.py install
```
## Example usage
```
>>> import mzgeohash
>>> mzgeohash.decode('xn76urwe1g9y')
(139.76608408614993, 35.681382017210126)
>>> mzgeohash.encode((139.76608408614993, 35.681382017210126))
'xn76urwe1g9y'
>>> mzgeohash.neighbors('xn76urwe1g9y')
{'c': 'xn76urwe1g9y',
'e': 'xn76urwe1gdn',
'n': 'xn76urwe1g9z',
'ne': 'xn76urwe1gdp',
'nw': 'xn76urwe1g9x',
's': 'xn76urwe1g9v',
'se': 'xn76urwe1gdj',
'sw': 'xn76urwe1g9t',
'w': 'xn76urwe1g9w'}
```
## Contributing
Please [open a Github issue](https://github.com/transitland/mapzen-geohash/issues/new) with as much of the following information as you're able to specify, or [contact us](#contact) for assistance.
## Contact
Transitland is sponsored by [Mapzen](http://mapzen.com). Contact us with your questions, comments, or suggests: [hello@mapzen.com](mailto:hello@mapzen.com).