|
| 1 | +--- |
| 2 | +layout: page |
| 3 | +title: "Weather Underground (Wunderground)" |
| 4 | +description: "Instructions how to integrate Weather Underground (Wunderground) Weather within Home Assistant." |
| 5 | +date: 2016-08-18 |
| 6 | +sidebar: true |
| 7 | +comments: false |
| 8 | +sharing: true |
| 9 | +footer: true |
| 10 | +logo: wunderground.png |
| 11 | +ha_category: Weather |
| 12 | +ha_release: 0.27 |
| 13 | +--- |
| 14 | + |
| 15 | + |
| 16 | +The `wunderground` platform uses [Weather Underground](http://www.wunderground.com.com) as an source for current weather information. |
| 17 | + |
| 18 | +<p class='note warning'> |
| 19 | +Obtain Wunderground API [here](https://www.wunderground.com/weather/api). Free account allows 500 requests per day or 10 per minute. |
| 20 | +</p> |
| 21 | + |
| 22 | +To add Wunderground to your installation, add the following to your `configuration.yaml` file: |
| 23 | + |
| 24 | +```yaml |
| 25 | +# Example configuration.yaml entry |
| 26 | +sensor: |
| 27 | + platform: wunderground |
| 28 | + api_key: your_api_key |
| 29 | + pws_id: enter_pws_id |
| 30 | + monitored_conditions: |
| 31 | + - weather |
| 32 | + - temp_f |
| 33 | + - temp_c |
| 34 | + - station_id |
| 35 | + - feelslike_c |
| 36 | + - feelslike_f |
| 37 | + - feelslike_string |
| 38 | + - heat_index_c |
| 39 | + - heat_index_f |
| 40 | + - heat_index_string |
| 41 | + - dewpoint_c |
| 42 | + - dewpoint_f |
| 43 | + - dewpoint_string |
| 44 | + - wind_kph |
| 45 | + - wind_mph |
| 46 | + - UV |
| 47 | + - pressure_in |
| 48 | + - pressure_mb |
| 49 | + - wind_dir |
| 50 | + - wind_string |
| 51 | + - relative_humidity |
| 52 | + - visibility_mi |
| 53 | + - visibility_km |
| 54 | + - precip_today_in |
| 55 | + - precip_today_metric |
| 56 | + - precip_today_string |
| 57 | + - solarradiation |
| 58 | + |
| 59 | +``` |
| 60 | + |
| 61 | +Configuration variables: |
| 62 | +- **api_key** (Required): See above |
| 63 | +- **pws_id** (Optional): You can enter your PWS id. Current list of Wunderground PWS stations is available [here](https://www.wunderground.com/weatherstation/ListStations.asp). If you do not enter the PWS ID, the current location information (latitude and longitude) from your `configuration.yaml` will be used to display weather conditions. |
| 64 | +- **monitored_conditions** array (*Required*): Conditions to display in the frontend. The following conditions can be monitored. |
| 65 | + - **weather**: A human-readable text summary with picture from Wunderground. |
| 66 | + - **temp_f**: Current temperature in Fahrenheit |
| 67 | + - **temp_c**: Current temperature in Celsius |
| 68 | + - **station_id**: Your personal weather station (PWS) ID |
| 69 | + - **feelslike_c**: Feels like (or apparent) temperature in celsius |
| 70 | + - **feelslike_f**: Feels like (or apparent) temperature in Fahrenheit |
| 71 | + - **feelslike_string**: Text summary of how the current teperature feels like |
| 72 | + - **heat_index_c**: Heat index (combined effects of the temperature and humidity of the air) in Celsius |
| 73 | + - **heat_index_f**: Heat index (combined effects of the temperature and humidity of the air) in Fahrenheit |
| 74 | + - **heat_index_string**: Text summary of current heat index |
| 75 | + - **dewpoint_c**: Temperature in celsius below which water droplets begin to condense and dew can form |
| 76 | + - **dewpoint_f**: Temperature in fahrenheit below which water droplets begin to condense and dew can form |
| 77 | + - **dewpoint_string**: Text summary of dew point |
| 78 | + - **wind_kph**: Current wind speed in kph |
| 79 | + - **wind_mph**: Current wind speed in mph |
| 80 | + - **UV**: Current levels of UV radiation. See [here](https://www.wunderground.com/resources/health/uvindex.asp) for explanation. |
| 81 | + - **pressure_in**: Atmospheric air pressure in inches |
| 82 | + - **pressure_mb**: Atmospheric air pressure in millibars |
| 83 | + - **wind_dir**: Wind direction |
| 84 | + - **wind_string**: Text summary of current wind conditions |
| 85 | + - **relative_humidity**: Reltive humidity |
| 86 | + - **visibility_mi**: Average visibility in miles |
| 87 | + - **visibility_km**: Average visibility in km |
| 88 | + - **precip_today_in**: Total precipitation in inches |
| 89 | + - **precip_today_metric**: Total precipitation in metric units |
| 90 | + - **precip_today_string**: Text summary of precipitation today |
| 91 | + - **solarradiation**: Current levels of solar radiation |
| 92 | + |
| 93 | +Additional details about the API are available [here](https://www.wunderground.com/weather/api/d/docs). |
| 94 | + |
0 commit comments