Documentation menu
Example
Static map image
A rendered PNG of a view, a route or a GeoJSON overlay, from one URL and no API key. Built for agents, which can look at a map but cannot run a renderer.
bash
# A website endpoint, not the gateway: no $BASE, no API key.
# A plain city view.
curl -fsS "https://mapmap.ai/api/static-map?center=-0.1276,51.5072&zoom=13&size=800x500" \
-o map.png
# A route you already hold. Watch the precision: GET /route/v1 returns an
# encoded polyline at precision 5, POST /route and the MCP route tool return
# precision 6, and 6 is this endpoint's default. A precision-5 string passed
# through without precision=5 decodes silently to the wrong place.
curl -fsS "https://mapmap.ai/api/static-map?route=$ROUTE_GEOMETRY&precision=5&size=800x500" \
-o route.png
# POST when the overlay is too big for a URL, which a real isochrone is.
# The POST body IS the GeoJSON: a Feature, a FeatureCollection, a bare
# geometry or an array of those. Wrapping it in an envelope object is a 400.
curl -fsS -X POST "https://mapmap.ai/api/static-map?size=1000x640&pois=false" \
-H "Content-Type: application/json" \
--data @isochrone-response.json \
-o reach.png