JSON-API: Tiesääasemien anturitietojen metatiedot / AvailaRoad weather sensors metadata

[Solita / Jouni]

JSON-esimerkki, joka sisältää tiesääasemien anturitietojen kuvaukset. Miltä se näyttää?

In English: JSON example of sensor descriptions of road weather station. How does it look?

Huomioitavaa on, että uudesta tietolähteestämme emme saa vanhassa rajapinnassa ollutta englanninkielistä tunnistetta sensorille (ks. http://tie.digitraffic.fi/sujuvuus/ws/roadWeather).  Emme esimerkiksi saa "airtemperature1" vaan sitä vastaa uusi tunniste on "ILMA". Ajattelimme palauttaa uudessa rajapinnassa vanhan nimen niille sensoreille, jotka nyt on jo olemassa nameOld-kentässä ja uusille antureille siihen kopioituu uusi tunniste esimerkki alla.

Myöhemmin lienee ok tiputtaa vanha tunniste kokonaan pois?

In our new API we can't provide old api's sesors idenfiers as primary identifier (see. http://tie.digitraffic.fi/sujuvuus/ws/roadWeather).  So "airtemperature1" will be identified with "ILMA" and so on. For compatibility reasons we however provide these old identifiers in nameOld-field, but for new sensors it will equal new identifier. Example below.

Is it ok to deprecate nameOld-field in the future?

Old sensor:

"nameFi": "ILMA",

"nameOld": "airtemperature1"

New sensor:

"nameFi": "KITKA",

"nameOld": "KITKA"

Onko tämä riittävä ratkaisu?

https://github.com/finnishtransportagency/metadata/blob/master/docs/meta_rws_sensors.pdf

JSON

{

  "roadStationSensors": [

    {

      "id": 1,

      "nameFi": "ILMA",

      "shortNameFi": "Ilma ",

      "description": "Ilman lämpötila",

      "unit": "°C",

      "accuracy": 1,

      "calculationFormula": "anturi('01')",

      "nameOld": "airtemperature1"

      "sensorValueDescriptions": [],

    },

    {

      "id": 80,

      "nameFi": "KITKA",

      "shortNameFi": "Kitka",

      "description": "Kitka-autolla mitattu kitka                                     ",

      "unit": "µ",

      "accuracy": 1,

      "calculationFormula": null,

      "nameOld": "KITKA"

      "sensorValueDescriptions": [],

    },

        {

      "id": 22,

      "nameFi": "SADE",

      "shortNameFi": "Sade",

      "description": "Sataako ja miten paljon ?",

      "unit": "///",

      "accuracy": 0,

      "calculationFormula": "anturi('23')",
             "nameOld": "precipitation"

      "sensorValueDescriptions": [

        {

          "descriptionEn": "Dry weather",

          "descriptionFi": "Pouta",

          "sensorValue": 0

        },

        {

          "descriptionEn": "Weak",

          "descriptionFi": "Heikko",

          "sensorValue": 1

        },

        {

          "descriptionEn": "Moderate",

          "descriptionFi": "Kohtalainen",

          "sensorValue": 2

        },

        {

          "descriptionEn": "Abundant",

          "descriptionFi": "Runsas",

          "sensorValue": 3

        },

        {

          "descriptionEn": "Light snow/sleet",

          "descriptionFi": "Heikko lumi/räntä",

          "sensorValue": 4

        },

        {

          "descriptionEn": "Moderate snow/sleet",

          "descriptionFi": "Kohtalainen lumi/räntä",

          "sensorValue": 5

        },

        {

          "descriptionEn": "Abundant snow/sleet",

          "descriptionFi": "Runsas lumi/räntä",

          "sensorValue": 6

        }

      ]

    },

  ]

}

Ystävällisin terveisin

– Digitraffic asiakastuki / Jouni –