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.

Data ja resurssit

Lisätiedot

Ylläpitäjä Helsingin seudun liikenne HSL
Ylläpitäjän verkkosivusto https://twitter.com/HSLdevcom/
Julkaistu 16.03.2011
Päivitetty 28.03.2023
Päivitystiheys
Lisätietoja
  1. https://www.hsl.fi/avoindata
  2. https://digitransit.fi/
  3. https://digitransit.fi/en/developers/
  4. https://digitransit.fi/en/developers/api-registration/
Kategoriat
Datakokoelmat
Avainsanat
Alueet
Lisenssi Creative Commons Attribution 4.0
Viittaustapa Lähde: Helsingin Seudun Liikenteen (HSL) Reittiopas API. Aineiston ylläpitäjä on Helsingin seudun liikenne HSL. Aineisto on ladattu Helsinki Region Infoshare -palvelusta 22.12.2024 lisenssillä Creative Commons Attribution 4.0.
comments powered by Disqus