Metadata-Version: 2.1
Name: geodesk
Version: 0.0.1
Summary: Python port of GeoDesk, a fast and space-efficient statial database engine for OpenStreetMap features
Home-page: https://github.com/clarisma/geodesk
Author: Martin Desmond
Author-email: martindesmond@gmail.com
Description-Content-Type: text/markdown

# GeoDesk for Python (Preview Release, Alpha Sept. 2023)

GeoDesk is a fast and storage-efficient geospatial database for OpenStreetMap data.

## Why GeoDesk?

- **Small storage footprint** &mdash; GeoDesk's GOL files are only 20% to 50% larger than the original OSM data in PBF format &mdash; that's less than a tenth of the storage consumed by a traditional SQL-based database.

- **Fast queries** &mdash; typically 50 times faster than SQL. 

- **Fast to get started** &mdash; Converting `.osm.pbf` data to a GOL is 20 times faster than an import into an SQL database. Alternatively, download pre-made data tiles for just the regions you need and automatically assemble them into a GOL.

- **Intuitive API** &mdash; No need for object-relational mapping; GeoDesk queries return Python objects. Quickly discover tags, way-nodes and relation members. Get a feature's geometry, measure its length/area. 
 
- **Proper handling of relations** &mdash; (Traditional geospatial databases deal with geometric shapes and require workarounds to support this unique and powerful aspect of OSM data.)

- **Seamless integration with Shapely** for advanced geometric operations, such as buffer, union, simplify, convex and concave hulls, Voronoi diagrams, and much more.

- **Modest hardware requirements** &mdash; If it can run a 64-bit Python, it'll run GeoDesk.
 
## Get Started

### Download

```
pip install geodesk
```

