TieInfo API v1.3
TieInfo API on ns. mashup palvelu, joka kerää liikenteeseen liittyvää
informaatiota monesta eri lähteestä, yhdistää ne ja tarjoaa
yhdistetyn tiedon eteenpäin. Ei erillisiä API
avaimia tai käyttäjätunnuksia; katso alta tarvitsemasi toiminnot ja
integroi palveluusi. Tieinfo APIn rajapinta on REST
tyyppinen, kevyt ja toiminnoiltaan suomenkielinen. Tienfo APIn
sisältö on joko HTML muotoista (karsittu sisältö) tai JSON muotoista
(koko sisältö, edellyttää parametrin ?json käyttämistä
rajapintakutsuissa).
Mikäli tiedät liikenteeseen liittyviä palveluja, jotka haluaisit integroida TieInfo APIin tai tarvitset apua TieInfon käytössä, ota yhteyttä sivuston
mustcode kautta.
Palautteet, bugit, toiveet ja kehityspyynnöt toivomme TieInfon
facebook sivun kautta
Referenssitoteutus TieInfo APIn toiminnoille saatavilla ilmaiseksi
app stroresta (ladatuin iPad ohjelma Suomessa 11.10.2011)
Liikenteen sujuvuustiedot
Liikenteen sujuvuustieto kertoo kuinka ruuhkaista Suomen pääteillä tällä hetkellä on. Sujuvuustieto on saatavilla linkkien kautta, jotka päivittyvät noin 5 minuutin välein
Palauttaa kaikki toimintakunnossa olevat linkit järjestelmästä
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne?{jsonp tai callback}={haluttu funktionimi}
Parametri status filtteröi syötteestä halutussa tilassa olevat linkin (arvoväli 1-5)
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne?status=1,2,3 (palauttaa kaikki linkin, joiden status on 1,2 tai 3)
Palauttaa jonkin tietyn linkin (id) tiedot
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/{linkin numero}
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/{linkin numero}?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/{linkin numero}?{jsonp tai callback}={haluttu funktionimi}
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne/1
Palauttaa annetun koordinaatin lähistöllä olevat linkit
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/koordinaatit?lat=65.0126550&lng=25.4813860
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/koordinaatit?json&lat=65.0126550&lng=25.4813860
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/koordinaatit?{jsonp tai callback}={haluttu funktionimi}&lat=65.0126550&lng=25.4813860
Palauttaa annetun koordinaatin lähistöllä olevat linkit annetulla skaalalla
(+/- arvo lat ja lng arvoihin, oletusarvo on 1.0). Myös status parametria voi käyttää
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne/koordinaatit?lat=65.0126550&lng=25.4813860&status=5&scale=0.5
Palauttaa linkit annetun paikkakunnan lähellä (Huom! käyttää Google Maps APIa, joten rajapintaa
tulee käyttää vain Googlen karttoja hyödyntävissä sovelluksissa).
Tukee myös scale parametria jolla paikkakuntarajausta voidaan muuttaa, esim scale=0.5
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/paikkakunta/{paikkakunta}
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/paikkakunta/{paikkakunta}?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/paikkakunta/{paikkakunta}?{jsonp tai callback}={haluttu funktionimi}
Palauttaa linkit annetun paikkakunnan lähellä annetulla skaalalla (+/- arvo lat&lng arvoihin, oletusarvo on 1.0).
Myös status parametria voi käyttää. (Huom! käyttää Google Maps APIa, joten rajapintaa tulee käyttää vain
Googlen karttoja hyödyntävissä sovelluksissa)
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne/paikkakunta/oulu?status=5&scale=0.1
Palauttaa linkit järjestettynä keskinopeuden mukaan (nopeimmasta hitaimpaan)
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/nopeimmat
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/nopeimmat?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/nopeimmat?{jsonp tai callback}={haluttu funktionimi}
Palauttaa halutun määrän (kpl) linkkejä järjestettynä keskinopeuden mukaan (nopeimmasta hitaimpaan)
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/nopeimmat/{kpl}
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/nopeimmat/{kpl}?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/nopeimmat/{kpl}?{jsonp tai callback}={haluttu funktionimi}
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne/nopeimmat/5
Palauttaa linkit järjestettynä keskinopeuden mukaan (hitaimmasta nopeimpaan)
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/hitaimmat
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/hitaimmat?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/hitaimmat?{jsonp tai callback}={haluttu funktionimi}
Palauttaa halutun määrän (kpl) linkkejä järjestettynä keskinopeuden mukaan (hitaimmasta nopeimpaan)
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/hitaimmat/{kpl}
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/hitaimmat/{kpl}?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/hitaimmat/{kpl}?{jsonp tai callback}={haluttu funktionimi}
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne/hitaimmat/5
Palauttaa kaikki epäkunnossa olevat linkit järjestelmästä (epäkunto == mittaustulosta ei ole saatu kuukauden sisään)
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/linkit/hajalla
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/linkit/hajalla?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/linkit/hajalla?{jsonp tai callback}={haluttu funktionimi}
Liikennemäärät
Palauttaa noin 5 minuutin välein päivittyvää tietoa liikennemääristä LAM asemilla
Palauttaa tämän hetkisen liikennemäärän järjestelmästä (LAM asemat)
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/?{jsonp tai callback}={haluttu funktionimi}
Palauttaa tämän hetkisen liikennemäärän annetulla LAM asemalla
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/{lamId}
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/{lamId}?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/{lamId}?{jsonp tai callback}={haluttu funktionimi}
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/401
Palauttaa annetun koordinaatin lähistöllä olevat LAM asemat annetulla skaalalla
(+/- arvo lat ja lng arvoihin, oletusarvo on 1.0).
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/?lat=61.405883333333335&lng=23.768633333333334&scale=0.01
Palauttaa tämän hetkisen liikennemäärän järjestelmästä tietyllä paikkakunnalla (LAM asemat).
Tukee myös scale parametria jolla paikkakuntarajausta voidaan muuttaa, esim scale=0.5
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/paikkakunta/{kaupunki}/
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/paikkakunta/{kaupunki}/?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/paikkakunta/{kaupunki}/?{jsonp tai callback}={haluttu funktionimi}
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne/maara/paikkakunta/oulu
Liikennetiedotteet
Ajankohtaisia tiedotteita liikenteeseen (tietyöt, onnettomuudet, jne). Päivittyy 5 minuutin välein
Palauttaa kaikki järjestelmässä olevat tiedotteet
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/?{jsonp tai callback}={haluttu funktionimi}
Palauttaa kaikki annettua paikkakuntaa koskevat tiedotteet (käyttää Google Maps APIa, joten rajapintaa
tulee käyttää vain Googlen karttoja hyödyntävissä sovelluksissa).
Tukee myös scale parametria jolla paikkakuntarajausta voidaan muuttaa, esim scale=0.5
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/{paikkakunta}
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/{paikkakunta}?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/{paikkakunta}?{jsonp tai callback}={haluttu funktionimi}
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/espoo
Palauttaa annetun koordinaatin lähistöllä olevat tiedotteet
HTML: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/?lat=65.0126550&lng=25.4813860
JSON: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/?json&lat=65.0126550&lng=25.4813860
JSONP: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/?{jsonp tai callback}={haluttu funktionimi}&lat=65.0126550&lng=25.4813860
Palauttaa annetun koordinaatin lähistöllä olevat tiedotteet annetulla skaalalla
(+/- arvo lat ja lng arvoihin, oletusarvo on 1.0).
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/liikenne/tiedotteet/?lat=65.0126550&lng=25.4813860&status=5&scale=0.5
Liikennesää
Reaaliaikasta säätietoa Suomen pääteille (koskien ilmaa ja tien pintaa). Sisältää tuen kelikamerakuville.
Palauttaa kaikkien järjestelmässä olevien sääasemien tiedot
HTML: http://tieinfo.mustcode.fi/tieinfo/saa/
JSON: http://tieinfo.mustcode.fi/tieinfo/saa/?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/saa/?{jsonp tai callback}={haluttu funktionimi}
Palauttaa kaikki annettua paikkakuntaa koskevat säätiedot.
Tukee myös scale parametria jolla paikkakuntarajausta voidaan muuttaa, esim scale=0.5
HTML: http://tieinfo.mustcode.fi/tieinfo/saa/paikkakunta/{paikkakunta}
JSON: http://tieinfo.mustcode.fi/tieinfo/saa/paikkakunta/{paikkakunta}?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/saa/paikkakunta/{paikkakunta}?{jsonp tai callback}={haluttu funktionimi}
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/saa/paikkakunta/oulu
Palauttaa annetun koordinaatin lähistöllä olevat säätiedot
HTML: http://tieinfo.mustcode.fi/tieinfo/saa/?lat=65.0126550&lng=25.4813860
JSON: http://tieinfo.mustcode.fi/tieinfo/saa?json&lat=65.0126550&lng=25.4813860
JSONP: http://tieinfo.mustcode.fi/tieinfo/saa?{jsonp tai callback}={haluttu funktionimi}&lat=65.0126550&lng=25.4813860
Palauttaa annetun koordinaatin lähistöllä olevat säätiedot annetulla skaalalla
(+/- arvo lat ja lng arvoihin, oletusarvo on 1.0).
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/saa?lat=65.0126550&lng=25.4813860&status=5&scale=0.5
Palauttaa kaikki sääasemien kuvalokaatiot (kelikamerakuvat on linkitetty sääasemille)
HTML: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat
JSON: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat?{jsonp tai callback}={haluttu funktionimi}
Palauttaa yhden kelikamerakuvan (704x576)
HUOM! Aina kuin mahdollista, käytä thumbnail kuvia
//asetus id (presetId) on kameran tunniste taustajärjestelmissä
HTML: http://tieinfo.mustcode.fi/tieinfo/saa/kuva/{presetId}
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/saa/kuva/C0150202
Palauttaa yhden kelikamerakuvan thumbnailin (125x102).
//asetus id (presetId) on tunniste taustajärjestelmissä
HTML: http://tieinfo.mustcode.fi/tieinfo/saa/kuva/{presetId}?thumbnail
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/saa/kuva/C0150202?thumbnail
Palauttaa kaikki annettua paikkakuntaa koskevat kelikamerakuvat
HTML: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat/paikkakunta/{paikkakunta}
JSON: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat/paikkakunta/{paikkakunta}?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat/paikkakunta/{paikkakunta}?{jsonp tai callback}={haluttu funktionimi}
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat/paikkakunta/oulu
Palauttaa annetun koordinaatin lähistöllä olevat kelikamerat
HTML: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat?lat=65.0126550&lng=25.4813860
JSON: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat?json&lat=65.0126550&lng=25.4813860
JSONP: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat?{jsonp tai callback}={haluttu funktionimi}&lat=65.0126550&lng=25.4813860
Palauttaa annetun koordinaatin lähistöllä olevat kelikamerat annetulla skaalalla
(+/- arvo lat ja lng arvoihin, oletusarvo on 1.0).
Esimerkki: http://tieinfo.mustcode.fi/tieinfo/saa/kuvat?lat=65.0126550&lng=25.4813860&status=5&scale=0.5
Gzip-tuki
Gzipin käyttäminen API kutsuissa on suositeltavaa, koska se pienentää clientin ja serverin välillä liikkuvaa datamäärää. Lisätietoa
gzipistä
//Mikäli haluat rajapintavastaukset gzipattuna, määrittele request headerissa gzip hyväksytyksi, esimerkiksi:
Accept-Encoding gzip, deflate
API Viestit
Mahdollistaa API vioista tiedottamisen suoraan asiakasohjelmistoihin. Huom! Emme tiedota turhasta, eli API viestit ovat aina tärkeitä ja ne julkaistaan myös tälle sivulle samaa rajapintaa hyödyntäen
Palauttaa kaikkien järjestelmässä olevat API viesit
HTML: http://tieinfo.mustcode.fi/tieinfo/viestit/
JSON: http://tieinfo.mustcode.fi/tieinfo/viestit/?json
JSONP: http://tieinfo.mustcode.fi/tieinfo/viestit/?{jsonp tai callback}={haluttu funktionimi}
