diff --git a/source/_components/sensor.buienradar.markdown b/source/_components/sensor.buienradar.markdown index b42e120eddf..27f6dfd796c 100644 --- a/source/_components/sensor.buienradar.markdown +++ b/source/_components/sensor.buienradar.markdown @@ -46,23 +46,48 @@ Configuration variables: - **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. - **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 (%). - - **temperature**: The current temperature (in C). - - **groundtemperature**: The current ground temperature (in C). - - **windspeed**: The wind speed in m/s. - - **windforce**: The wind speed/force in Bft. + - **temperature**: The current temperature (in [C](https://en.wikipedia.org/wiki/Celsius)). + - **groundtemperature**: The current ground temperature (in [C](https://en.wikipedia.org/wiki/Celsius)). + - **windspeed**: The wind speed in [m/s](https://en.wikipedia.org/wiki/M/s). + - **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. - **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. - - **visibility**: Visibility in meters (m). - - **windgust**: The windspeed of wind gusts (m/s). + - **pressure**: The sea-level air pressure in [hPa](https://en.wikipedia.org/wiki/Hectopascal). + - **visibility**: Visibility in meters ([m](https://en.wikipedia.org/wiki/Metre)). + - **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_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. - - **irradiance**: Sun intensity in Watt per square meter (W/m2). - -Full configuration example where location is manually specified: + - **irradiance**: Sun intensity in Watt per square meter ([W/m2](https://en.wikipedia.org/wiki/W/m2)). + - **temperature_1d** [[1d]](#1d): The forecasted temperature (in [C](https://en.wikipedia.org/wiki/Celsius)). + - **mintemp_1d** [[1d]](#1d): The forecasted minimum temperature (in [C](https://en.wikipedia.org/wiki/Celsius)). + - **rainchance_1d** [[1d]](#1d): The forecasted chance for rain (%). + - **sunchance_1d** [[1d]](#1d): The forecasted chance for sun (%). + - **rain_1d** [[1d]](#1d): The forecasted amount of rain in [mm](https://en.wikipedia.org/wiki/Millimetre). + - **snow_1d** [[1d]](#1d): The forecasted amount of snow in [cm](https://en.wikipedia.org/wiki/Centimetre). + - **windforce_1d** [[1d]](#1d): The expected windforce in [Bft](https://en.wikipedia.org/wiki/Beaufort_scale). + - **conditioncode_1d** [[1d]](#1d): Symbol and condition code of the expected condition. + - **condition_1d** [[1d]](#1d): Symbol and expected condition. + - **conditiondetailed_1d** [[1d]](#1d): Symbol and detailed expected condition. + - **conditionexact_1d** [[1d]](#1d): Symbol and full expected condition (in English). + - **symbol_1d** [[1d]](#1d): Symbol and full expected condition (in Dutch). + + +## 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 `5`. + + +## Configuration examples + +Full configuration example (excluding forecasted conditions) where location is manually specified: ```yaml # Example configuration.yaml entry @@ -73,6 +98,10 @@ Full configuration example where location is manually specified: longitude: 5.70 monitored_conditions: - stationname + - conditioncode + - condition + - conditiondetailed + - conditionexact - symbol - humidity - temperature @@ -90,5 +119,47 @@ Full configuration example where location is manually specified: - 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) > 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.