Intégration domotique AccuWeather, gratuite et open source

Prévisions et alertes AccuWeather, déclencheurs de scènes et widgets pour Gladys.

• Publiée par prohand
• Appareils
• Version 0.0.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Cette intégration fait d'AccuWeather le fournisseur météo de Gladys : le widget météo de Gladys, l'assistant de chat et les alertes météo l'utilisent à la place du service OpenWeather intégré. Elle ajoute aussi des déclencheurs et des actions de scène AccuWeather, et deux widgets de tableau de bord (Gladys 5.1 ou plus récent).

C'est une intégration cloud : elle a besoin d'un accès Internet et d'une clé d'API AccuWeather. Rien ne tourne sur votre réseau local.

Avant de commencer

1. Créez un compte gratuit sur developer.accuweather.com.
2. Dans My Apps, ajoutez une application (nom libre) et copiez sa clé d'API (API key).
3. Dans Gladys, vérifiez que votre maison a une position : Paramètres > Maisons, puis placez la maison sur la carte. À l'installation, l'intégration demande à lire la position de vos maisons : elle utilise la première maison qui en a une.

Configuration

Ouvrez l'onglet Configuration de l'intégration :

Champ	Rôle
Clé d'API	La clé de votre application AccuWeather. Obligatoire.
Langue des textes AccuWeather	Langue des noms d'alertes et des descriptions du temps (« Éclaircies »…). Anglais, français, allemand ou espagnol.
Intervalle de rafraîchissement (minutes)	Fréquence des requêtes à AccuWeather, de 30 à 1440 minutes. 120 par défaut.
Prévisions horaires (12 heures)	Les 12 prochaines heures. Nécessaire au déclencheur « Pluie attendue » et à la courbe du widget.
Alertes météo	Alertes officielles relayées par AccuWeather. Pas incluses dans toutes les offres : si votre offre les refuse, l'intégration arrête de les demander.
Clé de lieu AccuWeather	Facultatif. Laissez vide pour utiliser la position de votre maison. Renseignez-la (par exemple 623 pour Paris) pour imposer un autre lieu AccuWeather.

Enregistrez, puis cliquez sur Tester la connexion : le lieu AccuWeather trouvé, la météo actuelle et le nombre de requêtes par jour de vos réglages s'affichent.

Votre quota quotidien

AccuWeather compte chaque requête. Les clés gratuites les plus anciennes permettent 50 requêtes par jour ; l'essai et les offres payantes en permettent plus. Un rafraîchissement coûte :

• 1 requête pour les conditions actuelles ;
• 1 pour les prévisions sur 12 heures (si activées) ;
• 1 pour les alertes (si activées) ;
• 1 pour les prévisions sur 5 jours, au plus toutes les 3 heures.

À 120 minutes (le réglage par défaut), cela fait environ 44 requêtes par jour. Chaque réponse est gardée en cache, même après un redémarrage : ouvrir un tableau de bord, les contrôles météo de Gladys (toutes les 30 minutes) et les scènes ne coûtent pas de requête en plus. Seuls les boutons Actualiser et l'action de scène refresh_weather interrogent AccuWeather tout de suite (au plus une fois toutes les 5 minutes).

