Skip to content

Weather data

In this section, we explain which weather data is supplied to projects of a customer.

Meteorological conditions

The following table provides the meteorological conditions which are available to all projects:

Meteorological condition Name Unit / Value set Info
Apparent temperature apparent_temperature °C Human-felt temperature, determined by air temperature, wind speed, and humidity.
Cloud coverage cloud_cover % Percentage of sky occluded by clouds.
Daytime daytime [0, 1] Boolean value indicating whether the sun as risen.
Dew point dew_point °C Ambient steam saturation temperature.
Direct horizontal solar irradiance direct_horizontal_solar_irradiance W/m2 Direct horizontal solar irradiance [clear sky].
Direct normal solar irradiance direct_normal_solar_irradiance W/m2 Direct normal solar irradiance [clear sky].
Global horizontal irradiance global_horizontal_irradiance W/m2 Global horizontal irradiance [clear sky].
Relative humidity relative_humidity % Ambient ratio of steam saturation.
Precipitation precipitation mm/h Amount of precipitation per time unit.
Pressure pressure mBar Atmospheric air pressure.
Solar radiation solar_radiation W/m2 Estimated solar radiation.
Solar altitude solar_altitude °
Vertical position of the above or below the horizon.
Solar azimuth solar_azimuth °
Horizontal position of the sun. 0° at true south, clockwise.
Temperature temperature °C Ambient air temperature.
UV index uv_index - Defined by WMO, WTO, and ICNIRP commission.
Average visibility visibility km Measurement of the transparency of ambient air.
Wind direction wind_direction °
Direction from which the wind is coming. 0° at true north, clockwise. Not defined for wind speed = 0.
Wind speed wind_speed m/s Horizontal wind speed.

We store every meteorological condition as a separate datapoint on the platform to historicize its state. More on this in the subchapter Datapoint and observation convention.

Current weather data

Current weather data is delivered for all the meteorological conditions described in meteorological conditions. There is always a delay between when current weather data is measured and when it is made available to the platform. All current weather data is updated every 15 minutes.

Forecast weather data

Hourly forecasts

Only the most important weather data is provided as a forecast. The following data is provided as an hourly forecast for the next 48 hours:

  • Relative humidity
  • Temperature
  • Solar radiation

All forecast weather data, i.e., the 1h, 2h, ..., 48h forecast datapoints, is updated every hour. Please note that each update only adds a single new value (the prediction what the temperature is going to be in xh to each forecast datapoint) while past predictions remain as-is and are not "corrected" retrospectively. Every datapoint of a forecast represents what the given weather condition is forecasted to be at the forecast horizon. As an example, a value {"time": "2022-12-08T16:00:00Z", "value": 5.56} of the weather-service-forecast-2h-temperature datapoints means that at on 2022-12-08 at 16:00:00 UTC, the predicted temperature for two hours later, i.e., 2022-12-08 at 18:00:00 UTC was 5.56 degrees. Similarly, a value {"time": "2022-12-08T16:00:00Z", "value": 15.21} of the weather-service-forecast-24h-temperature datapoints means that at on 2022-12-08 at 16:00:00 UTC, the predicted temperature for 24 hours later, i.e., 2022-12-09 at 16:00:00 UTC was 15.21 degrees.

Average temperature forecasts

In addition to the hourly forecasts, weather data is also provided for the average temperature for the forecast horizons:

  • 24 hours
  • 48 hours

Average temperature during working hours

The average temperature forecast during working hours is provided every night at midnight for between 8:00 and 18:00 of the upcoming day.

Datapoint and observation convention

All weather data is stored in the plattform with a dedicated datapoint which has a unique alphanumeric identifier.

The naming convention for current weather datapoints is:

weather-service-current-<name of meteorological condition>

e.g., weather-service-current-temperature

The naming convention for forecast weather datapoints is:

weather-service-forecast-<prediction horizon>-<name of meteorological condition>

e.g., weather-service-forecast-1h-temperature

The naming convention for forecast mean weather datapoints is:

weather-service-forecast-mean-<prediction horizon>-<name of meteorological condition>

e.g., weather-service-forecast-mean-1h-temperature

The naming convention for working hours weather datapoints is:

weather-service-forecast-mean-working-hours-<begin>_<end>-<name of meteorological condition>

e.g., weather-service-forecast-mean-working-hours-8_18-temperature

Last update: 2023-07-21
Back to top