PEGELONLINE

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.

Configuration

To add the PEGELONLINE service to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select PEGELONLINE.

  • Follow the instructions on screen to complete the setup.

Step 1 - Location selection

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

Latitude

The latitude of the center of the search area (automatically filled by the location picker).

Longitude

The longitude of the center of the search area (automatically filled by the location picker).

Radius

Search radius (in km)

Step 2 - Station selection

Station

Select the measurement station you want to add.

Sensors

The following sensorsSensors return information about a thing, for instance the level of water in a tank. [Learn more] 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

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three-dot menu. Then, select Delete.