OpenWeatherMap

The OpenWeatherMap interface communicates via the Internet to retrieve weather data. Both current data and a forecast every three hours up to five days are used. The weather service is available for free.

Configuration

The location and API key are stored in the gateway. Therefore, only one location can be used per interface. An API key can be obtained from the website of openweathermap.org. This should be created separately for each customer, as the API key is always visible.

The language of the weather data can be configured under the Advanced tab.

Variables

The variable time, always returns the time of the last query. This variable is not recorded in the monitor.

Location

Variable	Description
city [string]	City name.
country [string]	Country code. E.g., CH.
timezone [time]	Time zone offset in ms.
sunrise [datetime]	Today's sunrise.
sunset [datetime]	Today's sunset.
geolat [real]	Latitude.
geolng [real]	Longitude.

Note: Sunrise and sunset are only calculated after retrieving the data. It is recommended to use the Function Block SUNINFO instead.

Current Weather And Forecast

The same values are always queried every three-hour interval. Each has a different prefix. The prefix act_ returns the current values.

Variable	Description
dt [datetime]	Absolute time for which the recorded data is valid.
id [int]	Weather state ID according to OpenWeatherMap.
icon [string]	Symbol for the weather.
main [string]	Weather description in English.
description [string]	More detailed weather description in English.
temp [real]	Temperature in °C.
humidity [int]	Relative humidity in %.
visibility [int]	Visibility in meters.
rain [real]	Precipitation volume in mm.
snow [real]	Amount of snow in mm.
preassure [int]	Air pressure at sea level in mbar.
clouds [int]	Coverage in %.
windspeed [real]	Wind speed in m/s.
winddirection [real]	Origin of the wind in °.

Tip: There is an internal symbol library for the variables id and icon. See Weather Icons.