Static Map Images
Render a static map image from the outdoor style. Useful for thumbnails, email previews, social cards, and reports. Each image includes automatic attribution in the bottom-right corner.
| Style | Outdoor (fixed — no style selection) |
| Max size | 2048 px per dimension (after scaling — e.g. 1024x1024 max with @2x) |
| Billing | 10 units per request |
Center-based
Render a fixed viewport at a given center coordinate and zoom level.
/static/center/{lat},{lng},{zoom}[@{bearing}[,{pitch}]]/{width}x{height}[@2x].{format}?apiKey=<key>| Parameter | Type | Description |
|---|---|---|
lat | float | Latitude of center |
lng | float | Longitude of center |
zoom | int | Zoom level (0–20) |
bearing | int | (optional) Map rotation in degrees. Prefix with @. |
pitch | int | (optional) Camera tilt (0–60°). Requires bearing. |
width | int | Image width in pixels |
height | int | Image height in pixels |
@2x | — | (optional) Double pixel density (retina) |
format | string | png, jpg, or webp |
Examples
/static/center/50.0755,14.4378,14/800x600.jpg?apiKey=<key>
/static/center/50.0755,14.4378,14@45,30/800x600@2x.png?apiKey=<key>Bounds-based
Render a map fitted to a geographic bounding box.
/static/bounds/{minlat},{minlng},{maxlat},{maxlng}/{width}x{height}[@2x].{format}?apiKey=<key>| Parameter | Type | Description |
|---|---|---|
minlat | float | South boundary |
minlng | float | West boundary |
maxlat | float | North boundary |
maxlng | float | East boundary |
width | int | Image width in pixels |
height | int | Image height in pixels |
@2x | — | (optional) Retina output |
format | string | png, jpg, or webp |
Example
/static/bounds/48.55,12.09,51.06,18.87/1200x800.jpg?apiKey=<key>Path auto-fit
Render a map that auto-fits to a sequence of coordinates (e.g. a route or track). The viewport is computed automatically with padding.
/static/path/{width}x{height}[@2x].{format}?points={coordinates}&apiKey=<key>| Parameter | Type | Description |
|---|---|---|
width | int | Image width in pixels |
height | int | Image height in pixels |
@2x | — | (optional) Retina output |
format | string | png, jpg, or webp |
points | string | URL-encoded lat,lng pairs separated by | |
Example
/static/path/800x600.png?points=50.07,14.43|50.08,14.45|50.09,14.47&apiKey=<key>Notes
- All coordinate inputs use latitude, longitude order
- Maximum dimension is 2048 px after scaling.
width× scale andheight× scale must each be ≤ 2048. For example,1200x800@2xwould fail because 1200 × 2 = 2400 > 2048. @2xdoubles the actual pixel dimensions while keeping the logical size — use for high-DPI displays- Attribution is rendered automatically into each image