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:
- JOSM for editing
- osm2pgsql and imposm for lossy conversion to PostgreSQL tables
- OpenTripPlanner, Valhalla, OSRM for routing
- Pelias and Photon for geocoding
- Osmium and Osmosis for general processing
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:
a key
token
with your API token from the Dashboard.a key
region
with a JSON object having keystype
anddata
:if
type
isbbox
,data
is an array of numbers:[min_lat,min_lon,max_lat,max_lon]
if
type
isgeojson
,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.