Tiesään rajapintauudistus / New versions of road weather APIs

[Digitraffic support / Solita / Jouni]

Hei,

Digitrafficin rajapintojen uudistus jatku. 

Sääasemille ja -ennusteille on julkaistu BETA-versiot uusista rajapinnoista ja ne löytyvät Swagger-kuvauksesta: 

• http://tie.digitraffic.fi/swagger/#/Weather%20(BETA)

Toivoisimme, että hyödyntäjät kävisivät kokeilemassa BETA-rajapintoja ennen niiden virallista julkaisua ja antavan kommentteja mahdollisista puutteista, virheistä tai muista huomioista. Rajapinnat eivät täysin yhtenevät vanhojen rajapintojen kanssa, joten hyödyntäjien tulee tehdä joitain muutoksia ottaessaan käyttöön uudet rajapinnat.

––––––––––––––––––––––

Hi,

the development of new versions of Digitraffic APIs is still in progress.

New versions of the weather stations and forecasts APIs have been published as BETA versions and can be found at:

• http://tie.digitraffic.fi/swagger/#/Weather%20(BETA)

We would like to ask users to try out the BETA interfaces before official release and give comments and feedback on possible shortcomings, errors or other considerations. New APIs are not identical with the old API versions, so some changes must be done when using the new api versions.

Ystävällisin terveisin / Best regards
– Digitraffic asiakastuki / Digitraffic support –

[Developer]

(Onko puhtaasti Digitrafficin muutos vai onko myös Vaisala tehnyt jotain)

Parannus, jonka toivoisin Vaisalan tekevän, on tien kunnon (roadCondition): DRY, MOIST, WET, SLUSH, FROST, PARTLY_ICY, ICE tai SNOW,

saaminen myös havaintoihin kun se nyt on vain ennusteissa. Joskus roadCondition puuttuu myös lähimmistä ennusteista ja on jopa vain 12 tunnin ennusteessa.

Jos kerran pystytään ennustamaan roadCondition tulevaisuudessa tiesääasemien datan perusteella,
eikö pitäisi pystyä laskemaan arvio myös nykyiselle roadCondition:ille

[Digitraffic support / Solita / Jouni]

Hei,

kiitos viestistä. Tämä on puhtaasti Vaisalan dataa, joten välitän ehdotuksen eteenpäin heille ja toivotaan, että tuo olisi mahdollista.

Ystävällisin terveisin / Best regards
– Digitraffic asiakastuki / Digitraffic support –

[Mikko Hammar]

roadConditionia vastaava arvo löytyy anturin nro 27 eli KELI_1 takaa. 

"id" : 27, "roadStationId" : 3072, 

 "name" : "KELI_1", 

 "oldName" : "roadsurfaceconditions1", 

 "shortName" : "Keli1", 

 "sensorValue" : 1.0, 

 "sensorUnit" : "***", 

 "measuredTime" : 

"2022-10-19T12:27:00Z", 

 "sensorValueDescriptionFi" : "Kuiva", 

 "sensorValueDescriptionEn" : "Dry" }, 

Luokittelu:
0 Vikaa

1 Kuiva

2 Kostea

3 Märkä

4 Märkä + suolattu

5 Kuura

6 Lumi

7 Jää

8 Kostea + suolattu

9 Sohjo

21 Liukas

22 Tuntematon

Nämä ovat juuri niitä arvoja joita tiesääasemilta tulee. 

[Teijo L.]

Terve!

Tuli mieleen joitakin kysymyksiä.

Koskeeko uudistus myös kameroiden metatietoja? Niistäkin on esillä beetarajapinta.

Entä tiesääasemien mittaustiedot? Pysyykö rajapinta api/v1/data/weather-data entisellään? En löydä sen beetaversiota.

Swagger-kuvauksesta saa käsityksen, että tiesäätietojen metadatarajapinta /api/weather/beta/stations vaatisi asemien tilatiedon "state". Sillä on kuitenkin oletusarvo, ja rajapinta toimii ilman tilatietoakin. Onko se lopullisessa versiossa pakollinen?

Milloin uudet rajapinnat otetaan käyttöön? Kauanko nykyiset rajapinnat toimivat sen jälkeen?

Otetaanko uudet rajapintaversiot käyttöön samanaikaisesti?

[Digitraffic support / Solita / Jouni]

Hei, 

kiitos hyvistä kysymyksistä. Alla vastauksia.

• Koskeeko uudistus myös kameroiden metatietoja? Niistäkin on esillä beetarajapinta.

• • Uudistus koskee kaikkia rajapintoja eli sekä data että metadata rajapintoja

• Entä tiesääasemien mittaustiedot? Pysyykö rajapinta api/v1/data/weather-data entisellään? En löydä sen beetaversiota.

• • Uusien rajapintojen Swagger-kuvauksesta löytyy tiesääasemien rajapinnat: 
    • /api/weather/beta/stations → olemassa olevien asemien suppeat metatiedot
    • /api/weather/beta/stations/data → kaikkien asemien mittaustiedot
    • /api/weather/beta/stations/{id} → yksittäisen aseman tarkat metatiedot
    • /api/weather/beta/stations/{id}/data → yksittäisen aseman mittaustiedot
  • Rajapintojen datan muoto on hieman muuttunut, joten data ei ole täysin 1:1 vanhojen rajapintojen kanssa. Hyödyntäjät joutunevat siksi tekemään pientä jumpaa uusien rajapintojen käyttöönoton kanssa

• Swagger-kuvauksesta saa käsityksen, että tiesäätietojen metadatarajapinta /api/weather/beta/stations vaatisi asemien tilatiedon "state". Sillä on kuitenkin oletusarvo, ja rajapinta toimii ilman tilatietoakin. Onko se lopullisessa versiossa pakollinen?

• • Hyvä huomio. Poistamme parametrin pakollisuuden seuraavassa päivityksessä, eli se poistuu ennen tuotantoon menoa. 

• Milloin uudet rajapinnat otetaan käyttöön? Kauanko nykyiset rajapinnat toimivat sen jälkeen?

• • Tämä riippuu hieman siitä, kuinka paljon palautetta uusista rajapinnoista tulee ja joudummeko niitä vielä muokkaamaan. Pyrkimys on, että kaikista rajapinnoista on uudet versiot tuotannossa ennen vuoden vaihdetta.
  • Vanhat rajapinnat merkitään vanhentuneiksi uusien rajapintojen käyttöönoton yhteydessä, mutta vanhat rajapinnat jatkavat toiminnassa vähintään 6kk tämän jälkeen. Meillä on tekeillä sivu, josta voi käydä katsomassa rajapintojen voimassaolon.

• Otetaanko uudet rajapintaversiot käyttöön samanaikaisesti?

• • Tarkoitus on ottaa kerralla käyttöön vähintään yhden tietolajin kaikki uudet rajapinnat, esim. /api/weather/ -rajapinnat
  • On myös paljon mahdollista, että useamman tietolajin uudet rajapinnat ovat julkaisukelpoisia samaan aikaan, jolloin voimme julkaista saman aikaisesti useamman tietolajin uudet rajapinnat.

Ystävällisin terveisin / Best regards
– Digitraffic asiakastuki / Digitraffic support –

[Digitraffic support / Solita / Jouni]

Hei,

saimme Vaisalalta vastauksen ja mahdollisesti saavat muutoksen tehtyä 1.11. muiden päivitysten mukana.

Ystävällisin terveisin / Best regards
– Digitraffic asiakastuki / Digitraffic support –

On Tuesday, October 18, 2022 at 1:42:52 PM UTC+2 Developer wrote: