Metadata-Version: 2.4
Name: osmgeojson
Version: 0.1.0
Summary: Python SDK for the MapLark OSM GeoJSON API to query OpenStreetMap data easily.
Project-URL: Homepage, https://maplark.com
Project-URL: Repository, https://github.com/MapLark/osmgeojson-python
License: MIT
License-File: LICENSE
Keywords: geojson,geospatial,maps,openstreetmap,osm
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: click>=8.1
Requires-Dist: geojson>=3.0
Requires-Dist: httpx>=0.27
Requires-Dist: requests>=2.28
Provides-Extra: all
Requires-Dist: geopandas>=0.14; extra == 'all'
Requires-Dist: pandas>=2.0; extra == 'all'
Requires-Dist: shapely>=2.0; extra == 'all'
Provides-Extra: geo
Requires-Dist: geopandas>=0.14; extra == 'geo'
Requires-Dist: pandas>=2.0; extra == 'geo'
Requires-Dist: shapely>=2.0; extra == 'geo'
Provides-Extra: test
Requires-Dist: haversine>=2.8; extra == 'test'
Requires-Dist: networkx>=3.0; extra == 'test'
Requires-Dist: pytest-asyncio>=0.23; extra == 'test'
Requires-Dist: pytest>=7.0; extra == 'test'
Requires-Dist: python-dotenv>=1.0; extra == 'test'
Requires-Dist: responses>=0.25; extra == 'test'
Description-Content-Type: text/markdown

# osmgeojson-python

Python SDK for the **MapLark** OSM GeoJSON API with auto-pagination, bounding box chunking, retry/backoff, pandas/geopandas output, async support, and convenience methods to get common OSM data such as buildings, amenities, bike roads, etc.

```
pip install osmgeojson
pip install "osmgeojson[geo]"   # pandas / geopandas / shapely support
```

## Quick start

```python
from osmgeojson import OSMGeoJSONClient

with OSMGeoJSONClient(api_key="sk-...") as client:
    fc = client.query(bbox="18.06,59.32,18.09,59.34", tags=["building"])
    print(len(fc.features), "buildings found")
```

See the full docs for async support, bbox chunking, CLI usage, and convenience helpers.
