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

Base URL

https://velmap.com

Place snapshot

GET https://velmap.com/v1/static/place?c=38.72230,-9.13930&style=standard&zoom=13&width=1200&height=630

Route snapshot

GET https://velmap.com/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 https://velmap.com/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 standard, light, muted, gray, paper, or dark. Defaults to standard.
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