overturemaps

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 on this page — 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

overturemaps on PyPI

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

Evidence: overturemaps-1.0.1-py3-none-any.whl

Keywords: GIS, geojson, geospatial, mapping, maps, opendata, overture, parquet, shapely

Tags

More Information Analysis packages