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](https://www.hsl.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](http://graphql.org/) tai [REST](https://en.wikipedia.org/wiki/Representational_state_transfer)-rajapinnan avulla - Geokoodaus-API: [Pelias](http://pelias.io/) [REST](https://en.wikipedia.org/wiki/Representational_state_transfer)-rajapinnan avulla - Kartta-API: HSL:n taustakartta TMS-palveluna ([Tile Map Service](https://wiki.osgeo.org/wiki/Tile_Map_Service_Specification)) sekä erilaiset joukkoliikenneaiheiset kohdetasot (mm. matkakortin myyntipisteet, kaupunkipyöräasemat & liityntäpysäköintipaikat) [Mapboxin vektoritiili](https://www.mapbox.com/vector-tiles/specification/)-palveluina. - Reaaliaika-API: [GTFS-RT](https://developers.google.com/transit/gtfs-realtime/) ja [MQTT](http://mqtt.org/)-syötteiden avulla Rajapinnan käyttö vaatii tunnistautumisen eli API-avaimen käyttöä. Lisätietoa ja ohjeet API-avaimen hankkimiseen [Digitransitin sivuilla](https://digitransit.fi/en/developers/api-registration/). Lisätietoja: [digitransit.fi](https://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](https://developers.google.com/transit/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.