Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Reittiopas ja Digitransit-rajapinnat APIKAssa

Reittiopas ja Digitransit-rajapinnat APIKAssa

APIKAn API-seminaari

Tuukka Hastrup

January 28, 2016
Tweet

More Decks by Tuukka Hastrup

Other Decks in Technology

Transcript

  1. Reaaliaika-APIt tulossa • Kaikki ajoneuvot − Paikannus − Kuljettajapääte •

    Liityntäpysäköinti − Paikkatilanne − Ennuste ➔ Reittioppaan ehdotukset – Ei enää peruttuja vuoroja – Myöhästymiset huomioitu
  2. 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
  3. 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ä)
  4. 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)
  5. 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)
  6. 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
  7. 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