Embalses en Home Assistant: guía de Global Water Reservoirs

Este artículo puede contener enlaces de afiliado. Si compras desde estos enlaces, el precio para ti es el mismo y la tienda me paga una pequeña comisión que ayuda a mantener Tecnoyfoto.

Albert BarnosellEditor y responsable de Tecnoyfoto

Global Water Reservoirs permite consultar embalses en Home Assistant utilizando datos publicados por organismos públicos. La integración crea sensores con el porcentaje de llenado, volumen almacenado, capacidad, nivel y antigüedad del dato, siempre que la fuente seleccionada facilite cada métrica.

Es una integración personalizada desarrollada por Tecnoyfoto, no una integración oficial de Home Assistant ni de los organismos que publican los datos. Actualmente se centra en las principales cuencas españolas e incorpora una primera cobertura de embalses de Estados Unidos mediante USBR / RISE.

Lo esencial: no mide el agua consumida en casa, no predice sequías y no sustituye los avisos de las autoridades. Su función es llevar a Home Assistant información pública sobre reservas de embalses para consultarla, representarla y crear avisos prudentes.

Qué es Global Water Reservoirs

Global Water Reservoirs es una integración comunitaria para Home Assistant que consulta distintas fuentes hidrológicas públicas y normaliza sus resultados. Así, datos publicados con formatos y unidades diferentes terminan convertidos en entidades coherentes dentro de Home Assistant.

El diseño utiliza dos niveles:

• Un hub por fuente o cuenca: representa la conexión con un organismo o proveedor de datos.
• Un dispositivo por embalse: contiene únicamente las entidades que esa fuente puede proporcionar para ese embalse.

Es posible añadir varios hubs en una misma instalación. Por ejemplo, se puede configurar una entrada para Cataluña y otra para la cuenca del Ebro. Después, desde las opciones de cada entrada, pueden añadirse o retirarse embalses y cambiar el intervalo de consulta.

La versión pública utilizada para esta revisión es la 1.1.24. El proyecto está publicado con licencia MIT y continúa evolucionando, por lo que conviene revisar el historial de cambios antes de actualizar.

Qué sensores crea en Home Assistant

La integración no inventa campos ausentes. Cada entidad se crea solamente cuando la fuente devuelve el dato necesario. Por eso dos embalses de cuencas distintas pueden mostrar conjuntos de sensores diferentes.

Capacidad, fecha y antigüedad se clasifican como entidades de diagnóstico. El dispositivo también incluye atributos útiles como fuente, cuenca, provincia, enlace de origen y una indicación de dato antiguo cuando supera las 72 horas.

Sensores agregados del hub

Cada hub puede añadir un segundo dispositivo con una visión conjunta de los embalses seleccionados:

• Porcentaje agregado.
• Volumen total.
• Capacidad total.
• Número de embalses devueltos.
• Embalses con datos utilizables.
• Embalses cuyos datos superan las 72 horas.
• Fecha del registro más reciente del conjunto.

Cómo calcula el porcentaje agregado

Este detalle es importante. Cuando existen volumen y capacidad, el porcentaje se pondera por capacidad:

porcentaje agregado = volumen total / capacidad total × 100

Este cálculo representa mejor la reserva conjunta que una media simple. Si la fuente no ofrece volumen y capacidad suficientes, la integración utiliza como alternativa la media de los porcentajes disponibles. En los atributos del sensor se indica el método utilizado: capacity_weighted o average_percent.

Países, cuencas y fuentes compatibles

A pesar del nombre “Global”, la cobertura actual no abarca todo el mundo. La integración soporta España y una selección limitada de embalses estadounidenses. Es preferible explicarlo así antes que prometer una cobertura todavía inexistente.

España

España se divide en hubs por cuenca o fuente. Según la demarcación, se utilizan servicios específicos SAIH, portales de las confederaciones, datos abiertos autonómicos o la capa de embalses de MITECO.

• Cataluña.
• Cuencas del Duero, Ebro, Guadiana, Guadalquivir, Júcar, Segura y Tajo.
• Cuencas del Miño-Sil y Cantábrico.
• Galicia Costa.
• Cuencas Internas del País Vasco.
• Cuenca Mediterránea Andaluza.
• Guadalete-Barbate.
• Tinto, Odiel y Piedras.
• Fuente de respaldo de España mediante MITECO.

Estados Unidos

La integración utiliza el sistema público USBR / RISE para una selección de embalses gestionados por el Bureau of Reclamation. Esta cobertura es más reducida y debe considerarse una primera implementación estadounidense, no una base completa de todos los embalses del país.

¿Por qué no se añaden países sin comprobar los datos?

