Integración domótica AccuWeather, gratuita y de código abierto
Previsiones y alertas de AccuWeather, disparadores de escenas y widgets para Gladys.
Publicado por prohand
- Dispositivos
- Versión 0.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Esta integración convierte AccuWeather en el proveedor meteorológico de Gladys: el widget del tiempo de Gladys, el asistente de chat y las alertas meteorológicas lo usan en lugar del servicio OpenWeather integrado. También añade disparadores y acciones de escena de AccuWeather, y dos widgets para el panel (Gladys 5.1 o posterior).
Es una integración en la nube: necesita acceso a Internet y una clave de API de AccuWeather. No se ejecuta nada en su red local.
Antes de empezar
- Cree una cuenta gratuita en developer.accuweather.com.
- En My Apps, añada una aplicación (cualquier nombre) y copie su clave de API (API key).
- En Gladys, compruebe que su casa tiene una ubicación: Ajustes > Casas, y sitúe la casa en el mapa. Al instalarla, la integración pide leer la ubicación de sus casas: usa la primera casa que tenga una.
Configuración
Abra la pestaña Configuración de la integración:
| Campo | Para qué sirve |
|---|---|
| Clave de API | La clave de su aplicación de AccuWeather. Obligatoria. |
| Idioma de los textos de AccuWeather | Idioma de los nombres de alertas y de las descripciones del tiempo («Parcialmente soleado»…). Inglés, francés, alemán o español. |
| Intervalo de actualización (minutos) | Frecuencia de las peticiones a AccuWeather, de 30 a 1440 minutos. 120 por defecto. |
| Previsión por horas (12 horas) | Las próximas 12 horas. Necesaria para el disparador «Lluvia prevista» y para la curva del widget. |
| Alertas meteorológicas | Alertas oficiales difundidas por AccuWeather. No están en todos los planes: si su plan las rechaza, la integración deja de pedirlas. |
| Clave de ubicación AccuWeather | Opcional. Déjela vacía para usar la ubicación de su casa. Rellénela (por ejemplo 623 para París) para imponer otra ubicación de AccuWeather. |
Guarde y pulse Probar la conexión: se muestran la ubicación de AccuWeather encontrada, el tiempo actual y cuántas peticiones al día cuestan sus ajustes.
Su cuota diaria
AccuWeather cuenta cada petición. Las claves gratuitas más antiguas permiten 50 peticiones al día; la prueba y los planes de pago permiten más. Una actualización cuesta:
- 1 petición para las condiciones actuales;
- 1 para la previsión de 12 horas (si está activada);
- 1 para las alertas (si están activadas);
- 1 para la previsión de 5 días, como mucho cada 3 horas.
Con 120 minutos (el valor por defecto) son unas 44 peticiones al día.
Cada respuesta se guarda en caché, también tras un reinicio: abrir un panel,
las consultas del tiempo de Gladys (cada 30 minutos) y las escenas no cuestan
peticiones extra. Solo los botones Actualizar y la acción de escena
refresh_weather consultan AccuWeather al momento (como mucho una vez cada 5
minutos).
Cuando la cuota se agota, la integración sigue mostrando el último tiempo recibido (hasta 24 horas de antigüedad) y espera una hora antes de volver a preguntar.
Acciones de la pantalla de configuración
- Probar la conexión — comprueba la clave y la ubicación, y muestra el número de peticiones de las últimas 24 horas.
- Actualizar el tiempo ahora — consulta AccuWeather al momento.
Escenas
La integración añade sus propias tarjetas al editor de escenas, en la categoría Integraciones.
Disparadores
Cada disparador se activa una vez por cambio, nunca en cada actualización. La primera actualización tras la instalación solo registra la situación actual.
- AccuWeather: nueva alerta meteorológica (
weather_alert) — se ha emitido una alerta oficial para su casa. Filtre por gravedad (menor, moderada, grave, extrema) y por fenómeno (viento, lluvia, tormentas, nieve y hielo…). Variables:{{triggerEvent.data.event}}(nombre de la alerta),severity,type,description,starts_at,ends_at,location. - AccuWeather: el cielo ha cambiado (
condition_changed) — las condiciones actuales han cambiado, por ejemplo de despejado a lluvia. Filtre por la nueva condición. Variables:condition,previous_condition,description,temperature(°C),location. - AccuWeather: lluvia prevista (
rain_expected) — se prevé precipitación en las próximas 3 horas, cuando en la actualización anterior no la había. Requiere la previsión por horas. Filtre por lluvia, nieve, hielo o mixta. Variables:precipitation_type,starts_at,hours_until,probability,location. - AccuWeather: helada prevista (
frost_expected) — un día previsto baja a 0 °C o menos. Una vez por día. Variables:date,temperature_min(°C),location.
Gladys también tiene su propio disparador «alerta meteorológica»: funciona con esta integración y reacciona en segundos cuando AccuWeather publica o termina una alerta.
Acciones
- AccuWeather: leer la previsión (
get_forecast) — hoy, mañana o pasado mañana. Entregacondition,description,temperature_min,temperature_max,precipitation_probability,rain_expected,wind_speedyuv_indexa las acciones siguientes. Ejemplo: «sirain_expectedes verdadero, envíame un mensaje». - AccuWeather: leer el tiempo actual (
get_current_conditions) — entregacondition,description,temperature,apparent_temperature,humidity,wind_speed,uv_indexeis_day. - AccuWeather: actualizar ahora (
refresh_weather) — consulta AccuWeather al momento. Entregarefreshedycalls_last_24h.
Las dos acciones de lectura usan la caché: no cuestan ninguna petición. Elija unidades métricas (°C, m/s) o de EE. UU. (°F, mph) en cada acción.
Panel
Añada los widgets desde el editor del panel:
- AccuWeather ahora — temperatura, sensación térmica, humedad, viento, una curva de las próximas 12 horas, las alertas, la lluvia prevista y el número de peticiones usadas en 24 horas. Un botón Actualizar consulta AccuWeather al momento.
- AccuWeather 5 días — los próximos días con las palabras de AccuWeather, de día y de noche. Su ajuste Días mostrados va de 1 a 5.
Solución de problemas
- «AccuWeather rechaza la clave de API» — copie de nuevo la clave desde developer.accuweather.com (My Apps), sin espacios, y guarde.
- «La cuota diaria de AccuWeather está agotada» — aumente el intervalo de actualización o desactive la previsión por horas o las alertas. La cuota se renueva en 24 horas.
- «Indique la ubicación de su casa» — su casa en Gladys no tiene ubicación: indíquela en Ajustes > Casas.
- Ciudad equivocada — rellene la clave de ubicación de AccuWeather: busque su ciudad en accuweather.com, la clave es el número al final de su dirección.
- Los registros de la integración están en la interfaz de Gladys (página de
la integración) o con
docker logsen el host.
Parámetros de configuración
Estos son los parámetros que AccuWeather te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Cree una cuenta gratuita en developer.accuweather.com, añada una aplicación y pegue su clave de API abajo. El tiempo se consulta para la ubicación de su casa en Gladys: indíquela en Ajustes > Casas. Cada actualización cuesta hasta 4 peticiones a AccuWeather: mantenga un intervalo de 120 minutos o más con una clave gratuita (50 peticiones al día). |
| Clave de API | secret | Sí | La clave de su aplicación en developer.accuweather.com (My Apps). |
| Idioma de los textos de AccuWeather | select | No | Idioma de los nombres de alertas y de las descripciones del tiempo. |
| Intervalo de actualización (minutos) | number | No | Frecuencia de las peticiones a AccuWeather, de 30 a 1440 minutos. Con 120 minutos, un día cuesta unas 44 peticiones. |
| Previsión por horas (12 horas) | boolean | No | Necesaria para el disparador «Lluvia prevista» y la curva del widget. Una petición por actualización. |
| Alertas meteorológicas | boolean | No | Alertas oficiales difundidas por AccuWeather (no en todos los planes). Una petición por actualización. |
| Clave de ubicación AccuWeather (opcional) | string | No | Déjela vacía para usar la ubicación de su casa. Rellénela (p. ej. 623 para París) para imponer otra ubicación de AccuWeather. |
Cómo instalar AccuWeather en Gladys
- En Gladys, abre Integraciones: AccuWeather 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/prohand/gladys-accuweather:0.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/prohand/gladys-accuweather.
AccuWeather requiere Gladys >=5.1.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
AccuWeather 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 prohand, 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