Solutions / Static maps

Static maps for everything beyond a map UI

Generate consistent, server-rendered map images for documents, cards, exports and notifications with the same styles and geographic results used by your application.

Live map example

Loading the Mapsource map…

Request / Response

Render a map image

Produce a PNG with a styled basemap and labeled markers for a report or preview.

API call

curl --fail-with-body "https://api.mapsource.io/render/static" \
  -H "Authorization: Bearer $MAPSOURCE_API_KEY" -H "Content-Type: application/json" \
  --data '{"lat":47.6062,"lon":-122.3321,"zoom":13,"width":900,"height":520,"style":"mapsource","markers":[{"lat":47.6062,"lon":-122.3321,"label":"A"}]}' --output map.png

Example response

HTTP/1.1 200 OK
Content-Type: image/png
Content-Length: 184203
X-Mapsource-Render: style=mapsource; engine=chromium; width=900; height=520

Render a complete viewport

Choose a center or bounding box, dimensions and style, then add markers, inline GeoJSON or a compatible result handle. Vector styles also support bearing and pitch.

Keep output reproducible

The render response carries provenance for the style, datasets, result handle and rendering engine so generated assets can be traced back to their inputs.

Service details

Built around a published contract

Inputs, outputs and limits remain inspectable in the generated API reference.

Endpoint: POST /api/render/static
Output: PNG up to 2,048 × 2,048
Overlays: Markers, GeoJSON and handles
Styles: Raster presets or vector profiles