Para que una fuente resulte útil no basta con que exista una API o un archivo descargable: los registros deben estar actualizados, identificarse correctamente y mantener un formato razonablemente estable. México, por ejemplo, se investigó, pero no se añadió porque los conjuntos estructurados accesibles durante el desarrollo estaban desactualizados.

Los datos no siempre son en tiempo real

Global Water Reservoirs es una integración de tipo cloud polling: Home Assistant consulta servicios públicos por Internet. Sin embargo, consultar una fuente cada hora no hace que esa fuente publique nuevos datos cada hora.

Algunos sistemas SAIH actualizan varias veces al día. Otros organismos publican información diaria o semanal. El asistente ofrece únicamente intervalos conservadores admitidos por cada proveedor —normalmente entre 1 y 24 horas— para no realizar peticiones inútiles o abusivas.

Para interpretar correctamente una lectura hay que mirar tres elementos:

1. El valor del sensor.
2. La fecha y hora del registro oficial.
3. La antigüedad del dato.

Si la antigüedad supera 72 horas, la integración lo marca como dato antiguo en sus atributos y lo contabiliza en el sensor agregado correspondiente. Esto no significa necesariamente que la integración esté averiada; la fuente oficial puede no haber publicado nada nuevo.

Cómo instalar Global Water Reservoirs con HACS

En este momento se instala como repositorio personalizado. No hay que confundirlo con una integración incluida en Home Assistant Core ni asumir que aparecerá automáticamente en el catálogo general de HACS.

1. Abre HACS → Integraciones.
2. Abre el menú de los tres puntos y selecciona Repositorios personalizados.
3. Añade esta dirección:

https://github.com/tecnoyfoto/global_water_reservoirs

4. Selecciona la categoría Integración.
5. Busca Global Water Reservoirs y pulsa Descargar.
6. Reinicia Home Assistant cuando HACS lo solicite.

Si todavía no utilizas HACS, consulta primero la guía para instalar HACS en Home Assistant. El archivo hacs.json del proyecto declara Home Assistant 2024.6.0 como versión mínima.

Instalación manual

También puede descargarse el repositorio y copiarse la carpeta de la integración en:

/config/custom_components/global_water_reservoirs/

La carpeta debe contener, entre otros archivos, manifest.json, config_flow.py, sensor.py, coordinator.py, providers y translations. Después hay que reiniciar Home Assistant. Para recibir actualizaciones con comodidad, HACS sigue siendo la opción recomendable.

Configuración paso a paso

1. Ve a Ajustes → Dispositivos y servicios.
2. Pulsa Añadir integración.
3. Busca Global Water Reservoirs o Embalses globales.
4. Selecciona el país.
5. Elige la cuenca o fuente de datos.
6. Marca uno o varios embalses.
7. Selecciona el intervalo de actualización ofrecido para esa fuente.
8. Finaliza el asistente y espera la primera consulta.

No requiere usuario, contraseña ni clave API. Si no puede obtener el listado inicial, el asistente muestra un error de conexión y no crea una entrada incompleta.

Añadir o retirar embalses más adelante

Abre Ajustes → Dispositivos y servicios → Global Water Reservoirs → Configurar. Desde las opciones puede modificarse la selección de embalses y el intervalo. Al guardar, Home Assistant recarga automáticamente ese hub.

Ejemplo de tarjeta para ver la evolución

Los identificadores dependen del nombre del embalse y de las entidades creadas. Copia siempre el identificador real desde Herramientas de desarrollador → Estados. Este ejemplo utiliza la tarjeta histórica incluida en Home Assistant y no necesita otra tarjeta de HACS:

type: history-graph
title: Evolución del embalse
hours_to_show: 336
entities:
  - entity: sensor.embalse_local_porcentaje
    name: Porcentaje de llenado
  - entity: sensor.embalse_local_volumen
    name: Volumen almacenado

El gráfico muestra 14 días. Si la fuente solo publica semanalmente, aparecerán pocos cambios: es el comportamiento esperado y no un fallo del historial.

Automatización segura: avisar sin actuar a ciegas

El porcentaje de un embalse no equivale por sí solo a una restricción legal de riego, ni demuestra qué depósito abastece una vivienda concreta. Por esa razón es más prudente utilizarlo para informar y revisar la situación que para abrir o cerrar automáticamente una válvula.

El siguiente ejemplo notifica cuando el porcentaje baja del 20 %, pero solo si el dato tiene menos de 72 horas. Sustituye las entidades y el servicio de notificación por los de tu instalación:

alias: "Embalse: nivel bajo con dato reciente"
triggers:
  - trigger: numeric_state
    entity_id: sensor.embalse_local_porcentaje
    below: 20
conditions:
  - condition: numeric_state
    entity_id: sensor.embalse_local_antiguedad_del_dato
    below: 72
