Weather Underground (WUnderground)
The wunderground
platform uses Weather Underground as a source for current weather information.
Weather Underground API no longer offers API keys. The API is generally not available for use, except if you own a personal weather station and provide your data to WU (PWS Uploader).
Please consider this when using the following information.
Configuration
To add Wunderground to your installation, add the following to your configuration.yaml
file:
# Example configuration.yaml entry
sensor:
- platform: wunderground
api_key: YOUR_API_KEY
monitored_conditions:
- alerts
- dewpoint_c
Configuration Variables
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.yaml
will be used to display weather conditions.
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).
Latitude coordinate to monitor weather of (required if longitude is specified).
Coordinates defined in your configuration.yaml
Longitude coordinate to monitor weather of (required if latitude is specified).
Coordinates defined in your configuration.yaml
Conditions to display in the frontend. The following conditions can be monitored.
[1d]: Forecasted precipitation intensity in millimeters
[1d]: Forecasted precipitation intensity in inches
[1d]: Forecasted precipitation probability in %
[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.
[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.)
[1d]: Max. forecasted Wind in kph
[1d]: Max. forecasted Wind in mph
[1d]: Forecasted wind speed in kph
[1d]: Forecasted wind speed in mph
All the conditions listed above will be updated every 5 minutes.
Forecasts
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 1
to 4
and valid values for daytime are d
or n
.
Daily forecasts
Conditions above marked with [1d] are daily forecasts. To get forecast for different day, replace the number
in _1d_
part of the sensor name. Valid values are from 1
to 4
.
Hourly forecasts
Conditions marked with [1h] are hourly forecasts. To get forecast for different hour, replace the number
in the _1h_
part of the sensor name with 1
to 36
. e.g., weather_24h
will give you weather in 24 hours.
Additional examples
Daily forecast
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
Weather overview
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 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.
- sensor.pws_weather_1d_metric_2
Additional details about the API are available here.
Suggest an edit to this page, or provide/view feedback for this page.