`GET /v1/static-map`: render a map view to an image.
Request
- Base URL: https://api.mapmap.ai
- URL: https://api.mapmap.ai/v1/static-map
- Auth: api_key (a scheme the document does not define)
Query parameters
Camera centre as lon,lat; requires zoom
Zoom level 0-20, required with center
Fit the camera to west,south,east,north instead of center/zoom
WxH in pixels, up to 1280 on either side; append @2x for double pixel density
Camera bearing in degrees
Camera pitch in degrees, capped at 85
A first-party base id: light (default), dark, streets, midnight, navigator-day, navigator-night, fleet, outdoor, dataviz, backdrop or print. fleet is the palette only: its vehicle-restriction overlay is a mapmap.ai runtime layer and no rendered image carries it. Or 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
png (default), webp or jpeg
1-100 for the lossy formats
Encoded polyline overlay (alias polyline)
Polyline precision: 6 (default, POST /route) or 5 (GET /route/v1)
GeoJSON overlay; repeatable, or send the value in a POST body
lon,lat[,label[,colour]] pins, ;-separated, up to 50
Satellite imagery where the pilot region has coverage
3D building extrusions; pair with a pitch
local, or an ISO 639 code, for map labels
0/false hides POI labels, 1/true shows them; omitted, the chosen style decides (the navigator, dataviz and backdrop bases draw none)
Response
The rendered image, with the renderer's own ETag and Cache-Control
Changes
No recorded changes to this operation across all 1 revision of this API.