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

title, description, ha_category, ha_release, ha_iot_class, ha_config_flow, ha_codeowners, ha_domain, ha_platforms, ha_integration_type, ha_quality_scale

title	description	ha_category	ha_release	ha_iot_class	ha_config_flow	ha_codeowners	ha_domain	ha_platforms	ha_integration_type	ha_quality_scale
IMGW-PIB	Instructions on how to integrate IMGW-PIB (Polish Institute of Meteorology and Water Management - National Research Institute) hydrological service within Home Assistant.	Environment	2024.6	Cloud Polling	true	@bieniu	imgw_pib	diagnostics sensor	integration	platinum

IMGW-PIB {% term integration %} uses hydrological data from Institute of Meteorology and Water Management - National Research Institute to present information about rivers and water reservoirs in Poland.

{% include integrations/config_flow.md %}

{% configuration_basic %} Hydrological station: description: "Select a hydrological station from the list of available stations." {% endconfiguration_basic %}

Removing the integration

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

{% include integrations/remove_device_service.md %}

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 {% term polling polls %} 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: "{{ trigger.to_state.state }}, probability {{ trigger.to_state.attributes.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.