static-maps

`GET /v1/static-map`: render a map view to an image.

get/v1/static-map

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

centerstring

Camera centre as lon,lat; requires zoom

zoomnumber double

Zoom level 0-20, required with center

bboxstring

Fit the camera to west,south,east,north instead of center/zoom

sizestring

WxH in pixels, up to 1280 on either side; append @2x for double pixel density

bearingnumber double

Camera bearing in degrees

pitchnumber double

Camera pitch in degrees, capped at 85

stylestring

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

formatstring

png (default), webp or jpeg

qualityinteger

1-100 for the lossy formats

routestring

Encoded polyline overlay (alias polyline)

precisioninteger

Polyline precision: 6 (default, POST /route) or 5 (GET /route/v1)

geojsonstring

GeoJSON overlay; repeatable, or send the value in a POST body

markersstring

lon,lat[,label[,colour]] pins, ;-separated, up to 50

satelliteboolean

Satellite imagery where the pilot region has coverage

buildings3dboolean

3D building extrusions; pair with a pitch

langstring

local, or an ISO 639 code, for map labels

poisboolean

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.