Weather Underground (WUnderground)
The 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, except you own a personal weather station and provide your data to WU (PWS Uploader). 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.
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
- api_key
(string)(Required)
The API key for Weather Underground. See above for details.
- pws_id
(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.yaml
will be used to display weather conditions.- lang
-
(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
- latitude
-
(string)(Optional)
Latitude coordinate to monitor weather of (required if longitude is specified).
Default value:
Coordinates defined in your
configuration.yaml
- longitude
-
(string)(Optional)
Longitude coordinate to monitor weather of (required if latitude is specified).
Default value:
Coordinates defined in your
configuration.yaml
- monitored_conditions
-
(list)(Required)
Conditions to display in the frontend. The following conditions can be monitored.
Default value:
symbol
- alerts
Current severe weather advisories
- dewpoint_c
Temperature in Celsius below which water droplets begin to condense and dew can form
- dewpoint_f
Temperature in Fahrenheit below which water droplets begin to condense and dew can form
- dewpoint_string
Text summary of dew point
- feelslike_c
Feels like (or apparent) temperature in Celsius
- feelslike_f
Feels like (or apparent) temperature in Fahrenheit
- feelslike_string
Text summary of how the current temperature feels like
- heat_index_c
Heat index (combined effects of the temperature and humidity of the air) in Celsius
- heat_index_f
Heat index (combined effects of the temperature and humidity of the air) in Fahrenheit
- heat_index_string
Text summary of current heat index
- elevation
Elevation in feet
- location
City and State
- observation_time
Text summary of observation time
- precip_today_in
Total precipitation in inches
- precip_today_metric
Total precipitation in metric units
- precip_today_string
Text summary of precipitation today
- precip_1d_mm
[1d]: Forecasted precipitation intensity in millimeters
- precip_1d_in
[1d]: Forecasted precipitation intensity in inches
- precip_1d
[1d]: Forecasted precipitation probability in %
- pressure_in
Atmospheric air pressure in inches
- pressure_mb
Atmospheric air pressure in millibars
- pressure_trend
Atmospheric air pressure trend signal
(+/-)
- relative_humidity
Relative humidity
- station_id
Your personal weather station (PWS) ID
- solarradiation
Current levels of solar radiation
- temperature_string
Temperature text combining Fahrenheit and Celsius
- temp_c
Current temperature in Celsius
- temp_f
Current temperature in Fahrenheit
- temp_high_record_c
Maximum temperature measured in Celsius
- temp_high_record_f
Maximum temperature measured in Fahrenheit
- temp_low_record_c
Minimal temperature measured in Celsius
- temp_low_record_f
Minimal temperature measured in Fahrenheit
- temp_high_avg_c
Average high for today in Celsius
- temp_high_avg_f
Average high for today in Fahrenheit
- temp_low_avg_c
Average low for today in Celsius
- temp_low_avg_f
Average low for today in Fahrenheit
- temp_high_1d_c
[1d]: Forecasted high temperature in Celsius
- temp_high_1d_f
[1d]: Forecasted high temperature in Fahrenheit
- temp_low_1d_c
[1d]: Forecasted low temperature in Celsius
- temp_low_1d_f
[1d]: Forecasted low temperature in Fahrenheit
- UV
Current levels of UV radiation. See here for explanation.
- visibility_km
Average visibility in km
- visibility_mi
Average visibility in miles
- weather
A human-readable text summary with picture from Wunderground.
- weather_1d
[12h]: A human-readable weather forecast using imperial units.
- weather_1d_metric
[12h]: A human-readable weather forecast using metric units.
- weather_1h
[1h]: Weather conditions in 1 hour. (e.g., “Thunderstorm” etc.)
- wind_degrees
Wind degrees
- wind_dir
Wind direction
- wind_gust_kph
Wind gusts speed in kph
- wind_gust_mph
Wind gusts speed in mph
- wind_gust_1d_kph
[1d]: Max. forecasted Wind in kph
- wind_gust_1d_mph
[1d]: Max. forecasted Wind in mph
- wind_kph
Current wind speed in kph
- wind_mph
Current wind speed in mph
- wind_1d_kph
[1d]: Forecasted wind speed in kph
- wind_1d_mph
[1d]: Forecasted wind speed in mph
- wind_string
Text summary of current wind conditions
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.