Skip to content

50,000 free calls a month, card-free. Get an API key →

Documentation menu
docs / examples / static-map-image
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