actions:
  - action: notify.mobile_app_mi_telefono
    data:
      title: "Reserva del embalse"
      message: >-
        El embalse está al {{ states('sensor.embalse_local_porcentaje') }} %.
        Revisa la información oficial y las restricciones de tu municipio.
mode: single

Para automatizar el riego deberían combinarse además humedad del suelo, previsión de lluvia, estación del año, límites horarios y normas municipales. Las reservas regionales pueden aportar contexto, pero no deberían ser el único criterio.

Privacidad, seguridad y consumo de recursos

• No requiere credenciales, tokens ni cuentas externas.
• Solo consulta fuentes públicas por Internet.
• No controla presas, válvulas ni infraestructuras.
• Utiliza el cliente HTTP compartido de Home Assistant.
• Los intervalos están limitados por proveedor para mantener una consulta responsable.
• Los diagnósticos incluyen identificadores de embalses, proveedor y datos públicos normalizados, pero no contraseñas.

Como cualquier integración basada en servicios externos, su funcionamiento depende de que los portales públicos respondan y mantengan sus formatos. La versión 1.1.24 incorporó, por ejemplo, una corrección para restaurar la conexión segura con SAIH Ebro manteniendo la verificación TLS y añadiendo reintentos ante errores transitorios.

Limitaciones que debes conocer

• Es una integración comunitaria y no oficial.
• La cobertura actual se limita a España y a determinados embalses de Estados Unidos.
• No todas las fuentes ofrecen porcentaje, volumen, capacidad y nivel simultáneamente.
• Algunos valores se publican diariamente o semanalmente, no en tiempo real.
• Los portales institucionales pueden cambiar su formato sin aviso.
• Un porcentaje regional no sustituye las alertas de sequía ni las restricciones oficiales.
• La relación entre un embalse y el abastecimiento concreto de un municipio debe comprobarse fuera de la integración.

Solución de problemas

No aparece ningún embalse en el asistente

La fuente puede estar temporalmente caída o haber cambiado. Reintenta más tarde, revisa los registros y consulta las incidencias abiertas en GitHub.

Falta el sensor de nivel, capacidad o porcentaje

Las entidades son condicionales. Si el organismo no publica esa métrica para ese embalse, la integración no crea un sensor vacío ni estima el valor.

El valor no cambia aunque Home Assistant sí se actualiza

Comprueba la fecha y la antigüedad. Home Assistant puede haber consultado correctamente una fuente que aún conserva el mismo registro diario o semanal.

Quiero añadir embalses de otra cuenca

Crea otra entrada de Global Water Reservoirs para esa fuente. Cada cuenca funciona como un hub independiente.

Una fuente ha dejado de funcionar

Descarga los diagnósticos de la entrada y abre una incidencia en el repositorio de Global Water Reservoirs, indicando la cuenca y los embalses afectados.

Preguntas frecuentes

¿Global Water Reservoirs forma parte de Home Assistant?

No. Es una integración personalizada no oficial que se instala mediante HACS o manualmente.

¿Mide el consumo de agua de mi casa?

No. Para medir consumo doméstico hace falta un contador o caudalímetro compatible. Esta integración consulta reservas de embalses publicadas por organismos públicos.

¿Los datos son en tiempo real?

Depende de la fuente. Algunas actualizan varias veces al día y otras diariamente o semanalmente. Los sensores de fecha y antigüedad permiten comprobarlo.

¿Puedo utilizarla fuera de España?

Actualmente ofrece soporte inicial para determinados embalses estadounidenses mediante USBR / RISE. No incluye todavía una cobertura mundial.

¿Puedo solicitar una nueva cuenca o país?

Sí, mediante GitHub. La incorporación dependerá de que exista una fuente pública actualizada, identificable y suficientemente estable.

Conclusión

Global Water Reservoirs convierte información hidrológica pública y dispersa en sensores comprensibles dentro de Home Assistant. Su valor está en reunir porcentaje, volumen, nivel, fecha y antigüedad, además de crear resúmenes por cuenca que pueden representarse en paneles y utilizarse para avisos.

La integración es especialmente completa en España y abre una primera vía para Estados Unidos mediante USBR / RISE. No promete datos instantáneos ni cobertura universal: muestra lo que publica cada organismo y aporta herramientas para juzgar la frescura y calidad de esos datos.

Si quieres probarla, instálala como repositorio personalizado, empieza con uno o dos embalses y valida siempre la fecha del registro antes de crear automatizaciones.

Continúa leyendo

Siguiente guía relacionada · 7 min de lectura

Downgrade en Home Assistant: guía completa con mis fallos y cómo los arreglé

Cuando algo se rompe tras actualizar Home Assistant, hay dos opciones: aguantar el dolor o volver a la última versión que te funcionaba. Yo…

Continuar con este artículo↓