Quand le quota est épuisé, l'intégration continue d'afficher la dernière météo reçue (jusqu'à 24 heures) et attend une heure avant de redemander.

Actions de l'écran Configuration

• Tester la connexion — vérifie la clé et le lieu, et affiche le nombre de requêtes des dernières 24 heures.
• Actualiser la météo maintenant — interroge AccuWeather tout de suite.

Scènes

L'intégration ajoute ses propres cartes à l'éditeur de scènes, dans la catégorie Intégrations.

Déclencheurs

Chaque déclencheur se lance une fois par changement, jamais à chaque rafraîchissement. Le premier rafraîchissement après l'installation enregistre seulement la situation actuelle.

• AccuWeather : nouvelle alerte météo (weather_alert) — une alerte officielle a été émise pour votre maison. Filtrez sur la gravité (mineure, modérée, sévère, extrême) et sur le phénomène (vent, pluie, orages, neige et verglas…). Variables : {{triggerEvent.data.event}} (nom de l'alerte), severity, type, description, starts_at, ends_at, location.
• AccuWeather : le ciel a changé (condition_changed) — les conditions actuelles ont changé, par exemple de dégagé à pluie. Filtrez sur la nouvelle condition. Variables : condition, previous_condition, description, temperature (°C), location.
• AccuWeather : pluie attendue (rain_expected) — des précipitations sont prévues dans les 3 prochaines heures, alors qu'il n'y en avait pas au rafraîchissement précédent. Demande les prévisions horaires. Filtrez sur pluie, neige, glace ou mixte. Variables : precipitation_type, starts_at, hours_until, probability, location.
• AccuWeather : gel attendu (frost_expected) — un jour prévu descend à 0 °C ou moins. Une fois par jour. Variables : date, temperature_min (°C), location.

Gladys a aussi son propre déclencheur « alerte météo » : il fonctionne avec cette intégration, et réagit en quelques secondes quand AccuWeather publie ou termine une alerte.

Actions

• AccuWeather : lire les prévisions (get_forecast) — aujourd'hui, demain ou après-demain. Donne condition, description, temperature_min, temperature_max, precipitation_probability, rain_expected, wind_speed et uv_index aux actions suivantes. Exemple : « si rain_expected est vrai, envoie-moi un message ».
• AccuWeather : lire la météo actuelle (get_current_conditions) — donne condition, description, temperature, apparent_temperature, humidity, wind_speed, uv_index et is_day.
• AccuWeather : actualiser maintenant (refresh_weather) — interroge AccuWeather tout de suite. Donne refreshed et calls_last_24h.

Les deux actions de lecture utilisent le cache : elles ne coûtent aucune requête. Choisissez les unités métriques (°C, m/s) ou US (°F, mph) dans chaque action.

Tableau de bord

Ajoutez les widgets depuis l'éditeur de tableau de bord :

• AccuWeather en direct — température, ressenti, humidité, vent, une courbe des 12 prochaines heures, les alertes, la pluie à venir et le nombre de requêtes utilisées sur 24 heures. Un bouton Actualiser interroge AccuWeather tout de suite.
• AccuWeather 5 jours — les prochains jours avec les mots d'AccuWeather, de jour et de nuit. Son réglage Jours affichés va de 1 à 5.

Dépannage

• « AccuWeather refuse la clé d'API » — recopiez la clé depuis developer.accuweather.com (My Apps), sans espace, et enregistrez.
• « Le quota quotidien AccuWeather est épuisé » — augmentez l'intervalle de rafraîchissement, ou désactivez les prévisions horaires ou les alertes. Le quota revient sous 24 heures.
• « Renseignez la position de votre maison » — votre maison Gladys n'a pas de position : renseignez-la dans Paramètres > Maisons.
• Mauvaise ville — renseignez la clé de lieu AccuWeather : cherchez votre ville sur accuweather.com, la clé est le nombre à la fin de son adresse.
• Les logs de l'intégration sont dans l'interface Gladys (page de l'intégration) ou avec docker logs sur l'hôte.

Paramètres de configuration

Voici les paramètres demandés par AccuWeather dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Pour commencer	section	Non	Créez un compte gratuit sur developer.accuweather.com, ajoutez une application et collez sa clé d'API ci-dessous. La météo est demandée pour la position de votre maison Gladys : renseignez-la dans Paramètres > Maisons. Chaque rafraîchissement coûte jusqu'à 4 requêtes AccuWeather : gardez un intervalle de 120 minutes ou plus avec une clé gratuite (50 requêtes par jour).
Clé d'API	secret	Oui	La clé de votre application sur developer.accuweather.com (My Apps).
Langue des textes AccuWeather	select	Non	Langue des noms d'alertes et des descriptions du temps.
Intervalle de rafraîchissement (minutes)	number	Non	Fréquence des requêtes à AccuWeather, de 30 à 1440 minutes. À 120 minutes, une journée coûte environ 44 requêtes.
Prévisions horaires (12 heures)	boolean	Non	Nécessaire au déclencheur « Pluie attendue » et à la courbe du widget. Une requête par rafraîchissement.
Alertes météo	boolean	Non	Alertes officielles relayées par AccuWeather (pas dans toutes les offres). Une requête par rafraîchissement.
Clé de lieu AccuWeather (facultatif)	string	Non	Laissez vide pour utiliser la position de votre maison. Renseignez-la (ex. 623 pour Paris) pour imposer un autre lieu AccuWeather.

Comment installer AccuWeather dans Gladys

1. Dans Gladys, ouvrez Intégrations : AccuWeather apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/prohand/gladys-accuweather:0.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-accuweather.

AccuWeather nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

AccuWeather est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