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 (reittiopas.fi) 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 HSL:n 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. GTFS-muotoiset poiminnat löytyvät täältä.

Liikennetiedotteet

HSL News API tarjoaa hsl.fi -sivustolla julkaistut uutiset ja liikennetiedotteet json-formaatissa. Tietoa ajamattomista vuoroista löytyy puolestaan yllämainituista reittioppaan rajapinnoista esim. reititys-APIn disruption-info & reaaliaika-APIn service-alerts.