Digitransit APIs require registration. More information


Map API provides raster and vector tiles in various formats.

Service Architecture

Exploring HSL map style

HSL map style is available at https://github.com/HSLdevcom/hsl-map-style.git

Readme file contains information of how to run map style on local machine.

HSL map style example:


Service dependencies

Asset Url
Routing - API https://digitransit.fi/en/developers/apis/1-routing-api/
HSL park and ride API https://www.hsl.fi/en/information/park-and-ride
HSL Ticket Sales https://data-hslhrt.opendata.arcgis.com/datasets/

Note: HSL Ticket Sales is not really an API but data that gets updated manually. The exact file is available at:


URL Project description
https://github.com/mapbox/tilejson-spec JSON format for describing map tilesets
https://github.com/mapbox/vector-tile-spec Mapbox Vector Tile specification
https://github.com/mapbox/mbtiles-spec MBTiles specification for storing tiled map data in SQLite databases for immediate usage and for transfer
https://wiki.osgeo.org/wiki/Tile\_Map\_Service_Specification Tile Map Service Specification
https://geojson.org/ GeoJSON format for encoding a variety of geographic data structures
https://github.com/mojodna/tessera Tessera development on GitHub
https://github.com/mapbox/tilelive TileLive development on GitHub
https://openmaptiles.org/ OpenMapTiles Project
https://github.com/openmaptiles/openmaptiles OpenMapTiles development on GitHub

Docker image

The resulting Docker image is called hsldevcom/hsl-map-server and it is available at DockerHub. The image can be built using this build script.

To run Docker container, run:

docker run -d -p 8080:8080 --name hsl-map-server hsldevcom/hsl-map-server

To access Docker container:


For More information about how to use Docker see docker info.

© Digitransit 2024