From fd9977313f5336522141108e0595425d7f6f523c Mon Sep 17 00:00:00 2001 From: rpitera Date: Fri, 31 Mar 2017 15:42:35 -0400 Subject: [PATCH] Update yweather component docs (#2347) Clarify the use of the forecast option and provide an example of its usage. --- source/_components/sensor.yweather.markdown | 33 ++++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/source/_components/sensor.yweather.markdown b/source/_components/sensor.yweather.markdown index e08539154e7..487c1a3047e 100644 --- a/source/_components/sensor.yweather.markdown +++ b/source/_components/sensor.yweather.markdown @@ -13,7 +13,7 @@ ha_release: 0.24 --- -The `yweather` platform uses [Yahoo Weather](https://www.yahoo.com/news/weather/) as an source for current meteorological data. The `forecast` will show you the condition for 5 days, 0 is the current day. You can use only `weather`, `temp_min`, and `temp_max` with forecast. +The `yweather` platform uses [Yahoo Weather](https://www.yahoo.com/news/weather/) as an source for current meteorological data. The `forecast` will show you the condition for 5 days, 0 is the current day. You can use only `weather`, `temp_min`, and `temp_max` with forecast. It's important to note that a yweather sensor will only show ONE days forecast at a time so to show multiple days forecasts, you will need to use the 'name:' option and give each sensor a unique name.

Use of the Yahoo Weather API should not exceed reasonable request volume. Access is limited to 2,000 signed calls per day. @@ -55,6 +55,37 @@ Configuration variables: - **pressure**: The sea-level air pressure in millibars. - **visibility**: The average visibility. +Example of forecast using multiple days. In example, first sensor shows tomorrow's forecast, second sensor shows the next day and so on: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: yweather + forecast: 1 + name: yw_day1 + monitored_conditions: + - weather + - temp_min + - temp_max + + - platform: yweather + forecast: 2 + name: yw_day2 + monitored_conditions: + - weather + - temp_min + - temp_max + + - platform: yweather + forecast: 3 + name: yw_day3 + monitored_conditions: + - weather + - temp_min + - temp_max + +``` + Details about the API are available in the [Yahoo! Developer Network](https://developer.yahoo.com/weather/).