Saltar al contenido principal

Integración domótica Alplakes, gratuita y de código abierto

Integración Alplakes para Gladys Assistant

Temperatura del agua de los lagos alpinos (Lemán, Annecy, Bourget…) y su previsión, por el Eawag.

Lleva a Gladys la temperatura del agua de los lagos alpinos: el lago Lemán, el lago de Annecy, el lago del Bourget, el lago de Constanza, el lago de Zúrich, el lago de Lucerna, el lago Mayor, el lago de Garda, el lago de Como y más de un centenar de lagos suizos, franceses, italianos, alemanes, austriacos y eslovenos, con una previsión para los dos próximos días. Los valores proceden de Alplakes, la plataforma de lagos del Eawag, el Instituto Federal Suizo de Ciencia y Tecnología Acuáticas. Sin cuenta ni clave.

Simulaciones calibradas con mediciones, no mediciones directas. Alplakes ejecuta modelos hidrodinámicos de cada lago, alimentados por la previsión meteorológica y contrastados con mediciones: el valor puede diferir un grado o más de lo que marca un termómetro en su playa. Esta integración no está afiliada al Eawag.

Lo que obtiene​

  • Un dispositivo por lago seguido, según el modelo 1D del lago entero (Simstrat): la temperatura actual del agua, el máximo de las próximas 24 horas y de las próximas 48 horas, y el cambio previsto en 24 horas (por ejemplo +0,6 °C).
  • Un dispositivo por punto preciso (una playa, un puerto, un embarcadero) en los lagos con modelo 3D (Lemán, Annecy, Bourget, Zúrich, Lucerna, Lugano, Garda, Biel, Neuchâtel, Zug, Morat…): los mismos cuatro valores, en la celda del modelo más cercana al punto.
  • La temperatura en la superficie (para el baño) o a 1, 2, 5 o 10 m de profundidad.
  • Un disparador de escena: el agua alcanza una temperatura (de 10 a 28 °C), ahora o en la previsión de las próximas 48 horas, o vuelve a bajar de ella.
  • Un widget de panel: sus lagos, su temperatura, el máximo de las próximas 48 horas y la tendencia.
  • Un botón «Buscar lagos» que lista los lagos por nombre, con su clave.

Requisitos​

  • Gladys Assistant 5.3.0 o posterior.
  • Acceso a Internet desde Gladys (la integración consulta la API pública de Alplakes).

Configuración​

Instale la integración desde Integraciones → Instalar desde GitHub con la dirección https://github.com/guim31/gladys-alplakes y, después, abra su pestaña Configuración.

Ajustes​

  • Lagos: nombres o claves, separados por comas, 10 como máximo. Un nombre funciona en inglés, francés, alemán o italiano, con o sin artículo: Léman, Lake Geneva, Genfersee, Annecy, Lac du Bourget, Thunersee. Algunos lagos están divididos en cuencas (Zúrich, Constanza, Lugano, Lucerna): indique la clave de la cuenca (upperzurich, lowerconstance…).
  • Puntos precisos (opcional): lago: latitud, longitud nombre, separados por punto y coma, 10 como máximo, por ejemplo Léman: 46.2107, 6.1613 Bains des Pâquis. El nombre es opcional. Las coordenadas van en grados decimales con punto (cópielas de un mapa); se conservan cuatro decimales.
  • Profundidad: superficie (por defecto), 1, 2, 5 o 10 m. Se aplica a todos los lagos y puntos.
  • Idioma de los nombres: el idioma de los nombres de los dispositivos y de las funciones, fijado al crear los dispositivos en Gladys.

Guarde y, después, cree los dispositivos en la pestaña Descubrir. El estado de conexión de la pestaña Configuración indica lo que no se puede seguir: un lago desconocido, un nombre que corresponde a varios lagos, un punto ilegible, un lago sin modelo 3D, un punto demasiado lejos del lago (a más de 1,5 km de la celda más cercana del modelo).

Encontrar sus lagos​

El botón Buscar lagos lista los lagos que corresponden a un nombre, con su clave, e indica cuáles tienen modelo 3D (puntos precisos posibles). Si lo deja vacío, lista los lagos con modelo 3D. Copie un nombre o una clave en Lagos y guarde.

Dispositivos​

Cada lago o punto es un dispositivo con cuatro funciones de solo lectura, en °C:

FunciónContenido
Temperatura del aguaLa temperatura actual, entre los dos pasos del modelo que la rodean
Máx. próximas 24 hEl valor más cálido de las próximas 24 horas (al menos el actual)
Máx. próximas 48 hEl valor más cálido de las próximas 48 horas
Cambio en 24 hLa temperatura dentro de 24 horas menos la actual (con signo)

La temperatura y el cambio se publican como temperaturas de «sonda»: un lago colocado en una habitación de Gladys no cambia la temperatura de esa habitación. Los valores se calculan cada hora a partir de la serie del modelo, y Alplakes se consulta de nuevo cada 3 horas.

Widget de panel​

Añada el widget Alplakes → Lagos a un panel.

  • Sin lago elegido: una línea por lago o punto (10 como máximo) con la temperatura actual, el máximo de las próximas 48 horas y el icono de tendencia (se calienta, estable, se enfría).
  • Con un lago elegido: sus cuatro valores, en directo.

