Integración domótica Infoclimat, gratuita y de código abierto
Estaciones meteorológicas Infoclimat (StatIC): temperatura, viento, lluvia cerca.
Publicado por William-De71
- Dispositivos
- Versión 0.1.0
- Requiere Gladys >=5.2.0
- ★ 0
Presentación
Esta integración trae a Gladys las estaciones meteorológicas de Infoclimat. Infoclimat es una asociación francesa sin ánimo de lucro: sus miembros comparten las lecturas de sus propias estaciones (la red StatIC, unas 900 estaciones que emiten cada día, sobre todo en Francia, algunas en Bélgica, Suiza, España e Italia), junto a estaciones oficiales. Usted sigue hasta tres estaciones: la estación StatIC más cercana a una casa de Gladys, o una estación elegida por su identificador.
Cada estación se convierte en un dispositivo con las medidas que realmente proporciona: temperatura, humedad, presión a nivel del mar, punto de rocío, viento medio, ráfagas, dirección del viento, lluvia de la última hora, lluvia del día y, en algunas estaciones, espesor de nieve y visibilidad. Las escenas pueden reaccionar cuando empieza o deja de llover en una estación, cuando una estación deja de emitir o cuando Infoclimat rechaza su clave. Tres widgets del panel muestran la última lectura, las últimas 24 horas de una medida y las estaciones lado a lado.
Transporte: nube. Cada 10 minutos, la integración pide a Infoclimat las lecturas de sus estaciones, en una sola petición, con su clave. La ubicación de su casa nunca sale de Gladys: la estación más cercana se busca en la lista pública de estaciones, dentro de la integración.
Aún no probada con una clave real de Infoclimat: las peticiones siguen la API open data de Infoclimat y sus respuestas reales sin clave; por favor, informe de lo que observe.
Requisitos
- Gladys Assistant 5.2.0 o posterior (selector de casa, widgets y escenas de integraciones).
- Una clave open data de Infoclimat gratuita: solicítela en la página open data de Infoclimat.
- Para seguir la estación más cercana a una casa: la ubicación de la casa definida en Gladys (Ajustes → Casas).
Los datos son gratuitos para un uso personal, no comercial. Muchas estaciones StatIC se publican con la licencia CC BY-NC (no comercial): los widgets citan a Infoclimat y la licencia de cada estación; conserve esa mención si los comparte.
Configuración
| Campo | Por defecto | Significado |
|---|---|---|
| Clave open data | — | Obligatoria, secreta, nunca se vuelve a mostrar ni se escribe en los registros |
| Estación 1, 2, 3: Casa | — | La estación StatIC más cercana a esta casa que haya emitido en las últimas 24 horas |
| Estación 1, 2, 3: O un identificador de estación | — | 000P2, STATIC0095 o una estación oficial; prevalece sobre la casa |
| Intervalo de lectura | 10 min | 10, 15, 30 o 60 minutos; todas las estaciones en una petición |
| Idioma de los textos | automático | Nombres de los dispositivos y textos de las escenas; automático sigue el último widget, o la zona horaria |
El identificador de una estación está al final de la dirección de su página en infoclimat.fr: https://www.infoclimat.fr/observations-meteo/temps-reel/besancon/000P2.html → 000P2. Use el mapa de las estaciones para encontrar una. Las estaciones oficiales (estaciones sinópticas de Météo-France) no están en la lista pública, pero pueden escribirse por su identificador.
La estación más cercana a una casa se conserva mientras emita. Si permanece sin datos 24 horas, se elige la siguiente más cercana y se ofrece un nuevo dispositivo.
Botones de configuración: Leer ahora localiza las estaciones y las lee de inmediato (nunca dos veces en 2 minutos); Diagnóstico escribe el estado de la integración en sus registros, sin la clave.
Uso
Dispositivos
Tras la primera lectura, abra Descubrir y añada las estaciones que desee. Cada dispositivo solo tiene las funciones de las medidas que proporciona su estación:
| Función | Categoría / tipo | Unidad |
|---|---|---|
| Temperatura | temperature-sensor / decimal | °C |
| Humedad | humidity-sensor / decimal | % |
| Presión (nivel del mar) | pressure-sensor / decimal | hPa |
| Punto de rocío | temperature-sensor / probe | °C |
| Viento medio, ráfaga | speed-sensor / decimal | km/h |
| Dirección del viento | angle-sensor / integer | ° |
| Lluvia de la última hora | precipitation-sensor / decimal | mm/h |
| Lluvia del día (desde las 0 h UTC) | precipitation-sensor / decimal | mm/día |
| Espesor de nieve, visibilidad | distance-sensor / decimal | cm, m |
Una función que ya apareció se mantiene: una lectura vacía nunca la elimina. Cuando una estación proporciona una nueva medida, Actualizar en la pestaña Descubrir la añade. El punto de rocío es una temperatura de tipo probe: nunca cuenta en la temperatura de una habitación. La lluvia del día es la de Infoclimat cuando la estación la proporciona; si no, la suma de las horas completas desde las 0 h UTC. La radiación solar (W/m²) no tiene unidad en Gladys: se muestra en los widgets y se pasa a las escenas.
Widgets del panel
- Estación Infoclimat: la última lectura de una estación, hasta seis mosaicos (temperatura, humedad, viento y su dirección, ráfagas, presión, lluvia del día), las demás medidas en el texto y la mención de Infoclimat.
- Infoclimat, últimas 24 h: una medida en las últimas 24 horas (temperatura con el punto de rocío, humedad, presión, viento con las ráfagas, o lluvia), con sus valores mínimo y máximo marcados.
- Estaciones Infoclimat: las estaciones seguidas lado a lado; una estación sin datos aparece señalada.
No hay botón de actualizar: Infoclimat funciona gracias a voluntarios, y la integración nunca pregunta más a menudo que su temporizador.
Escenas
Desencadenadores (un evento por cambio, nunca en la primera lectura de una estación):
- Empieza a llover: la lluvia de la última hora de una estación supera 0.
- Deja de llover: vuelve a 0, es decir, hasta una hora después de la última gota.
- Estación sin datos: una estación no ha dado ninguna lectura desde hace 90 minutos. Estación de vuelta: vuelve a emitir.
- Clave rechazada: Infoclimat rechaza la clave, una vez hasta que vuelva a funcionar.
Cada desencadenador de estación puede filtrarse por estación y proporciona la estación, su nombre, la temperatura, la lluvia de la hora y del día, la hora de la lectura y su antigüedad en minutos. Los desencadenadores de lluvia necesitan una estación que mida la lluvia.
Acción Leer una estación: la última lectura (temperatura, humedad, presión, punto de rocío, viento, ráfagas, dirección, lluvia, radiación, hora, antigüedad) y una frase lista para un mensaje. Nunca envía una petición: responde con la última lectura.
Ejemplos:
- Cuando empieza a llover en «Infoclimat Chenecey-Buillon» → cerrar la ventana del tejado y enviar «Llueve en la estación: {{triggerEvent.data.rain_1h}} mm en la última hora».
- Cada mañana a las 7:00 → leer una estación → enviar el resumen por mensaje.
- Cuando se rechaza la clave → avisar al administrador (la clave puede estar ligada a una dirección IP que ha cambiado).
Los valores en sí (temperatura, ráfagas…) son funciones del dispositivo: «ráfagas por encima de 60 km/h» o «temperatura bajo 0 °C» son desencadenadores de dispositivo de Gladys.
Solución de problemas
- «Infoclimat rechaza la clave»: compruebe la clave en la página open data de Infoclimat. Una clave puede estar ligada a la dirección IP pública desde la que se usó: con una dirección IP dinámica, puede dejar de funcionar tras un cambio de dirección. Pida una nueva clave a Infoclimat, péguela y la integración lo reintenta de inmediato; si no, lo reintenta cada 6 horas.
- Ningún dispositivo en la pestaña Descubrir: una estación se ofrece tras su primera lectura, en 10 minutos; pulse Leer ahora. Compruebe el identificador, o que la casa tenga ubicación.
- «ninguna lectura en las últimas 24 horas»: la estación no emite o el identificador es incorrecto; elija otra.
- Falta un valor: la estación no lo mide, o no lo ha enviado últimamente; la función conserva su último valor.
- No se puede contactar con Infoclimat: la integración espera más tras cada fallo (hasta una hora), y una hora tras un «demasiadas peticiones».
- Las previsiones de Infoclimat no forman parte de esta versión (otra clave, otra API).
- Para informar de un problema, abra una incidencia en GitHub con las versiones de Gladys y de la integración, y el resultado de Diagnóstico (en los registros de la integración). Nunca pegue su clave.
Parámetros de configuración
Estos son los parámetros que Infoclimat te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Clave open data de Infoclimat | section | No | Infoclimat es una asociación francesa sin ánimo de lucro que comparte las lecturas de las estaciones meteorológicas de sus miembros (la red StatIC) y de estaciones oficiales. Su API open data necesita una clave personal gratuita: solicítela en su página open data y péguela abajo. La clave puede estar ligada a la dirección IP pública desde la que se usa. |
| Clave open data | secret | Sí | |
| Estación 1 | section | No | Hasta tres estaciones, cada una la más cercana a una casa de Gladys o una estación elegida por su identificador. El identificador aparece en la dirección de la página de una estación en infoclimat.fr (…/besancon/000P2.html). |
| Casa | select | No | La estación StatIC más cercana a su ubicación en Gladys que haya emitido en las últimas 24 horas. |
| O un identificador de estación | string | No | O el identificador de una estación (000P2, STATIC0095, una estación oficial…). Prevalece sobre la casa. |
| Estación 2 | section | No | Opcional. |
| Casa | select | No | La estación StatIC más cercana a su ubicación en Gladys que haya emitido en las últimas 24 horas. |
| O un identificador de estación | string | No | O el identificador de una estación (000P2, STATIC0095, una estación oficial…). Prevalece sobre la casa. |
| Estación 3 | section | No | Opcional. |
| Casa | select | No | La estación StatIC más cercana a su ubicación en Gladys que haya emitido en las últimas 24 horas. |
| O un identificador de estación | string | No | O el identificador de una estación (000P2, STATIC0095, una estación oficial…). Prevalece sobre la casa. |
| Opciones | section | No | Infoclimat funciona gracias a voluntarios: todas las estaciones se leen en una sola petición, como mucho cada 10 minutos. |
| Intervalo de lectura | select | No | Minutos entre dos lecturas de Infoclimat. |
| Idioma de los textos | select | No | Nombres de los dispositivos y textos pasados a las escenas. Automático: el idioma del último widget mostrado. |
Cómo instalar Infoclimat en Gladys
- En Gladys, abre Integraciones: Infoclimat 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/william-de71/gladys-infoclimat:0.1.0), 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/William-De71/gladys-infoclimat.
Infoclimat 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
Infoclimat 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 William-De71, 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