ForecastSectionWeatherDataDtoV2

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/digitraffic-fi/json-schema/digitraffic-fi-forecast-section-weather-data-dto-v2-schema.json",
  "title": "ForecastSectionWeatherDataDtoV2",
  "description": "Weather forecasts of a forecast section",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/digitraffic-fi-road-api-openapi.yml#/components/schemas/ForecastSectionWeatherDataDtoV2",
  "required": [
    "dataUpdatedTime"
  ],
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Forecast section identifier.\n\nDetailed forecast sections ie. 00004_342_01435_0_274.569:\n\n1. Road number 5 characters ie. 00004\n2. Road section 3 characters ie. 342\n3. Start distance 5 characters ie. 01435\n4. Carriageway 1 character\n5. Measure value of link start point. Varying number of characters ie. 274.569\n\nRefers to Digiroad content at https://aineistot.vayla.fi/digiroad/\n\nSimple forecast sections 15 characters ie. 00004_112_000_0:\n\n1. Road number 5 characters ie. 00004\n2. Road section 3 characters ie. 112\n3. Road section version 3 characters ie. 000\n4. Reserved for future needs 1 character default 0"
    },
    "forecasts": {
      "type": "array",
      "description": "Weather forecasts of the forecast section",
      "items": {
        "$ref": "#/$defs/ForecastSectionWeatherForecastDtoV2"
      }
    },
    "dataUpdatedTime": {
      "type": "string",
      "description": "Data last updated time",
      "format": "date-time"
    }
  },
  "$defs": {
    "ForecastSectionWeatherForecastDtoV2": {
      "type": "object",
      "properties": {
        "forecastName": {
          "type": "string",
          "description": "Name of the forecast: 0h is the observation, others are forecasts ahead of the production time, i.e. 2h, 4h, 6h and 12h"
        },
        "time": {
          "type": "string",
          "description": "Observation or forecast time depending on type",
          "format": "date-time"
        },
        "type": {
          "type": "string",
          "description": "Tells if object is an observation or a forecast. (OBSERVATION, FORECAST)",
          "enum": [
            "OBSERVATION",
            "FORECAST"
          ]
        },
        "daylight": {
          "type": "boolean",
          "description": "Tells if there is daylight: true/false"
        },
        "roadTemperature": {
          "type": "number",
          "description": "Road temperature in °C. If not available value is not set",
          "format": "double"
        },
        "temperature": {
          "type": "number",
          "description": "Air temperature in °C",
          "format": "double"
        },
        "windSpeed": {
          "type": "number",
          "description": "Wind speed in m/s",
          "format": "double"
        },
        "windDirection": {
          "type": "integer",
          "description": "Wind direction in degrees. 90 degrees is arrow to the east (count clockwise)",
          "format": "int32"
        },
        "overallRoadCondition": {
          "type": "string",
          "description": "Overall road condition",
          "enum": [
            "NOT_KNOWN",
            "NORMAL_CONDITION",
            "POOR_CONDITION",
            "EXTREMELY_POOR_CONDITION"
          ]
        },
        "roadCondition": {
          "type": "string",
          "description": "The state of the road",
          "enum": [
            "NOT_KNOWN",
            "DRY",
            "MOIST",
            "WET",
            "SLUSH",
            "FROST",
            "PARTLY_ICY",
            "ICE",
            "SNOW"
          ]
        },
        "weatherSymbol": {
          "type": "integer",
          "description": "Weather symbol code, SmartSymbol. 100 is added to the code during night time. Symbols (MIT licence) are available at https://github.com/fmidev/opendata-resources/tree/master/symbols",
          "format": "int32"
        }
      },
      "description": "Forecast section's weather forecast"
    }
  }
}