Skip to content

Minutely Extracts

About

Minutely Extracts is an on-demand downloader for raw OpenStreetMap data, built from minute-level planet snapshots. It's a simple web frontend to a Protomaps-hosted OSM Express database.

Downloads are provided in PBF format, which is interoperable with most tooling, such as:

Try Geofabrik Downloads if you need less frequently updated data clipped to administrative boundaries.

Programmatic API

Access to the API is enabled on request: please contact support@protomaps.com to request access.

Usage is free for non-commercial, academic research and OSM community applications.

Your application should make a POST request to the endpoint https://app.protomaps.com/api/v1/extracts with a JSON payload.

The JSON payload should include:

  1. a key token with your API token from the Dashboard.

  2. a key region with a JSON object having keys type and data:

    • if type is bbox, data is an array of numbers: [min_lat,min_lon,max_lat,max_lon]

    • if type is geojson, data is a GeoJSON Geometry object with a single Polygon feature.

Example CURL request:

curl -v -X POST https://app.protomaps.com/api/v1/extracts -d '{"token":"MY_TOKEN","region":{"type":"bbox","data":[40.732693,-74.029169,40.798011,-73.943897]}}'

A successful API response will have a key uuid and another key url which returns a progress endpoint. It should be polled until the key Complete appears.

Finally, the download URL can be retrieved via POST to https://app.protomaps.com/api/v1/extracts/<UUID> with token again in the JSON payload.

curl -v -X POST https://app.protomaps.com/api/v1/extracts/UUID -d '{"token":"MY_TOKEN"}'

The result object will have a url key with a temporary link to download the file.