Static Maps

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).

get/styles/v1/{style}/static/{position}/{size}

Request

  • Base URL: https://api.rijwind.com
  • URL: https://api.rijwind.com/styles/v1/{style}/static/{position}/{size}
  • Auth: HTTP bearer

Path parameters

stylestring required

Basemap style: light, dark, grayscale, white, or black.

positionstring required

{lon},{lat},{zoom} (optionally ,{bearing},{pitch}), a bounding box [{minLon},{minLat},{maxLon},{maxLat}], or auto.

sizestring required

{w}x{h}, optional @2x for High-DPI, optional .png/.webp/.jpg. Max 1280 per side.

Query parameters

markerstring

Marker lon,lat|color|size|label (color hex no #; size s|m|l). Repeatable.

pathstring

Path stroke:color|width:n|opacity:n|fill:color|fillOpacity:n|<geometry> (named fields, any order; geometry enc:<polyline> or lon,lat;lon,lat;…). Repeatable.

circlestring

Circle around the center: radius:meters|stroke:color|strokeWidth:n|fill:color|fillOpacity:n.

paddingstring

Inner padding (px) when fitting a bbox or auto — 1–4 CSS-order values, e.g. 40 or 40,20,40,20.

attributionstring

Attribution corner bottomright|bottomleft|topleft|topright, or false to omit it (you must then credit OpenStreetMap elsewhere).

langstring

Label 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.

labelsboolean

Set 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.

Response

Rendered map image.

Changes

No recorded changes to this operation across all 1 revision of this API.