Integración domótica KNMI, gratuita y de código abierto
Tiempo oficial neerlandés (KNMI vía Weerlive): observaciones, previsiones y avisos KNMI.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.2.0
- ★ 0
El tiempo oficial de los Países Bajos en Gladys: las observaciones, las previsiones y los avisos del KNMI (Koninklijk Nederlands Meteorologisch Instituut, el instituto meteorológico neerlandés), leídos a través de la API gratuita de Weerlive.nl. Pensada para los neerlandeses que viven en Francia, para quienes viven cerca de la frontera belga-neerlandesa y para cualquiera que tenga una casa en los Países Bajos.
Desarrollada sin cuenta de Weerlive: sus comentarios son bienvenidos. La integración se ha construido y probado con respuestas reales de Weerlive (publicadas por los proyectos python-weerlive y ha-knmi), no con el servicio real. Indique lo que funciona y lo que no en las issues.
Esta integración no tiene relación con el KNMI ni con Weerlive.
Presentación
- Un dispositivo por lugar: una casa de Gladys (su ubicación), ciudades neerlandesas o coordenadas, cinco lugares como máximo.
- Cada dispositivo muestra la temperatura, la sensación térmica, la humedad, la presión, el viento (Beaufort, km/h y dirección), la visibilidad, la precipitación prevista para la próxima hora, las condiciones, la salida y la puesta del sol, y el aviso del KNMI: su color (verde, amarillo, naranja, rojo), su título y su texto, y el próximo aviso anunciado.
- Un disparador de escena Nuevo aviso KNMI, con el texto del KNMI listo para una notificación.
- Un widget Previsión KNMI: valores en directo, avisos, sol y previsión a 5 días.
- Solo lectura: no se puede controlar nada.
Requisitos
- Gladys Assistant 5.2.0 o posterior (elección de la casa en la configuración, widgets, disparadores de escena).
- Una clave de API gratuita de Weerlive: rellene el formulario de weerlive.nl/delen.php con su dirección de correo; la clave llega por correo electrónico. Weerlive reserva la clave gratuita para un uso personal y de ocio.
- Acceso a Internet para Gladys (la integración llama a
weerlive.nl). - La pantalla de instalación pide acceso a la ubicación de sus casas: solo se usa para la casa elegida en la configuración.
Configuración
Abra Integraciones → KNMI → Configuración.
Clave de API de Weerlive
Pegue la clave recibida por correo. Se guarda en la configuración de Gladys, nunca en los registros.
Lugares
- Casa de Gladys: seguir el tiempo en la ubicación de esta casa (definida en Ajustes → Casas). Las coordenadas se envían a Weerlive redondeadas a dos decimales, aproximadamente 1 km.
- Otros lugares: ciudades neerlandesas (
Amsterdam,'s-Hertogenbosch) o coordenadas (52.09,5.12), separadas por punto y coma. Weerlive elige la estación más cercana: el botón Probar la conexión indica el lugar encontrado. - Cinco lugares como máximo, casa incluida.
Abra después la pestaña Descubrimiento y añada los dispositivos que desee: solo se leen los dispositivos añadidos.
Actualización y cuota
La clave gratuita permite 300 solicitudes al día, y Weerlive actualiza sus datos cada
10 minutos. La integración lee cada lugar añadido como mucho cada 10 minutos (campo Intervalo de
actualización) y se ralentiza por sí sola con varios lugares para que todos juntos queden por
debajo de 240 solicitudes al día: 12 minutos con dos lugares, 18 con tres, 30 con cinco. La última
lectura se guarda en /data: un reinicio de Gladys no vuelve a gastar la cuota, y mostrar el widget
nunca hace una solicitud.
Idioma
Idioma de los textos (francés por defecto) da nombre a las funciones de los nuevos dispositivos y escribe las condiciones y las fechas. Los nombres de las funciones se fijan al añadir el dispositivo. Los textos de aviso del KNMI siguen en neerlandés, tal como los escribe el KNMI.
Dispositivos
Todas las funciones son de solo lectura.
| Función | Valor |
|---|---|
| Temperatura, sensación térmica | °C |
| Humedad | % |
| Presión atmosférica | hPa |
| Viento (Beaufort) | 0 a 12 |
| Velocidad del viento | km/h |
| Dirección del viento | grados (0 = del norte, 90 = del este) |
| Visibilidad | km |
| Precipitación, próxima hora | mm previstos para la hora en curso |
| Condiciones | soleado, nublado, chubascos… en el idioma elegido |
| Salida y puesta del sol | hora local de los Países Bajos (la misma que en Francia y Bélgica) |
| Nivel de aviso KNMI | 0 verde, 1 amarillo, 2 naranja, 3 rojo |
| Aviso KNMI, texto | título y texto del KNMI, en neerlandés |
| Alarma meteorológica | 1 cuando Weerlive señala una alarma meteorológica para la región |
| Nivel del próximo aviso | color del próximo aviso anunciado (0 si no hay ninguno) |
| Próximo aviso KNMI desde | su inicio, o «Ninguno» |
Widget
Añada el widget Previsión KNMI a un panel y elija un lugar. Muestra el lugar y las condiciones, tres mosaicos en directo (temperatura, sensación, viento), la previsión a 5 días (mínima y máxima, probabilidad de lluvia, viento), el aviso vigente y el siguiente con sus colores, la salida y la puesta del sol, y el texto neerlandés del KNMI cuando hay un aviso en vigor. Se construye a partir de la última lectura: no cuesta ninguna solicitud.
Disparador de escena
Nuevo aviso KNMI se dispara una vez por cada aviso nuevo:
- En vigor: empieza un aviso amarillo, naranja o rojo para el lugar, u otro aviso lo sustituye;
- Anunciado para más tarde: el KNMI anuncia un aviso que empieza más tarde, la primera vez que se ven ese color y ese inicio.
Filtros: el lugar, los colores, cuándo. Variables para las acciones: place, level (yellow,
orange, red), level_number (1 a 3), phase (current, upcoming), title y text (en
neerlandés, para un aviso en vigor), starts_at (fecha ISO). La primera lectura tras la
instalación solo registra lo que está en vigor, y un reinicio nunca vuelve a disparar el mismo
aviso. El fin de un aviso no es un evento: use la función Nivel de aviso KNMI (= 0).
Acción de configuración
Probar la conexión lee el primer lugar una vez (una solicitud de la cuota) e indica si la clave es aceptada, qué lugar ha encontrado Weerlive, cuántas solicitudes quedan hoy y el ritmo de las lecturas.
Ejemplos de escenas
- Aviso de tormenta: disparador Nuevo aviso KNMI, colores naranja y rojo, En vigor → enviar un mensaje «Aviso KNMI {{triggerEvent.data.level}}: {{triggerEvent.data.title}}».
- Recoger el toldo: disparador Estado de un dispositivo en Viento (Beaufort) de su casa, ≥ 6 → cerrar el toldo o las persianas.
- La víspera: disparador Nuevo aviso KNMI, Anunciado para más tarde → una notificación con
starts_at, para guardar los muebles de jardín.
Solución de problemas
- «Weerlive ha rechazado la clave de API»: compruebe la clave recibida por correo, sin espacios.
- «Límite diario de Weerlive alcanzado»: las lecturas se reanudan después de medianoche, hora neerlandesa. Menos lugares o un intervalo más largo ayudan; el botón Probar también gasta una solicitud.
- «Weerlive no responde»: avería del servicio o del acceso a Internet de Gladys. Las lecturas se reanudan solas.
- Ningún valor en un dispositivo: compruebe que el dispositivo se ha añadido en la pestaña Descubrimiento.
- Lugar extraño: Weerlive elige la estación más cercana; escriba otra ciudad o unas coordenadas.
- Más detalles: defina
LOG_LEVEL=debugen el contenedor y lea sus registros.
Límites
- Los datos cubren los Países Bajos: un lugar lejano recibe la estación neerlandesa más cercana, o nada.
- Los textos de aviso están en neerlandés, tal como los publica el KNMI.
- Cinco lugares como máximo por clave, y una lectura cada 10 minutos en el mejor de los casos.
- Weerlive indica que su clave gratuita es para uso personal y de ocio.
- Desarrollada sin cuenta de Weerlive, probada con respuestas reales publicadas.
Parámetros de configuración
Estos son los parámetros que KNMI te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | El tiempo procede del KNMI a través de la API de Weerlive.nl. Solicite una clave de API gratuita en weerlive.nl (basta con una dirección de correo): permite 300 solicitudes al día, así que cada lugar se lee como mucho cada 10 minutos, con menos frecuencia si hay varios lugares. Sin relación con el KNMI ni con Weerlive. |
| Clave de API de Weerlive | secret | Sí | La clave recibida por correo electrónico de weerlive.nl. |
| Casa de Gladys | select | No | Seguir el tiempo en la ubicación de esta casa (enviada a Weerlive redondeada a 1 km aprox.). |
| Otros lugares | string | No | Ciudades neerlandesas o «latitud,longitud», separadas por punto y coma. Cinco lugares como máximo, casa incluida. |
| Intervalo de actualización | select | No | Se ralentiza automáticamente con varios lugares, para no superar las 300 solicitudes diarias. |
| Idioma de los textos | select | No | Nombres de las funciones de los nuevos dispositivos, condiciones y fechas. Los textos de aviso del KNMI siguen en neerlandés. |
Cómo instalar KNMI en Gladys
- En Gladys, abre Integraciones: KNMI aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-knmi:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-knmi.
KNMI requiere Gladys >=5.2.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
KNMI 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.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación