Newbiz4finland Sissonen, Pärssinen - joukkoliikennedata

Joukkoliikennedata
Kalle Sissonen & Rikhard Pärssinen

HSL Reittioppaan rajapinta

•  Tuottajana Helsingin Seudun Liikenne

•  Avoin rajapinta ollut käytettävissä vuodesta 2001

•  Uudistettu versio käyttöön 2010

•  HSL tarjoaa myös:

•  HSL joukkoliikennedatan paketti

•  Poikkeusinfon rajapinta

•  Omat lähdöt –palvelun rajapinta

•  HSL Live –palvelun rajapinta

© Logica 2012. All rights reserved NewBiz4Finland-työpaja, 7.9.2012


Kehittäjäsivusto – http://developer.reittiopas.fi

•  Rekisteröityminen rajapinnan käyttäjäksi

•  Tunnus käytettävissä heti

•  Kapasiteettirajoitus väärinkäytösten estämiseksi

•  Sama tunnus kaikkiin rajapintoihin

•  Rajapintojen kuvaukset ja ohjeet



Kalkati.net XML datapaketti

•  HSL joukkoliikenteen data standardissa XML-muodossa

•  Päivitetään Reittioppaan latauksen yhteydessä

•  Esimerkki:

•  http://www.youtube.com/watch?v=qGllzWt0acU



Yleistä rajapinnasta
•  Merkistökoodaus UTF-8
•  JSON tai XML -muotoiset vastaukset
•  WGS84 koordinaatisto
•  Versionhallinta
•  Kyselytyypit:
•  Geokoodaus
•  Käänteinen geokoodaus
•  Pysäkkitiedot
•  Linjatiedot
•  Pysäkit alueelta
•  Pyöräily- ja kävelyreititys
•  Reititys
•  Datan voimassaolo
•  Tilastot rajapinnan käytöstä

Ohjeet:
http://developer.reittiopas.fi/pages/en/http-get-interface-version-2.php


Geokoodaus

•  Osoitteen tai paikannimen muuntaminen koordinaateiksi
•  Mukana osoitteet, pysäkit ja kiinnostavia paikkoja
•  Mukautettu levenshtein virheenkorjaus

Käänteinen geokoodaus

•  Lähimmät osoiteet, pysäkit tai kiinnostavat paikat annetuista
koordinaateista



Pysäkkitiedot

•  Haku pysäkin koodilla
•  Tuloksena pysäkin nimi, osoite, koordinaatit, lista ohittavista
linjoista, esteettömyystietoja jne.
•  Tuloksessa myös pysäkin seuraavia lähtöjä
•  Voidaan rajata päivämäärän ja kellonajan mukaan

Linjatiedot

•  Haku linjan JORE-koodilla, yleisötunnuksella, nimellä sekä
joukkoliikennelajilla
•  Tuloksessa esim. linjojen nimet, reitit pysäkkeinä tai koordinaatteina
sekä linkit aikataulusivuille



Pysäkit alueelta

•  Pysäkkien koordinaatit ja muita tietoja annetulta alueelta
•  Alue määritellään antamalla keskikoordinaatti ja alueen halkaisija

Pyöräily- ja kävelyreititys

•  Reititys kahden tai useamman koordinaatin kautta
•  Tuloksessa reittipisteet, reitin päällystetyypit, korkeudet, tieto ali/
ylikulusta



Reititys
•  Reitti joukkoliikenteellä kahden tai kolmen pisteen välille
•  Paljon erilaisia säätömahdollisuuksia erilaisille tarpeille
•  Yksinkertaisimmillaan annetaan vain lähtö- ja päätepisteen
koordinaatit, muut parametrit hoituvat oletusasetuksilla

Datan voimassaolo
•  Rajapinnan tietojen voimassaoloaika

Tilastot
•  Oman kapasiteetin käytön tarkastelu


Reittiopas-rajapinta Tampereella

Julkaisu NewBiz4Finland-työpajassa 12.09.2012

•  Tuottajana Tampereen kaupunki

•  Täydentää Tampereen joukkoliikenteen e-palveluita

•  Tietosisältö Repa Reittioppaasta

•  Tekninen toteutus vastaa HSL:n Reittioppaan rajapintaa


Erot Tampereen ja HSL:n rajapinnoissa