Unos ajustes ocultan la previsión y el enlace al sitio de Alplakes. El widget termina con la mención «Datos: Alplakes, Eawag (CC BY 4.0)» y la hora de los últimos datos.

Disparador de escena​

Umbral de temperatura del agua cruzado se dispara cuando el agua de un lago o punto seguido alcanza una temperatura, o vuelve a bajar 0,3 °C por debajo (un valor que oscila alrededor de un umbral solo dispara una vez). Filtros: el lago o punto, el valor (la temperatura actual o el máximo de las próximas 48 horas), las temperaturas (de 10 a 28 °C) y el sentido (alcanzada, vuelve a bajar). La escena puede usar el nombre del lago, la temperatura del agua, el umbral, el código del valor (current, forecast_48h) y el código del sentido (rising, falling).

Para cualquier otra condición (por encima de 21,5 °C, entre dos valores…), use el disparador de dispositivo habitual de Gladys sobre las funciones del dispositivo.

Ejemplos de escenas​

  • Temporada de baño: cuando el lago de Annecy alcanza 20 °C (temperatura actual, alcanzada), enviar «El lago está a {temperatura} °C, ¡hora de bañarse!».
  • Planificar el fin de semana: cuando el máximo de las próximas 48 horas de su playa alcanza 22 °C, enviar un mensaje el jueves por la tarde.
  • Fin de temporada: cuando el lago vuelve a bajar de 16 °C, recordarle que guarde la tabla de paddle.

Fuentes de datos, licencia y cuotas​

  • Alplakes (Eawag, https://www.alplakes.eawag.ch): API https://alplakes-api.eawag.ch, modelos Simstrat (1D, uno por lago o cuenca), Delft3D-FLOW y MITgcm (3D), alimentados por la previsión de MeteoSuiza. Nombres de los lagos: la lista estática del sitio de Alplakes.
  • Licencia: CC BY 4.0. Mención: «Datos: Alplakes, Eawag (CC BY 4.0)», mostrada en el widget y en la pestaña Configuración. Atribución exigida: Alplakes, Eawag (CC BY 4.0).
  • Uso razonable: la API está limitada por cliente. La integración pide una serie por lago o punto cada 3 horas (el ritmo de los modelos), espaciadas un segundo, con un User-Agent identificable, y la lista de lagos una vez al día. Una petición fallida conserva la última serie: la previsión sigue siendo útil unos dos días.
  • A Alplakes solo se envían las claves de los lagos, la profundidad y las coordenadas de sus puntos.

Solución de problemas​

  • «Lago desconocido»: use Buscar lagos; los lagos pequeños tienen su propia clave (rotsee, oeschinensee).
  • «Varios lagos corresponden»: el lago está dividido en cuencas: indique la clave de la cuenca.
  • «No hay modelo 3D»: los puntos precisos solo son posibles en los lagos con modelo 3D; siga el lago entero en su lugar.
  • «Punto demasiado lejos del lago»: las coordenadas probablemente están invertidas (primero la latitud) o en tierra firme.
  • «Alplakes no responde»: los valores continúan según la última previsión; volverán con el servicio.
  • Registros: LOG_LEVEL=debug muestra cada pasada.

Límites​

  • Simulaciones, no mediciones: los modelos son buenos de media, menos cerca de una desembocadura, en una bahía poco profunda o tras una tormenta.
  • El modelo 1D da un valor para todo el lago; para una playa, use un punto preciso.
  • Un cambio de profundidad vuelve a pedir todas las series; un cruce durante un reinicio no dispara nada.
  • Los nombres españoles de los lagos solo existen para los grandes lagos; los demás conservan su nombre inglés.
  • No está afiliada al Eawag. Datos: Alplakes, Eawag (CC BY 4.0).

Parámetros de configuración​

Estos son los parámetros que Alplakes te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Sus lagossectionNoSiga la temperatura del agua de los lagos alpinos, simulada por Alplakes (Eawag) y actualizada cada 3 horas. «Buscar lagos» más abajo lista sus nombres. Guarde y, después, cree los dispositivos en la pestaña Descubrir.
LagosstringNoNombres o claves, separados por comas (10 como máximo). Un dispositivo por lago, según su modelo 1D.
Puntos precisos (opcional)stringNoUna playa o un puerto: «lago: latitud, longitud nombre», separados por punto y coma (10 como máximo). Solo para los lagos con modelo 3D.
ProfundidadselectNoProfundidad de la temperatura: la superficie para el baño, más abajo para la pesca o el buceo.
Idioma de los nombresselectNoIdioma de los nombres de los lagos y de las funciones, fijado al crear los dispositivos.
Acerca de los datossectionNoSimulaciones de los modelos Alplakes (Eawag), calibradas con mediciones: no son mediciones directas. Datos: Alplakes, Eawag (CC BY 4.0).

Cómo instalar Alplakes en Gladys​

  1. En Gladys, abre Integraciones: Alplakes aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-alplakes:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-alplakes.

Alplakes requiere Gladys >=5.3.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

Alplakes es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