Skip to content

Update Swiss Hydrological Data documentation #6535

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fabaff merged 4 commits into from
Nov 11, 2018
Merged

Update Swiss Hydrological Data documentation #6535

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
649185f
Update Swiss Hydrological Data documentation
Bouni Oct 5, 2018
640aba5
Update
fabaff Nov 11, 2018
a49a7ee
Fix typo and style
fabaff Nov 11, 2018
9c0b6d8
Fix my copy-&-paste mistake:
fabaff Nov 11, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 23 additions & 25 deletions source/_components/sensor.swiss_hydrological_data.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,15 +13,11 @@ ha_iot_class: "Cloud Polling"
ha_release: 0.22
---

<p class='note warning'>
This sensor doesn't work at the moment due to changed by the [Swiss Federal Office for the Environment (Bundesamt für Umwelt - Abt. Hydrologie)](http://www.hydrodaten.admin.ch) to access the data.
</p>

The `swiss_hydrological_data` sensor will show you details (temperature, level, and discharge) of rivers and lakes in Switzerland.

## {% linkable_title Setup %}

The [station overview](http://www.hydrodaten.admin.ch/en/danger-levels-table.html) contains a list of all available measuring points and will help to determine the ID of station which is needed for the configuration.
The [station overview](https://www.hydrodaten.admin.ch/en/stations-and-data.html) contains a list of all available measuring points and will help to determine the ID of station which is needed for the configuration.

## {% linkable_title Configuration %}

Expand All @@ -32,36 +28,38 @@ To enable this sensor, add the following lines to your `configuration.yaml` file
sensor:
- platform: swiss_hydrological_data
station: STATION_ID
monitored_conditions:
- temperature
- level
- discharge
```

{% configuration %}
station:
description: The ID of the measurement point.
required: true
type: string
name:
description: Name to use in the frontend.
monitored_conditions:
description: The list of measurements you want to use. Available is `temperature`, `level` or `discharge`.
required: false
type: string
default:
type: list
default: temperature
{% endconfiguration %}
Copy link
Copy Markdown
Member

@frenck frenck Oct 6, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a list and that should have a keys attribute. You can use that attribute to list the possible measurement values.


The hydrological measurings are coming from the [Swiss Federal Office for the Environment (Bundesamt für Umwelt - Abt. Hydrologie)](http://www.hydrodaten.admin.ch) and are updated almost in real-time.

## {% linkable_title Example %}

This sensor contains additional information which an easily accessed by a [template sensor](/components/sensor.template/).
Sensors are exposing additional values through their attributes for all available conditions:

{% raw %}
```yaml
# Example configuration.yaml entry
sensor:
platform: template
sensors:
discharge:
value_template: '{{ states.sensor.aare.attributes.Discharge }}'
friendly_name: 'Discharge'
```
{% endraw %}
- `delta-24h`: The delta measurement for the last 24 hours.
- `max-1h`: The maximum measurement for the last hour.
- `max-24h`: The maximum measurement for the last 24 hours.
- `mean-1h`: The mean measurement for the last hour.
- `mean-24h`: The mean measurement for the last 24 hours.
- `min-1h`: The minimum measurement for the last hour.
- `min-24h`: The minimum measurement for the last 24 hours.
- `previous-24h`: The previous measurement for the last 24 hours.
- `station_update`: There is a time span between the sensor update in Home Assistant and the updates from the stations. Include those information if you are building automations based on the discharge of a water body.

<p class='note info'>
Copy link
Copy Markdown
Contributor

@WofWca WofWca Oct 5, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same

The sensors don't show the latest measurement, but those from the last hour due to the source of data. Some stations also don't provide data for certain measurements.
</p>

The hydrological measurements are coming from the [Swiss Federal Office for the Environment (Bundesamt für Umwelt - Abt. Hydrologie)](http://www.hydrodaten.admin.ch) and are updated every 10 minutes.