Documentation
Wunderground Weather
Require: IP-Symcon >= 4.2
The module queries weather data via the Wunderground API.
You need to register at Wunderground to get an API key.
Current data, severe weather warnings, as well as hourly and daily forecasts can be queried.
functional scope
- Enable/disable query of desired weather data.
- Adjustability of the amount of severe weather, hourly and daily data.
- Timer for automatic updating of data.
Software Installation
- Via the Module Store install the WundergroundWeather module.
Set up the instances in IP-Symcon
- Under "Add instance" the 'WundergroundWeather' module can be found using the quick filter.
- More information about adding instances in the Instances documentation.
Configuration Page:
| name | description |
|---|---|
| Location | Location from which the data should be taken. Whether a location is available can be tried on the wunderground.com page. If a location is not available, a nearest larger location should be chosen. |
| Country | The country must be entered here. |
| PWS ID | ID of the 'Personal Weatherstation' Here you can query a specific weather station |
| API Key | Wunderground API Key. Can be requested on the Wunderground homepage after registration. "More"->"Weather API for Developers". |
| Query Current Data | Enables the query of current weather data. |
| Hourly Forecast | Enables the query of the hourly forecast. |
| 12-hourly forecast | Activates the query of the 12-hourly forecast. |
| Daily forecast | Activates the query of the daily forecast. |
| Poll severe weather warning | Activates polling of the severe weather forecast. |
| number of forecasts (12-hourly) | The number of 12-hourly forecasts. Maximum value: 8 |
| Number of forecasts (daily) | The number of daily forecasts. Maximum value: 4 |
| number of predictions (hourly) | The number of hourly predictions. Maximum value: 24 |
| Number of severe weather warnings | The number of severe weather forecasts. Maximum value: 6 |
| Update Weather Data | Sets the timer in minutes how often the weather data should be updated. (current/hourly/12-hourly) |
| Update severe weather warnings | Sets the timer in minutes how often the severe weather warnings should be updated. |
| Update Weather button | Updates the weather data (current/hourly/12-hourly/daily). If all three queries are deactivated or the timer is set to 0 => Timer deactivated |
| Button Update severe weather warnings | Updates the severe weather warnings. Provided the severe weather warning query is deactivated or the timer is set to 0 => Timer deactivated |
status variables and profiles
The status variables/categories are created automatically. Deleting individual ones can lead to malfunctions.
Current weather data
| Name | Type | Description |
|---|---|---|
| Air pressure | Float | Specification in hPa |
| Humidity | Float | Indication in % |
| Precipitation/h | Float | Indication in liters/m² |
| Precipitation day | Float | in liters/m² |
| Visibility | Float | Indication in km |
| Solar Radiation | Float | Specified in W/m² |
| Temperature | Float | in °C |
| Temperature felt | Float | Indication in °C |
| Temperature dew point | Float | value in °C |
| UV radiation | Integer | Information: UVIndex Explanation |
| Wind Gust | Float | Specification in km/h |
| Wind Speed | Float | Specification in km/h |
| wind direction | float | indication in cardinal points |
Hourly forecast
The variables are marked with 1..24h. (1 = forecast next full hour; 24 = forecast of the 24th full hour)
| Name | Type | Description |
|---|---|---|
| Condition | String | Describes the weather e.g. "Overcast", "Rain possible" |
| Humidity | Float | Specification in % |
| Air Pressure | Float | Indication in hPa |
| Rainfall Amount | Float | Indication in liters/m² |
| Probability of rain | Integer | Indication in % |
| Temperature | Float | in °C |
| Cloud cover | Integer | Specified in % |
| Wind Speed | Float | in km/h |
| wind direction | float | indication in cardinal directions |
12-hourly-forecast
The variables are marked with 12, 24..96h (12 = forecast in 12 hours; 96 = forecast in 96 hours)
Note: the 12h-hourly forecast is no longer provided by Wunderground. The variables remain for compatibility reasons, but contain the values of the daily forecast.
| Name | Type | Description |
|---|---|---|
| maximum temperature | float | specification in °C |
| Lowest temperature | Float | Indication in °C |
Daily forecast
The variables are marked with 1..4d (1 = tomorrow; 2 = the day after tomorrow ... )
| Name | Type | Description |
|---|---|---|
| Condition | String | Describes the weather e.g. "Overcast", "Rain possible" |
| Highest Temperature | Float | Specifies in °C |
| Lowest Temperature | Float | Indication in °C |
| Humidity | Float | Indication in % |
| Rainfall Amount | Float | Indication in Liter/m² |
| Probability of rain | Integer | Specified in % |
| Wind Speed | Float | in km/h |
| Wind Direction | Float | Indication in Cardinal Points |
Weatherwarning
| Name | Type | Description |
|---|---|---|
| Description | String | Describes the warning with possible additional information such as wind speeds or rain amounts. |
| Date | Integer | Specified in UnixTimeStamp. Date when the warning was issued. |
| Name | String | Written out type. e.g. thunderstorm |
| Type | String | 3-letter abbreviation for the warning Overview |
Profile:
| name | type |
|---|---|
| WGW.Rainfall | Float |
| WGW.Sunray | Float |
| WGW.Visibility | Float |
| WGW.WindSpeedkmh | Float |
| WGW.UVIndex | Integer |
| WGW.ProbabilityOfRain | Integer |