Helsingin Seudun Liikenteen (HSL) Reittiopas API

Helsingin seudun liikenne (HSL) tuottaa Helsingin, Espoon, Kauniaisten, Vantaan, Keravan, Kirkkonummen, Sipoon, Tuusulan ja Siuntion joukkoliikenteen matkustajainformaation. Kaikille avoimien rajapintojen kautta on mahdollista hakea joukkoliikenteen reittejä, linjoja, aikatauluja ja ajoneuvojen sijainteja.

Reittioppaan rajapinnat tarjoavat reititykseen, geokoodaukseen, kartta-aineistoon sekä paikannukseen liittyvää dataa useamman API:n kautta. Tarjolla olevat rajapinnat:

• Reititys-API: Reititys-, linjasto- ja aikataulukyselyt joko GraphQL-API:n tai REST-rajapinnan avulla
• Geokoodaus-API: Pelias REST-rajapinnan avulla
• Kartta-API: HSL:n taustakartta TMS-palveluna (Tile Map Service) sekä erilaiset joukkoliikenneaiheiset kohdetasot (mm. matkakortin myyntipisteet, kaupunkipyöräasemat & liityntäpysäköintipaikat) Mapboxin vektoritiili-palveluina.
• Reaaliaika-API: GTFS-RT ja MQTT-syötteiden avulla

Rajapinnan käyttö vaatii tunnistautumisen eli API-avaimen käyttöä. Lisätietoa ja ohjeet API-avaimen hankkimiseen Digitransitin sivuilla.

Lisätietoja: digitransit.fi

Joukkoliikenneverkon data päivitetään HSL:n joukkoliikennerekisteristä reittioppaan taustajärjestelmiin päivittäin. OpenStreetMapin data päivitetään reitityksen, geokoodauksen ja taustakartan osalta reittioppaaseen niin ikään päivittäin. Taustakartan osalta tulokset kuitenkin näkyvät käyttäjille noin viikon viivellä erilaisista välimuistiasetuksista johtuen.

Joukkoliikennelinjasto & aikataulut (GTFS)

HSL:n joukkoliikennerekisterin data kootaan päivittäin GTFS-muotoon. Tähän poimintaan otetaan mukaan kaikki joukkoliikennereitit, joilla on voimassaoleva aikataulu. Poiminnan aikaikkuna on kulloinkin kolme kuukautta poimintaviikon alusta eteenpäin.

Liikennetiedotteet

Tietoa ajamattomista vuoroista löytyy yllämainituista reittioppaan rajapinnoista esim. reititys-APIn disruption-info & reaaliaika-APIn service-alerts.