REST/JSON -rajapintojen selittävä dokumentaatio

220 views
Skip to first unread message

Developer

unread,
Jan 24, 2017, 6:59:40 AM1/24/17
to road.digitraffic.fi
Onko uusille REST/JSON -rajapinnoille tulossa kattavaa selittävää dokumentaatiota vai onko tuon SWAGGERin ja Google Groups -keskustelujen tarkoitus olla riittävä dokumentaatio?

Esimerkiksi uusissa LAM-rajapinnoissa on mukana uutta tietoa eri sensoreista, joihin toivoisin lisää dokumentaatiota. Metadata -rajapinnoista löytyy toki jo sensorien kuvaukset, mutta osa niistä on puutteellisia (mm. yksiköt puuttuu jne.) ja varsinainen "description" -kenttä sisältää vain lyhyen kommentin.

Selittävältä dokumentaatiolta toivoisin mm. vastauksia seuraaviin kysymyksiin:

- Selkeä kuvaus sensorin tuottamasta tiedosta
- Mitä eroa sensorin tuottamalla datalla on verrattuna lähes saman nimisiin muihin sensoreihin?
- Mitä arvoja sensori voi saada?
- Perustuuko sensorin tiedot suoraan LAM-aseman tuottamiin tietoihin vai onko tiedot laskennallisia? Miten tieto lasketaan, jos se on laskennallista? Mitä muita tietoja laskentaan käytetään?


Developer

unread,
Mar 3, 2017, 4:00:07 AM3/3/17
to road.digitraffic.fi
Onko näihin uusiin sensoreihin tulossa siis lisää dokumentaatiota vai miten näiden tulkintaa kannattaisi edistää?

Solita / Petri

unread,
Mar 3, 2017, 6:34:10 AM3/3/17
to road.digitraffic.fi
Moi,

Näemmä tähän ei ole vastattu ainakaan tässä keskustelussa.

Otan tämän käsittelyyn torstaina 9.3. ja palaan asiaan silloin.

Pahoittelut asian jäämisestä roikkumaan.

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

Solita / Jouni

unread,
Mar 10, 2017, 5:49:12 AM3/10/17
to road.digitraffic.fi
Hei,

asia on otettu selvitykseen.

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

perjantai 3. maaliskuuta 2017 11.00.07 UTC+2 Developer kirjoitti:

Solita Teijo

unread,
Mar 29, 2017, 8:15:48 AM3/29/17
to road.digitraffic.fi
Hei

Selvittely jatkuu yhä, tätä ei ole unohdettu!

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

Markku Pitkänen / Liikennevirasto

unread,
Apr 13, 2017, 3:57:27 AM4/13/17
to road.digitraffic.fi
Hei,

Valitettavasti LAM-rajapintojen dokumentaatio ei ole tällä hetkellä täydellistä. Puutteet LAM-rajapintojen dokumentaatiossa on huomioitu ja välitetty edelleen tiedoista vastaavalle lähdejärjestelmän ylläpidolle. Dokumentaatiota pyritään kehittämään edelleen ja kehitystyön tulokset tulevat hyödynnettäväksi entistä kattavampina metatiedoina Digitraffic -palvelussa.

Ystävällisin terveisin,
Markku Pitkänen, Liikennevirasto



Tuukka Laakso

unread,
Jun 29, 2017, 8:39:05 AM6/29/17
to road.digitraffic.fi
Hei,

vähemmänkin täydellinen dokumentaatio kyllä riittäisi, kuten esim. tieto siitä mikä ero arvoilla

KESKINOPEUS_5MIN_LIUKUVA_SUUNTA1
ja
KESKINOPEUS_5MIN_LIUKUVA_SUUNTA1_VVAPAAS1

on kun eroavat toisistaan aika paljonkin.

Toinen hämmentävä kaksikko on:

OHITUKSET_5MIN_LIUKUVA_SUUNTA1
ja
OHITUKSET_5MIN_LIUKUVA_SUUNTA1_MS1

Ensimmäinen antaa selvästi arvon laskettuna tunnille, mutta kun ei tuo jälkimmäinen ole 1/12 osa ensimmäisestä?

Hyvää kesää!
Tuukka Laakso
Adfore Technologies Oy / Tässä.fi

Solita / Jouni

unread,
Jun 30, 2017, 2:00:02 AM6/30/17
to road.digitraffic.fi
Moi,

laitoin tästä kyselyä LOTJUn ylläpidolle. Vastailemme, kun saamme tähän tarkennuksen.

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

iitu.s...@gmail.com

unread,
Aug 15, 2017, 3:19:13 AM8/15/17
to road.digitraffic.fi, jouni.s...@solita.fi
Hei,

oletteko saaneet selville, mikä ero on OHITUKSET_60MIN_KIINTEA_SUUNTA1 ja OHITUKSET_60MIN_KIINTEA_SUUNTA1_MS1 arvoilla? En löytänyt noista sensorValues-kenttien arvoista mitään tietoa.

Terveisin,
Iitu Strandin

iitu.s...@gmail.com

unread,
Aug 15, 2017, 4:09:08 AM8/15/17
to road.digitraffic.fi, jouni.s...@solita.fi
Hei,

tarvitsen myös tiedon siitä, mitä OHITUKSET_5MIN_LIUKUVA_SUUNTA1 ja OHITUKSET_60MIN_KIINTEA_SUUNTA1 tarkoittavat ja mikä niiden ero on? Näistä 5 min arvo on usein suurempi kuin 60 min arvo.

Terveisin,
Iitu Strandin

Solita / Petri

unread,
Aug 16, 2017, 9:03:27 AM8/16/17
to road.digitraffic.fi
Odotamme yhä vastauksia näihin. Pahoittelut pitkästä odotusajasta.

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

Solita / Petri

unread,
Sep 4, 2017, 4:40:08 AM9/4/17
to road.digitraffic.fi
Ja vastausta odotellaan yhä. Ilmeisen kimurantti kysymys. :)

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

Digitraffic support / Solita / Jouni

unread,
Nov 25, 2019, 9:10:56 AM11/25/19
to road.digitraffic.fi
Hei.

Tänne on unohtunut vastata, että jotain tietoja on saatu ja niitä on julkaistu/julkaistaan https://www.digitraffic.fi/tieliikenne/lam/ -sivulla.

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

Reply all
Reply to author
Forward
0 new messages