IMGW-PIB

IMGW-PIB integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] uses hydrological data from Institute of Meteorology and Water Management - National Research Institute to present information about rivers and water reservoirs in Poland.

Configuration

To add the IMGW-PIB integration 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 IMGW-PIB.

  • Follow the instructions on screen to complete the setup.

Hydrological station

Select a hydrological station from the list of available stations.

Removing the integration

This integration follows standard integration removal, no extra steps are required.

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 dots menu. Then, select Delete.

Supported functionality

The IMGW-PIB integration provides the following entities.

Sensors

  • Water level
    • Description: Water level in the river or reservoir at the measurement point
  • Water flow
    • Description: River water flow at the measurement point
    • Remarks: Not available for all hydrological stations
  • Water temperature
    • Description: Water temperature in the river or reservoir at the measurement point
    • Remarks: Not available for all hydrological stations
  • Hydrological alert
    • Description: Provides information on hydrological alerts for a given river or reservoir

Data updates

By default, the integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] data from the IMGW-PIB API every 30 minutes.

Possible use-cases

  • Monitor hydrological alerts to protect your family and property from floods.
  • Monitor river water levels to gain long-term insight into climate change in your area.

Examples

Create a hydrological alert notification

This automation will create a persistent notification with the content and probability of a hydrological alert:

automation:
  - alias: Hydrological alert
    triggers:
      - trigger: state
        entity_id:
          - sensor.warta_oborniki_hydrological_alert
        from: no_alert
    actions:
      - action: persistent_notification.create
        data:
          title: Hydrological alert!
          message: ", probability %"

Known limitations

  • The integration provides data for hydrological stations available through the public IMGW-PIB API. Some hydrological stations are not available in this data and therefore the integration does not support them.
  • Not all hydrological stations provide all data, so the set of entities for individual stations may differ.