Forecasts for weather underground (#2414)

* Forecasts for weather underground

* Forecasts for weather underground

* Forecasts for weather underground

source/_components/sensor.wunderground.markdown

@@ -91,6 +91,9 @@ Configuration variables:
   - **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** [<sup>[1d]</sup>](#1d): Forecasted precipitation intensity in milimeters
+  - **precip_1d_in** [<sup>[1d]</sup>](#1d): Forecasted precipitation intensity in inches
+  - **precip_1d** [<sup>[1d]</sup>](#1d): Forecasted precipitation probability in %
   - **pressure_in**: Atmospheric air pressure in inches
   - **pressure_mb**: Atmospheric air pressure in millibars
   - **pressure_trend**: Atmospheric air presure trend signal (+/-)
@@ -100,19 +103,137 @@ Configuration variables:
   - **temperature_string**: Temperature text combinding Fahrenheit and Celsius
   - **temp_c**: Current temperature in Celsius
   - **temp_f**: Current temperature in Fahrenheit
+  - **temp_high_record_c**: Maximum temperature meassured in Celsius
+  - **temp_high_record_f**: Maximum temperature meassured in Fahrenheit
+  - **temp_low_record_c**: Minimal temperature meassured in Celsius
+  - **temp_low_record_f**: Minimal temperature meassured 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** [<sup>[1d]</sup>](#1d): Forecasted high temperature in Celsius
+  - **temp_high_1d_f** [<sup>[1d]</sup>](#1d): Forecasted high temperature in Fahrenheit
+  - **temp_low_1d_c** [<sup>[1d]</sup>](#1d): Forecasted low temperature in Celsius
+  - **temp_low_1d_f** [<sup>[1d]</sup>](#1d): Forecasted low temperature in Fahrenheit
   - **UV**: Current levels of UV radiation. See [here](https://www.wunderground.com/resources/health/uvindex.asp) 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** [<sup>[12h]</sup>](#12h): A human-readable weather forecast using imperial units.
+  - **weather_1d_metric** [<sup>[12h]</sup>](#12h): A human-readable weather forecast using metric units.
+  - **weather_1h** [<sup>[1h]</sup>](#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** [<sup>[1d]</sup>](#1d): Max. forecasted Wind in kph
+  - **wind_gust_1d_mph** [<sup>[1d]</sup>](#1d): Max. forecasted Wind in mph
   - **wind_kph**: Current wind speed in kph
   - **wind_mph**: Current wind speed in mph
+  - **wind_1d_kph** [<sup>[1d]</sup>](#1d): Forecasted wind speed in kph
+  - **wind_1d_mph** [<sup>[1d]</sup>](#1d): Forecasted wind speed in mph
   - **wind_string**: Text summary of current wind conditions
 
-All the conditions listed above will be updated each 5 minutes with exception of `alerts` that will be updated each 15 minutes by default.
+All the conditions listed above will be updated every 5 minutes.
+
+### Forecasts
+
+_12 hour forecasts_
+
+Monitored conditions marked above with <a name="12h">[12h]</a> 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 <a name="1d">[1d]</a> 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 <a name="1h">[1h]</a> 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
+--------------
+
+```yaml
+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:
+    dialy_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
+```
+
+![Daily Forecast](/images/screenshots/wunderground_daily_forecast.png)
+
+Weather overview
+----------------
+
+```yaml
+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
+```
+
+![Weather overview](/images/screenshots/wunderground_weather_overview.png)
+
 
 <p class='note warning'>
 Note: While the platform is called “wunderground” the sensors will show up in Home Assistant as “PWS” (eg: sensor.pws_weather).