---
id: overturemaps
version: "1.0.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# overturemaps — Python tools for interacting with Overture Maps (overturemaps.org) data.

License: permissive · Maintenance: active · Downloads: 88.0K/mo

## What it is and what it does

Overturemaps is the official Python CLI and library for the Overture Maps Foundation's free, open geospatial dataset. It downloads normalized map data (building footprints, POI places, and other types) directly from S3 with optional geographic filtering via bounding box, then converts to GeoJSON, GeoParquet, or GeoJSONSeq formats. The tool uses Parquet summary statistics to minimize data transfer for bounded queries.

You can use it as a command-line tool (e.g., `overturemaps download --bbox=... --type=building -f geojson -o file.geojson`) or as a Python library to stream data into pyarrow RecordBatchReader objects, geopandas GeoDataFrames, or custom writers. It depends on click, colorama, numpy, orjson, pyarrow, pyfiglet, shapely, and tqdm, and requires Python 3.10+. The project is marked experimental, so interfaces may change before a stable release.

Use it for:

- Download building footprints for a city or region and export as GeoJSON for web mapping or GIS analysis.
- Extract POI (place) data within a bounding box and load directly into a geopandas GeoDataFrame for spatial analysis.
- Stream large Overture datasets to GeoParquet format for efficient columnar storage and downstream processing.
- Query a specific feature by UUID using the GERS Registry lookup and export in your preferred format.
- Integrate Overture map data into a Python geospatial pipeline without manual S3 access or format conversion.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Download and convert Overture Maps geospatial data to GeoJSON, GeoParquet, or GeoJSONSeq formats, with optional bounding-box filtering and Python API access.

Yes. Low install friction, active maintenance, MIT license, no known vulnerabilities, and direct access to a major open geospatial dataset make this a solid choice for map data workflows. The experimental status is transparent and documented; interfaces may shift, but the core functionality is stable enough for production use if you track releases.

## Install

pip install overturemaps
uv add overturemaps
poetry add overturemaps

## Installing overturemaps

Before you install: Low install friction: pure Python wheel with eight common dependencies (click, colorama, numpy, orjson, pyarrow, pyfiglet, shapely, tqdm). Active maintenance—last commit 2026-08-11, release 45 days old, no archived status.

License in practice: MIT license (permissive): you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install overturemaps

from overturemaps import record_batch_reader

bbox = (-71.068, 42.353, -71.058, 42.363)
reader = record_batch_reader("building", bbox=bbox)
table = reader.read_all()

Requires Python 3.10 or later; pyarrow is a runtime dependency for Arrow-based access.

Verify before relying:

- Whether geopandas integration (GeoDataFrame) is available without explicit opt-in installation.
- Performance characteristics for very large bounding boxes or full-dataset downloads.
- Stability guarantees given the project's stated experimental status and likelihood of interface changes.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 88.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

download geospatial map data, overture maps python, geojson geospatial conversion, opendata geospatial tools, building footprints download, poi places data extraction, geoparquet geojson conversion, bounding box geospatial query, geospatial-data, open-data, cli-tool

[View on SkillFed](https://skillfed.io/packages/overturemaps) · [View on PyPI](https://pypi.org/project/overturemaps/)