GET/v1/static-map

API key required, sent as api_key.

Call it

bash

curl -fsS -X GET "https://api.mapmap.ai/v1/static-map" \
  -H "Authorization: Bearer $MAPMAP_KEY"

Name	In	Required	Description
center	query	no	Camera centre as `lon,lat`; requires `zoom`
zoom	query	no	Zoom level 0-20, required with `center`
bbox	query	no	Fit the camera to `west,south,east,north` instead of `center`/`zoom`
size	query	no	`WxH` in pixels, up to 1280 on either side; append `@2x` for double pixel density
bearing	query	no	Camera bearing in degrees
pitch	query	no	Camera pitch in degrees, capped at 85
style	query	no	`light` (default), `dark`, a hosted style id (optionally `@version`; resolved before the render, so an id this deployment does not host is a fast 404 and is not billed), or an https:// style URL on an allowlisted MapMap host
format	query	no	`png` (default), `webp` or `jpeg`
quality	query	no	1-100 for the lossy formats
route	query	no	Encoded polyline overlay (alias `polyline`)
precision	query	no	Polyline precision: 6 (default, `POST /route`) or 5 (`GET /route/v1`)
geojson	query	no	GeoJSON overlay; repeatable, or send the value in a POST body
markers	query	no	`lon,lat[,label[,colour]]` pins, `;`-separated, up to 50
satellite	query	no	Satellite imagery where the pilot region has coverage
buildings3d	query	no	3D building extrusions; pair with a `pitch`
lang	query	no	`local`, or an ISO 639 code, for map labels
pois	query	no	`0`/`false` hides POI labels

200The rendered image, with the renderer's own ETag and Cache-Control

304Not modified (the request carried a matching If-None-Match)

400The renderer rejected the parameters (problem+json); no image was drawn and the units are returned

404style named a hosted style id this deployment does not host (problem+json); refused before any render, so the units are returned

504The renderer produced no image within the deadline (problem+json); a cold start, so retry once

Error bodies follow the shared problem model documented on API conventions.

Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId get_static_map