Skip to main content

Parameters

Request static maps from the /api/staticmaps endpoint using the following parameters:

Required Parameters

ParameterDefaultDescription
center(required)Center of map (lon,lat, e.g. -119.49280,37.81084)
zoom(required)Zoom level (1 to 18).

Optional Parameters

ParameterDefaultDescription
width800Width of the output image in pixels. Min: 1, Max: 8192.
height800Heihgt of the output image in pixels. Min: 1, Max: 8192.
paddingX0Horizontal padding in pixels
paddingY0Vertical padding in pixels
formatpngOutput format: png, jpg, webp or pdf
quality100Image quality (0–100) for jpg/webp
basemaposmTile layer (see Basemap for supported types)
attributionAttribution text (see Attribution)
tileUrlTile URL with {x}, {y}, {z} or {quadkey} placeholders
tileSubdomains[]Tile subdomains like ['a', 'b', 'c']
tileLayers[]Multiple tile layers with tileUrl and tileSubdomains
tileSize256Size of tiles in pixels
tileRequestTimeoutTile request timeout (ms)
tileRequestHeader{}Extra headers for tile requests
tileRequestLimit2Max parallel tile requests
zoomRange{ min: 1, max: 17 }Min and max zoom to try
reverseYfalseUse TMS-style Y axis if true