Data–rajapinnat

Digitrafficin data-rajapinnat

Swagger API-dokumentaatio ja hiekkalaatikko data-rajapintojen testaamiseen

http://tie.digitraffic.fi/api/v1/metadata/documentation/

Kelikamerat

http://tie.digitraffic.fi/api/v1/data/camera-data/camera-data

http://tie.digitraffic.fi/api/v1/data/camera-data/{id}

Viesti sisältää kaikkien julkisten kelikameroiden tiedot ja osoitteen mistä kelikamerakuvat löytyvät. Esim. esiasennon C0150201 kuva löytyy osoitteesta http://weathercam.digitraffic.fi/C0150201.jpg.

Kelikamerakuva C0150201 .

Ajantasaiset linkkien sujuvuustiedot sisältäen matka-aikatiedot

http://tie.digitraffic.fi/api/v1/data/fluency-current

http://tie.digitraffic.fi/api/v1/data/fluency-current/{id}

Viesti sisältää kullekin linkille viimeisimmän 5 minuutin mediaanimatka-ajan sekunteina, vastaavan keskinopeuden, sujuvuusluokan, ja tiedon siitä milloin tiedot on päivitetty.

Viesti päivitetään aina kun uutta mediaanidataa on vastaanotettu MTP:stä, eli noin kerran minuutissa. Jos MTP ei lähetä uutta dataa normaalisti, viestin päivitysväli on vastaavasti pitempi.

Edellisen päivän sujuvuuden historiatiedot

http://tie.digitraffic.fi/api/v1/data/fluency-history-previous-day

http://tie.digitraffic.fi/api/v1/data/fluency-history-previous-day/{id}

Viesti sisältää kullekin linkille edellisen vuorokauden mediaanitiedot: matka-ajan, keskinopeuden ja sujuvuusluokan. Viesti sisältää kullekin linkille kaikki edellisen vuorokauden 5 minuutin mediaanit, eli maksimissaan 1440 kappaletta per linkki.

Viesti päivitetään eräajotyyppisesti kerran vuorokaudessa. Päivitetty viesti on haettavissa 02:30 Suomen aikaa.

Viestin suuresta koosta johtuen viestiä ei kannata (tarpeettomasti, kun päivitys on kerran vuorokaudessa) hakea toistuvasti samana päivänä.

Sujuvuuden historiatiedot halutulta kuulta

http://tie.digitraffic.fi/api/v1/data/fluency-history/{id}?year={year}&month={month}

Viesti sisältää halutun linkin yhden kuukauden kaikki historiatiedot.

Ajantasaiset vapaat nopeudet

http://tie.digitraffic.fi/api/v1/data/free-flow-speeds

http://tie.digitraffic.fi/api/v1/data/free-flow-speeds/link/{id}

http://tie.digitraffic.fi/api/v1/data/free-flow-speeds/tms/{id}

Viesti sisältää kulloinkin voimassa olevat vapaat nopeudet sekä linkeille että LAM – asemille.

Kun linkki- tai LAM–asema vaihtuu talvinopeusrajoituksesta kesänopeuksiin tai päinvastoin, viestin sisältö muuttuu.

Viesti päivitetään eräajotyyppisesti kerran vuorokaudessa. Päivitetty viesti on haettavissa 03:30 Suomen aikaa.

Ajantasaiset LAM mittaustiedot

http://tie.digitraffic.fi/api/v1/data/tms-data

http://tie.digitraffic.fi/api/v1/data/tms-data/{id}

ws://tie.digitraffic.fi/api/v1/plain-websockets/tmsdata

Viesti sisältää LAM (Liikenteen Automaattinen Mittaus)–asemien mittaustiedot.

Viestissä on kullekin LAM-asemalle liikennemäärä molempiin suuntiin, ja mitattu keskinopeus molempiin suuntiin.

Tietoa päivitetään lähes reaaliaikaisesti, mutta ulospäin tarjottavaa viestiä pidetään välimuistissa minuutin ajan ts. se päivittyy minuutin välein.

Yksinkertainen JavaScript WebSocket asiakassovellus:

<html>
     <head>
         <title>Testiclient for lam sensor values</title>
         <script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.0/jquery.min.js" ></script>
         <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/sockjs-client/1.0.3/sockjs.min.js"></script>
         <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/stomp.js/2.3.3/stomp.min.js"></script>
         <script>
             function connect() {
                 var url = "ws://tie.digitraffic.fi/api/v1/plain-websockets/tmsdata";
                 var socket = new WebSocket(url);
                 socket.onopen = function (event) {
                     console.info('Socket is open');
                 }
                 socket.onmessage = function(message) {
                     addMessage(message);
                 };
             }
             function addMessage(message) {
                 var text = convert(message);
                 $(".messages").append(text);
                 $(".messages").append('\n');
             }
             function convert(message) {
                 return JSON.stringify(JSON.parse(message.data));
             }
             connect();
         </script>
     </head>
     <body>
         <b>All messages:</b>
         <pre class="messages"></pre>
     </body>
 </html>

Tiesääasemien ajantasaiset mittaustiedot

http://tie.digitraffic.fi/api/v1/data/weather-data

http://tie.digitraffic.fi/api/v1/data/weather-data/{id}

Viesti sisältää tiesääasemien viimeisimmät mittaustiedot.

Viestissä on kullekin tiesääasemalle kyseisen aseman anturiarvot.

Tietoa päivitetään lähes reaaliaikaisesti, mutta ulospäin tarjottavaa viestiä pidetään välimuistissa minuutin ajan ts. se päivittyy minuutin välein.

‼️ Tämä sivu on vanhentunut! Uudet sivut https://www.digitraffic.fi/

Creative Commons -lisenssi

Digitraffic, jonka tekijä on Liikennevirasto, on lisensoitu Creative Commons Nimeä 4.0 Kansainvälinen -lisenssillä. Tämän lisenssin antamia oikeuksia laajempia lupia voi olla saatavilla osoitteessa http://www.liikennevirasto.fi.