Static Image API

Render VelMap snapshots from an API call.

Use the same map parameters as an iframe embed and receive a cacheable PNG or JPEG image.

Endpoint shape

Place snapshot

GET /v1/static/place?c=38.72230,-9.13930&style=classic&zoom=13&width=1200&height=630

Route snapshot

GET /v1/static/route?stops=38.72230,-9.13930|40.41680,-3.70380&style=light&zoom=12&width=1200&height=630

Iframe alias

Add static=1 to /v1/place or /v1/route to request the same image response.

Parameters

c Place center as latitude,longitude.
stops Route stops as pipe-separated latitude,longitude pairs.
style classic, light, dark, gray, noir, topo, or print.
zoom Integer from 3 to 18.
width / height Image size from 256 to 2048 pixels.
scale 1 or 2 for standard or higher-density output.
format / quality png or jpeg. Quality is available for JPEG only.
Live demo
/v1/static
VelMap static image preview