Render a static map image.
Render a static map image — a map drawn server-side and returned as a PNG, WebP, or JPEG you can drop straight into an <img> tag. Pass your API key as ?key=….
The viewport is {lon},{lat},{zoom} (optionally ,{bearing},{pitch}), a bounding box [{minLon},{minLat},{maxLon},{maxLat}], or the literal auto to frame the overlays. Add markers, paths, and a circle via the query string.
Quota cost: 1 unit per image; 2 units for @2x (High-DPI).
path Parameters
styleBasemap style: light, dark, grayscale, white, or black.
position{lon},{lat},{zoom} (optionally ,{bearing},{pitch}), a bounding box [{minLon},{minLat},{maxLon},{maxLat}], or auto.
size{w}x{h}, optional @2x for High-DPI, optional .png/.webp/.jpg. Max 1280 per side.
query Parameters
markerMarker lon,lat|color|size|label (color hex no #; size s|m|l). Repeatable.
pathPath stroke:color|width:n|opacity:n|fill:color|fillOpacity:n|<geometry> (named fields, any order; geometry enc:<polyline> or lon,lat;lon,lat;…). Repeatable.
circleCircle around the center: radius:meters|stroke:color|strokeWidth:n|fill:color|fillOpacity:n.
paddingInner padding (px) when fitting a bbox or auto — 1–4 CSS-order values, e.g. 40 or 40,20,40,20.
attributionAttribution corner bottomright|bottomleft|topleft|topright, or false to omit it (you must then credit OpenStreetMap elsewhere).
langLabel language. local (default) shows native names; otherwise a language code such as en, de, fr, nl, es. Names without that language fall back to local.
labelsSet false to hide all basemap labels — place names, road labels, road shields, and POI icons — for a clean, label-free map. Default true. Markers you add keep their own labels.
Render a static map image. › Responses
Rendered map image.