home-assistant.io/source/_integrations/pegel_online.markdown

title	description	ha_category	ha_release	ha_config_flow	ha_iot_class	ha_domain	ha_platforms	ha_codeowners	ha_integration_type
PEGELONLINE	Instructions on how to integrate PEGELONLINE measurements into Home Assistant.	Environment Sensor	2023.8	true	Cloud Polling	pegel_online	diagnostics sensor	@mib1185	service

This integration uses the data from the German Federal Waterways and Shipping Administration (Wasserstraßen- und Schifffahrtsverwaltung des Bundes) PEGELONLINE to provide different sensors, based on the available data of the selected measurement station.

Data fetching and limitations

The data are polled every 5 minutes. You can add as many measurement stations as want, there is no authentication needed nor any official usage limitation, but keep the "fair use" in mind.

{% include integrations/config_flow.md %}

Step 1 - Location selection

Select the area, where you want to search for available water measuring stations

{% configuration_basic %} Latitude: description: "The latitude of the center of the search area (automatically filled by the location picker)." Longitude: description: "The longitude of the center of the search area (automatically filled by the location picker)." Radius: description: "Search radius (in km)" {% endconfiguration_basic %}

Step 2 - Station selection

{% configuration_basic %} Station: description: "Select the measurement station you want to add." {% endconfiguration_basic %}

Sensors

The following {% term sensors %} are created, based on the capabilities of the selected measurement station:

Sensor name	Common unit of measurement
Air temperature	°C
Clearance height (only for bridges)	cm
Oxygen level	mg/l
pH	None
Water flow speed	m/s
Water level	cm
Water temperature	°C
Water volume flow	m³/s

Usage example

Flood alert level notification

Create an automation to get notified, when your local river reaches a specific flood alert level.

mode: single
triggers:
  - trigger: numeric_state
    entity_id:
      - sensor.dresden_elbe_water_level
    above: 500
actions:
  - action: notify.persistent_notification
    metadata: {}
    data:
      message: Flood alert level 2 reached!

Troubleshooting

In any case, when reporting an issue, please enable debug logging, restart the integration, and as soon as the issue reoccurs stop the debug logging again (download of debug log file will start automatically). Further if still possible, please also download the diagnostics data. If you have collected the debug log and the diagnostics data, provide them with the issue report.

Remove the integration

{% include integrations/remove_device_service.md %}