Starting from 3.4.2023, use of Digitransit APIs will require registration. The registration is now open. More information
Topics:

Background map

Background map provides HSL style map tiles for example for browser based applications.

Data format

Raster maps are available in Tile Map Service format

Note: Background map is also available as vector tiles from source hsl-vector-map in OpenMapTiles schema. Styles used by HSL can be found on: https://github.com/HSLdevcom/hsl-map-style

Endpoint

https://cdn.digitransit.fi/map/v2/:source/:z/:x/:y:size.png

Supported URL parameters

Parameter Type Description
source string Source layer. See choices below. E.g., hsl-map or hsl-vector-map
z int Zoom level
x int x-coordinate
y int y-coordinate
size string '@2x' for retina tiles or empty value for normal

Sources

Value Description
hsl-map 512px raster tiles with Finnish language
hsl-map-256 256px raster tiles with Finnish language
hsl-map-sv 512px raster tiles with Swedish language
hsl-map-sv-256 256px raster tiles with Swedish language
hsl-map-fi-sv 512px bilingual raster tiles with Finnish / Swedish language
hsl-map-fi-sv-256 256px bilingual raster tiles with Finnish / Swedish language
hsl-map-no-text 512px raster tiles with no texts
hsl-map-no-text-256 256px raster tiles with no texts
hsl-map-greyscale 512px grayscale raster tiles with Finnish language
hsl-map-greyscale-256 256px grayscale raster tiles with Finnish language
hsl-map-greyscale-no-text 512px grayscale raster tiles with no texts
hsl-map-greyscale-256-no-text 256px grayscale raster tiles with no texts
hsl-vector-map Vector tiles

Examples

An example of what the HSL map tiles look like

hsl-map-style

HSL style map tiles

https://cdn.digitransit.fi/map/v2/hsl-map/16/37313/18958.png

Retina tiles

https://cdn.digitransit.fi/map/v2/hsl-map/16/37313/18958@2x.png

Swedish language tiles

https://cdn.digitransit.fi/map/v2/hsl-map-sv/16/37313/18958.png

Bilingual Finnish / Swedish language tiles

https://cdn.digitransit.fi/map/v2/hsl-map-fi-sv/16/37313/18958.png