Documentation for Buienradar sensor- and weather-component (#2638)

* Create sensor.buienradar.markdown

* Create weather.buienradar.markdown

* Update sensor.buienradar.markdown

* processed reviews

* Update weather.buienradar.markdown

* Update sensor.buienradar.markdown
This commit is contained in:
mjj4791 2017-06-05 08:48:53 +02:00 committed by Paulus Schoutsen
parent b5082e6271
commit 6d4129c551
2 changed files with 126 additions and 0 deletions

View File

@ -0,0 +1,78 @@
---
layout: page
title: "Buienradar"
description: "Instructions how to integrate buienradar.nl sensor within Home Assistant."
date: 2017-05-15 14:00
sidebar: true
comments: false
sharing: true
footer: true
logo:
ha_category: Weather
ha_release: 0.44
---
The `buienradar` platform uses [buienradar.nl](http://buienradar.nl/) as an source for current meteorological data for your location. The
weather forecast is delivered by Buienradar, who provides a webservice that provides detailed weather information for users in The Netherlands.
The relevant weatherstation used will be automatically selected based on the location specified in the Home Assistant configuration (or in the buienradar weather/sensor component).
To integrate `buienradar` with Home Assistant, add the following section to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
sensor:
- platform: buienradar
monitored_conditions:
- symbol
- humidity
- temperature
- windspeed
- pressure
```
Configuration variables:
- **platform** (*Required*): buienradar.
- **latitude** (*Optional*): latitude to use for selection of data source location. Longitude & latitude will be taken from Home Assistant configuration, but can be overridden/changed in this component to select a different location for buienradar.
- **longitude** (*Optional*): longitude to use for selection of data source location. Longitude & latitude will be taken from Home Assistant configuration, but can be overridden/changed in this component to select a different location for buienradar.
- **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.
- **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.
- **winddirection**: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise.
- **windazimuth**: Where the wind is coming from: N (North),Z (south), NO (Noth-East), etc..
- **pressure**: The sea-level air pressure in hPa.
- **visibility**: Visibility in meters (m).
- **windgust**: The windspeed of wind gusts (m/s).
- **precipitation**: the amount of precipitation/rain in mm/h.
- **irradiance**: Sun intensity in Watt per square meter (W/m2).
Full configuration example where location is manually specified:
```yaml
# Example configuration.yaml entry
- platform: buienradar
latitude: 51.65
longitude: 5.70
monitored_conditions:
- stationname
- symbol
- humidity
- temperature
- groundtemperature
- windspeed
- windforce
- winddirection
- windazimuth
- pressure
- visibility
- windgust
- precipitation
- irradiance
```

View File

@ -0,0 +1,48 @@
---
layout: page
title: "Buienradar Weather"
description: "Instructions how to integrate buienradar.nl weather within Home Assistant."
date: 2017-05-15 14:00
sidebar: true
comments: false
sharing: true
footer: true
logo:
ha_category: Weather
ha_release: 0.44
---
The `buienradar` platform uses [buienradar.nl](http://buienradar.nl/) as an source for current meteorological data for your location. The
weather forecast is delivered by Buienradar, who provides a webservice that provides detailed weather information for users in The Netherlands.
The relevant weatherstation used will be automatically selected based on the location specified in the Home Assistant configuration (or in the buienradar weather/sensor component).
To add the buienradar weather to your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
weather:
- platform: buienradar
```
Configuration variables:
- **platform** (*Required*): buienradar
- **latitude** (*Optional*): latitude to use for selection of data source location. Longitude & latitude will be taken from Home Assistant configuration, but can be overridden/changed in this component to select a different location for buienradar.
- **longitude** (*Optional*): longitude to use for selection of data source location. Longitude & latitude will be taken from Home Assistant configuration, but can be overridden/changed in this component to select a different location for buienradar.
- **forecast** (*Optional*): 'True' to add a temperature forecast, 'False' to suppress it
A full configuration example:
```yaml
weather:
- platform: buienradar
name: buienradar
latitude: 51.65
longitude: 5.70
forecast: True
```
<p class='note'>
This platform is an alternative to the [`buienradar`](/components/sensor.buienradar/) sensor.
The weather platform is easier to configure but less customisable.
</p>