Tampere HSL

•  Vaatii omat käyttäjätunnukset
•  Joukkoliikennetiedot tarjolla vain suomen kielellä
•  Tampereella käytössä vain yksi pysäkkikoodi à JORE koodi HSL:n oma
•  Ei esteettömyystietoja
•  Ei vyöhykelippurajoituksia
•  Ei Palvelulinjojen aikatauluja

Mitä tarkoittaa kehittäjälle?
•  Tietyt ominaisuudet eivät ole käytössä
•  Ei tuettujen ominaisuuksien käyttö ei aiheuta virheitä
•  Rajapintojen harmonisointi à Sovellukset helposti käyttöönotettavissa toisessa
rajapinnassa

© Logica 2012. All rights reserved

Lisätietoja

Developer-sivu
http://developer.publictransport.tampere.fi

API
http://api.publictransport.tampere.fi

Repa
http://reittiopas.tampere.fi

Tampereen joukkoliikenteen e-palvelut
http://joukkoliikenne.tampere.fi


Matka.fi rajapinta

Julkaisu NewBiz4Finland-työpajassa 12.09.2012

•  Tuottajana Liikennevirasto

•  Tavoitteena jakaa julkishallinnon tietovarastoja joukkoliikenteen osalta

•  Sovelluskehitys, testaus ja kaupallinen hyödyntäminen ilmaista

•  Tietosisältö koko maan kattavasta Matka.fi-reitityspalvelusta


Tietosisältö

•  HSL (Helsinki, Espoo, Kauniainen, Vantaa, Kerava, Kirkkonummi, Sipoo)
•  Kaupungit Tampere, Joensuu, Lappeenranta, Turku, Mikkeli, Oulu, Vaasa, Kotka
•  Matkustajajunaliikenne VR:ltä
•  Linja-autoliikenne ELY:n alueellisilta viranomaisilta
•  Kotimaan lentoliikenne Finavialta

•  Seuraavien kaupunkialueiden voimassaolo päättyy vuoden 2012 lopussa *
•  Kuopio
•  Jyväskylä
•  Lahti
•  Imatra
•  Pori
•  Varkaus
•  Hämeenlinna
•  Hyvinkää
•  Seinäjoki

* Liikennevirasto parantaa jatkuvasti aineiston kattavuutta ja laatua. Edellä mainituille kaupunkialueille
pyritään saamaan jatkoa myös vuodelle 2013.


Matka.fi rajapinnan käyttö

•  Rajapinnan käyttö vaatii omat tunnukset

•  Joukkoliikenneaikatauluaineistot tarjolla kahdella eri tavalla:
•  HTTP-rajapinta
•  Kalkati.net formaatissa oleva xml tiedosto

•  Käytössä rajapinnasta versio 1 (HSL:llä ja Tampereella versio 2)
•  Vastausformaattina XML
•  Tuettuna koordinaattijärjestelmänä vain KKJ3
•  Suppeampi toiminnallisuus


Käyttöliittymän ja rajapinnan välillä eroja

•  Tasa-arvoiset reittiehdotukset à Reittituloksissa vaihtoehdot lennolle,
junalle ja linja-autolle. Rajapinta palauttaa vain nopeimmat
reititystulokset.

•  Haettaessa reittiä yöllä palauttaa käyttöliittymä aamun ensimmäisen
julkista liikennettä sisältävän vaihtoehdon. Rajapinta palauttaa pelkkää
kävelyä

•  Käyttöliittymässä ei näytetä lyhyitä kävelytyksiä reittitulosten luettavuuden
parantamiseksi

•  Rajapinnassa ei näytetä vuorojen selitteitä


Lisätietoja

Developer-sivu
http://developer.matka.fi

API
http://api.matka.fi

Matka.fi
http://www.matka.fi

Liikennevirasto
http://beta.liikennevirasto.fi


Kysymyksiä?
kalle.sissonen@logica.com
rikhard.parssinen@logica.com

Newbiz4finland Sissonen, Pärssinen - joukkoliikennedata

Recommandé

Recommandé

Contenu connexe

En vedette

En vedette (14)

Plus de Apps4Finland

Plus de Apps4Finland (20)

Newbiz4finland Sissonen, Pärssinen - joukkoliikennedata