Static Maps API

Our Static Maps API is a great way to make maps with a custom location and size.

The URL format for the Static Maps API is:

https://tile.thunderforest.com/static/{style}/{lon},{lat},{zoom}/{width}x{height}{scale}.{format}?apikey={apikey}

style

The id for the map style, e.g. cycle or transport

lon

The longitude of the centre of the map, in decimal degrees

lat

The latitude of the centre of the map, in decimal degrees

zoom

The zoom level of the map. Range from 0 to 22 inclusive.

width

The width of the map, in pixels. Maximum width is 2560 pixels.

height

The height of the map, in pixels. Maximum height is 2560 pixels.

scale

(optional) The scale modifier, e.g. @2x. When omitted, a scale of 1 is used.

format

The image format, e.g. .png or .jpg90

apikey

Your API Key

Retina Static Maps

The scale parameter allows you to request ‘retina’ or ‘hidpi’ static maps. For example, setting the scale to @2x will return static maps at double scale, but otherwise showing exactly the same features and labels.