update buienradar sensor docs (#3154)

* update buienradar sensor docs

Update documentation for https://github.com/home-assistant/home-assistant/pull/8897

* Update sensor.buienradar.markdown
This commit is contained in:
mjj4791 2017-08-21 14:45:35 +02:00 committed by Fabian Affolter
parent 07a40fa405
commit 3230da9fc1

View File

@ -46,23 +46,48 @@ Configuration variables:
- **timeframe** (*Optional*): Minutes to look ahead for precipitation forecast (5..120) [default: 60]. - **timeframe** (*Optional*): Minutes to look ahead for precipitation forecast (5..120) [default: 60].
- **monitored_conditions** array (*Required*): One or more conditions to display in the frontend. - **monitored_conditions** array (*Required*): One or more conditions to display in the frontend.
- **stationname**: The name of the selected meteo-station. - **stationname**: The name of the selected meteo-station.
- **symbol**: A symbol for the current weather. - **conditioncode**: A symbol and a unique code identifying the current weather condition ([a..z]).
- **condition**: A symbol and the current weather condition (clear, cloudy, fog, rainy, snowy, lightning).
- **conditiondetailed**: A symbol and detailed current weather condition (clear, partlycloudy, cloudy, partlycloudy-fog, partlycloudy-light-rain, partlycloudy-rain, light-rain, rainy, snowy-rainy, partlycloudy-light-snow, partlycloudy-snow, light-snow, snowy, partlycloudy-lightning, lightning).
- **conditionexact**: A symbol with the full current weather condition (in English).
- **symbol**: A symbol for the current weather with the full current condition (in Dutch).
- **humidity**: The relative humidity (%). - **humidity**: The relative humidity (%).
- **temperature**: The current temperature (in C). - **temperature**: The current temperature (in [C](https://en.wikipedia.org/wiki/Celsius)).
- **groundtemperature**: The current ground temperature (in C). - **groundtemperature**: The current ground temperature (in [C](https://en.wikipedia.org/wiki/Celsius)).
- **windspeed**: The wind speed in m/s. - **windspeed**: The wind speed in [m/s](https://en.wikipedia.org/wiki/M/s).
- **windforce**: The wind speed/force in Bft. - **windforce**: The wind speed/force in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale).
- **winddirection**: Where the wind is coming from: N (North),Z (south), NO (Noth-East), etc. - **winddirection**: Where the wind is coming from: N (North),Z (south), NO (Noth-East), etc.
- **windazimuth**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise. - **windazimuth**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise.
- **pressure**: The sea-level air pressure in hPa. - **pressure**: The sea-level air pressure in [hPa](https://en.wikipedia.org/wiki/Hectopascal).
- **visibility**: Visibility in meters (m). - **visibility**: Visibility in meters ([m](https://en.wikipedia.org/wiki/Metre)).
- **windgust**: The windspeed of wind gusts (m/s). - **windgust**: The windspeed of wind gusts ([m/s](https://en.wikipedia.org/wiki/M/s)).
- **precipitation**: The amount of precipitation/rain in mm/h. - **precipitation**: The amount of precipitation/rain in mm/h.
- **precipitation_forecast_average**: The average expected precipitation/rain in mm/h within the given timeframe. - **precipitation_forecast_average**: The average expected precipitation/rain in mm/h within the given timeframe.
- **precipitation_forecast_total**: The total expected precipitation/rain in mm within the given timeframe. The total expected rain in the configured timeframe will be equal to _precipitation_forecast_total_/_timeframe_ mm/min. So, with timeframe configured to 30 minutes and a value of 5, the expected rain is 5 mm in 30 minutes, which is the same as 10 mm/h. If timeframe is set to 90 minutes and a value of 5, the expected rain is 5 mm in 90 minutes, which is equal to 3.3 mm/h. - **precipitation_forecast_total**: The total expected precipitation/rain in mm within the given timeframe. The total expected rain in the configured timeframe will be equal to _precipitation_forecast_total_/_timeframe_ mm/min. So, with timeframe configured to 30 minutes and a value of 5, the expected rain is 5 mm in 30 minutes, which is the same as 10 mm/h. If timeframe is set to 90 minutes and a value of 5, the expected rain is 5 mm in 90 minutes, which is equal to 3.3 mm/h.
- **irradiance**: Sun intensity in Watt per square meter (W/m2). - **irradiance**: Sun intensity in Watt per square meter ([W/m2](https://en.wikipedia.org/wiki/W/m2)).
- **temperature_1d** [<sup>[1d]</sup>](#1d): The forecasted temperature (in [C](https://en.wikipedia.org/wiki/Celsius)).
Full configuration example where location is manually specified: - **mintemp_1d** [<sup>[1d]</sup>](#1d): The forecasted minimum temperature (in [C](https://en.wikipedia.org/wiki/Celsius)).
- **rainchance_1d** [<sup>[1d]</sup>](#1d): The forecasted chance for rain (%).
- **sunchance_1d** [<sup>[1d]</sup>](#1d): The forecasted chance for sun (%).
- **rain_1d** [<sup>[1d]</sup>](#1d): The forecasted amount of rain in [mm](https://en.wikipedia.org/wiki/Millimetre).
- **snow_1d** [<sup>[1d]</sup>](#1d): The forecasted amount of snow in [cm](https://en.wikipedia.org/wiki/Centimetre).
- **windforce_1d** [<sup>[1d]</sup>](#1d): The expected windforce in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale).
- **conditioncode_1d** [<sup>[1d]</sup>](#1d): Symbol and condition code of the expected condition.
- **condition_1d** [<sup>[1d]</sup>](#1d): Symbol and expected condition.
- **conditiondetailed_1d** [<sup>[1d]</sup>](#1d): Symbol and detailed expected condition.
- **conditionexact_1d** [<sup>[1d]</sup>](#1d): Symbol and full expected condition (in English).
- **symbol_1d** [<sup>[1d]</sup>](#1d): Symbol and full expected condition (in Dutch).
## 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 `5`.
## Configuration examples
Full configuration example (excluding forecasted conditions) where location is manually specified:
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
@ -73,6 +98,10 @@ Full configuration example where location is manually specified:
longitude: 5.70 longitude: 5.70
monitored_conditions: monitored_conditions:
- stationname - stationname
- conditioncode
- condition
- conditiondetailed
- conditionexact
- symbol - symbol
- humidity - humidity
- temperature - temperature
@ -90,5 +119,47 @@ Full configuration example where location is manually specified:
- precipitation_forecast_total - precipitation_forecast_total
``` ```
Configuration example with current condition and (some) forecasted values:
```yaml
# Weather prediction
sensor:
- platform: buienradar
monitored_conditions:
# current condition:
- condition
- conditioncode
- conditiondetailed
- conditionexact
- symbol
# conditions for forecasted data:
- symbol_1d
- symbol_2d
- symbol_3d
- symbol_4d
- symbol_5d
- temperature_1d
- temperature_2d
- temperature_3d
- temperature_4d
- temperature_5d
- rainchance_1d
- rainchance_2d
- rainchance_3d
- rainchance_4d
- rainchance_5d
- sunchance_1d
- sunchance_2d
- sunchance_3d
- sunchance_4d
- sunchance_5d
- rain_1d
- rain_2d
- rain_3d
- rain_4d
- rain_5d
```
[Usage statement:](https://www.buienradar.nl/overbuienradar/gratis-weerdata) [Usage statement:](https://www.buienradar.nl/overbuienradar/gratis-weerdata)
> Buienradar makes free weatherdata available for use by individuals and businesses (website/intranet). The use of the weatherdata is allowed for **non-commercial purposes**. Please refer to the full usage statement linked above to confirm your usage or to request permission. > Buienradar makes free weatherdata available for use by individuals and businesses (website/intranet). The use of the weatherdata is allowed for **non-commercial purposes**. Please refer to the full usage statement linked above to confirm your usage or to request permission.