delivery

Render a static map

Renders a viewport and overlays as a PNG. Dark and light styles use raster tiles; other style names use vector rendering. The x-mapsource-render header includes style, dataset, result-handle, render-engine, and request metadata.

When to use: Generate static maps for reports, previews, and geographic visualizations.

When not to use: Use data endpoints for feature attributes or editable geometry.

post/render/static

Request

  • Base URL: https://api.mapsource.io
  • URL: https://api.mapsource.io/render/static
  • Auth: HTTP bearer

Request body

latnumber

Viewport centre latitude.

lonnumber

Viewport centre longitude.

zoomnumber

Zoom level.

widthinteger

Image width.

heightinteger

Image height.

stylestring

dark or light composite raster; any other name is a preset or saved profile rendered as vector.

styleRevisioninteger

Saved profile revision to use for rendering.

bearingnumber

Vector renders only.

pitchnumber

Vector renders only.

geojsonobject

GeoJSON to draw, or a result handle.

Response

Render a static map

Changes

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