wunderground platform uses Weather Underground as a source for current weather information.
Obtain a WUnderground API key here. They no longer offer free API keys, and all keys must be paid for. At this time existing free keys will continue to work, but will be disabled Dec 31, 2018. As of Sept 6, 2018 Weather Underground states they are declaring the End of Service for the Weather Underground API. They say they will develop new plans for non-commercial users. No timeline for this has been announced. Please consider this when using the following information.
To add Wunderground to your installation, add the following to your
# Example configuration.yaml entry sensor: - platform: wunderground api_key: YOUR_API_KEY monitored_conditions: - alerts - dewpoint_c
(string)(Required)The API key for Weather Underground. See above for details.
(string)(Optional)You can enter a Personal Weather Station ID. The current list of Wunderground PWS stations is available here. If you do not enter a PWS ID, the current location information (latitude and longitude) from your
configuration.yamlwill be used to display weather conditions.
(string)(Optional)Specify the language that the API returns. The current list of all Wunderground language codes is available here. If not specified, it defaults to English (EN).
Default value: EN
(string)(Optional)Latitude coordinate to monitor weather of (required if longitude is specified).
Default value: Coordinates defined in your
(string)(Optional)Longitude coordinate to monitor weather of (required if latitude is specified).
Default value: Coordinates defined in your
(list)(Required)Conditions to display in the frontend. The following conditions can be monitored.
Default value: symbol
Current severe weather advisories
Temperature in Celsius below which water droplets begin to condense and dew can form
Temperature in Fahrenheit below which water droplets begin to condense and dew can form
Text summary of dew point
Feels like (or apparent) temperature in Celsius
Feels like (or apparent) temperature in Fahrenheit
Text summary of how the current temperature feels like
Heat index (combined effects of the temperature and humidity of the air) in Celsius
Heat index (combined effects of the temperature and humidity of the air) in Fahrenheit
Text summary of current heat index
Elevation in feet
City and State
Text summary of observation time
Total precipitation in inches
Total precipitation in metric units
Text summary of precipitation today
[1d]: Forecasted precipitation intensity in millimeters
[1d]: Forecasted precipitation intensity in inches
[1d]: Forecasted precipitation probability in %
Atmospheric air pressure in inches
Atmospheric air pressure in millibars
Atmospheric air pressure trend signal
Your personal weather station (PWS) ID
Current levels of solar radiation
Temperature text combining Fahrenheit and Celsius
Current temperature in Celsius
Current temperature in Fahrenheit
Maximum temperature measured in Celsius
Maximum temperature measured in Fahrenheit
Minimal temperature measured in Celsius
Minimal temperature measured in Fahrenheit
Average high for today in Celsius
Average high for today in Fahrenheit
Average low for today in Celsius
Average low for today in Fahrenheit
[1d]: Forecasted high temperature in Celsius
[1d]: Forecasted high temperature in Fahrenheit
[1d]: Forecasted low temperature in Celsius
[1d]: Forecasted low temperature in Fahrenheit
Current levels of UV radiation. See here for explanation.
Average visibility in km
Average visibility in miles
A human-readable text summary with picture from Wunderground.
[12h]: A human-readable weather forecast using imperial units.
[12h]: A human-readable weather forecast using metric units.
[1h]: Weather conditions in 1 hour. (e.g., “Thunderstorm” etc.)
Wind gusts speed in kph
Wind gusts speed in mph
[1d]: Max. forecasted Wind in kph
[1d]: Max. forecasted Wind in mph
Current wind speed in kph
Current wind speed in mph
[1d]: Forecasted wind speed in kph
[1d]: Forecasted wind speed in mph
Text summary of current wind conditions
All the conditions listed above will be updated every 5 minutes.
12 hour forecasts
Monitored conditions marked above with [12h] are 12 hour forecasts. To get a forecast for different period/daytime replace the
_1d_ part of the sensor name. e.g.,
weather_2n will give you forecast for tomorrow night. Valid values for day are
4 and valid values for daytime are
Conditions above marked with [1d] are daily forecasts. To get forecast for different day, replace the number
_1d_ part of the sensor name. Valid values are from
Conditions marked with [1h] are hourly forecasts. To get forecast for different hour, replace the number
_1h_ part of the sensor name with
weather_24h will give you weather in 24 hours.
sensor: - platform: wunderground api_key: YOUR_API_KEY monitored_conditions: - weather_1d_metric - weather_1n_metric - weather_2d_metric - weather_2n_metric - weather_3d_metric - weather_3n_metric - weather_4d_metric - weather_4n_metric group: daily_forecast: name: Daily Forecast entities: - sensor.pws_weather_1d_metric - sensor.pws_weather_1n_metric - sensor.pws_weather_2d_metric - sensor.pws_weather_2n_metric - sensor.pws_weather_3d_metric - sensor.pws_weather_3n_metric - sensor.pws_weather_4d_metric - sensor.pws_weather_4n_metric
sensor: - platform: wunderground api_key: YOUR_API_KEY monitored_conditions: - temp_high_record_c - temp_high_1d_c - temp_c - temp_low_1d_c - temp_low_record_c - precip_1d - precip_1d_mm - wind_kph - wind_1d_kph - alerts group: weather_overview: name: Weather overview entities: - sensor.pws_weather_1d_metric - sensor.pws_temp_high_record_c - sensor.pws_temp_high_1d_c - sensor.pws_temp_c - sensor.pws_temp_low_1d_c - sensor.pws_temp_low_record_c - sensor.pws_precip_1d - sensor.pws_precip_1d_mm - sensor.pws_wind_kph - sensor.pws_wind_1d_kph - sensor.pws_alerts
Note: While the platform is called “wunderground” the sensors will show up in Home Assistant as “PWS” (eg: sensor.pws_weather).
Note that the Weather Underground sensor is added to the entity_registry, so second and subsequent Personal Weather Station ID (pws_id) will have their monitored conditions suffixed with an index number e.g.
Additional details about the API are available here.