Reittiopas ja Digitransit-rajapinnat APIKAssa

APIKAn API-seminaari

Transcript

1. Tuukka Hastrup 2016-01-28 Reittiopas ja Digitransit-raja- pinnat APIKAssa
2. Reaaliaika-APIt tulossa • Kaikki ajoneuvot − Paikannus − Kuljettajapääte • Liityntäpysäköinti − Paikkatilanne − Ennuste ➔ Reittioppaan ehdotukset – Ei enää peruttuja vuoroja – Myöhästymiset huomioitu
4. Digitransit-alusta
6. Reitit Aikataulut Analyysit Peruspalvelu Sovellukset ja palvelut Palveluiden valvonta (data + APIt + käyttöliittymä) Liikennesuunnittelu Reittien laskenta Reititysrajapinta (API) Liikennedatan tuottaminen, rajapinnat ja hyödyntäminen Avoin data Uudentyyppiset palvelut Viranomaisen vastuulla Kolmannet osapuolet Poikkeusinfo Pysäkkiennusteet Ajoneuvojen sijainnit
7. Nykyisiä rajapintoja • Aikojen saatossa avattu palvelukohtaisia rajapintoja • HSL:n vanhat: Reittiopas, Poikkeusinfo (XML), Omat lähdöt (SOAP), HSL Live (CSV) • HSL:n kokeilulliset: navigator-server (Faye/Bayeux, SIRI JSON) • VR:n Junat kartalla (GeoRSS) • Liikenneviraston rata.digitraffic.fi (JSON, osin STOMP) • Muut kaupungit: Tampere, Oulu, Turku (3 SIRIä)
8. http://junat.dy.fi/liikenne/naytto/HKI
9. Avoimen reittioppaan uusia rajapintoja • Aikataulut, reititys: OpenTripPlanner (JSON+GraphQL) • Reaaliaikadata (SIRI JSON) • Push-rajapinta (MQTT, myös websocket ja HTTP GET) • Geokooderi (JSON) • Karttatiilet (rasteri- ja vektori)
10. Ajoneuvot kartalle
11. MQTT Esimerkkiviestin sisältö (JSON-muoto): {"tsi":1431417982,"spd":5,"lat":60.17052,"long":24.94359,"dl":52 ..} Aiherakenne (MQTT topic): /hfp/journey/type/id/line/direction/headsign/start_time/ next_stop/geohash Esimerkkiviestin aihe: /hfp/journey/bus/67bf46c0/1055/1/Koskela/1105/ 1020169/60;24/19/74/03 Esimerkkitilauksia: /hfp/journey/# (kaikki viestit) /hfp/journey/+/+/1055/1/# (linja 55 Koskelan suuntaan) /hfp/journey/+/+/+/+/+/+/+/60;24/19/# (geohash-karttaruutu)
14. Lähdekoodi (github.com/HSLdevcom) • digitransit: dokumentaatiota • digitransit-ui: käyttöliittymä (HTML5, React) • digitransit-deploy: pilvipalvelun asennus (Docker) • digitransit-benchmark: kuormitustestaus • digitransit-site: projektin kotisivu • digitransit-map: OpenStreetMap-karttatyyli • navigator-server: Publish-subscribe for realtime data
15. APIKA-kokemuksia • Alkaa olla vaivaton käyttää • Täyttää perustarpeen Toiveita: • API-avaimen käytön pitäisi olla vapaaehtoista • Linkitys APIen dokumentaatioon • api.hsl.fi, apika.hsl.fi, umbrella.hsl.fi • Organisaation rajapinnat kootusti
16. HSL Developer Community dev.hsl.fi
17. Kiitos! dev.hsl.fi digitransit.fi tuukka.hastrup@hsl.fi