Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Bonsanto/polygon-geohasher
Converts a polygon into a set of geohashes with arbitrary precision.
https://github.com/Bonsanto/polygon-geohasher
Last synced: 3 months ago
JSON representation
Converts a polygon into a set of geohashes with arbitrary precision.
- Host: GitHub
- URL: https://github.com/Bonsanto/polygon-geohasher
- Owner: Bonsanto
- License: mit
- Created: 2018-01-09T15:48:42.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-06-22T19:53:22.000Z (over 2 years ago)
- Last Synced: 2024-07-27T17:57:28.265Z (4 months ago)
- Language: Python
- Size: 144 KB
- Stars: 111
- Watchers: 8
- Forks: 24
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# polygon-geohasher
Polygon Geohasher is an open source Python package for converting Shapely's
polygons into a set of geohashes. It obtains the set of geohashes
inside a polygon or geohashes that touch (intersect) the polygon. This library uses
[python-geohash](https://pypi.python.org/pypi/Geohash/) and
[shapely](http://toblerity.org/shapely/).
## Requirements
Polygon Geohasher requires:
- Python >= 3.x.
- GEOS >= 3.3 (due to shapely).
## Installing
Linux users can get Polygon Geohasher from the Python Package Index with
pip (8+):
`$ pip install polygon-geohasher`
## Usage
Here are some simple examples:
```python
from polygon_geohasher.polygon_geohasher import polygon_to_geohashes, geohashes_to_polygon
from shapely import geometry
polygon = geometry.Polygon([(-99.1795917, 19.432134), (-99.1656847, 19.429034),
(-99.1776492, 19.414236), (-99.1795917, 19.432134)])
inner_geohashes_polygon = geohashes_to_polygon(polygon_to_geohashes(polygon, 7))
outer_geohashes_polygon = geohashes_to_polygon(polygon_to_geohashes(polygon, 7, False))
```
`geohash_to_polygon(geohash)`:
This function receives a geohash and returns a Shapely's Polygon.
`geohashes_to_polygon(geohashes)`:
This function receives a set of geohashes and returns a Shapely's Polygon or MultiPolygon.
`polygon_to_geohashes(polygon, precision[, inner=True])`:
This function receives a Shapely's Polygon and the precision of geohashes
to be used to create a polygon and returns a set of geohashes
(strings) that covers said polygon. It also receives an optional
parameter `inner` that defines the way in which those polygons will be created.
If an `inner` parameter is given, then only contained geohashes will be used; otherwise,
intersected geohashes will be used.
See geohashed polygons resulting from both options (with and without `inner`) in the
following example:
