Intégration domotique National Weather Service, gratuite et open source
Prévisions et alertes officielles du National Weather Service (États-Unis).
Publiée par William-De71
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.1.1
- ★ 0
Cette intégration fournit à Gladys les prévisions météo et les alertes officielles du National Weather Service (NWS), le service météorologique des États-Unis. Elle alimente le widget météo du tableau de bord, l'assistant, les scènes déclenchées par une alerte, et ajoute trois widgets.
Intégration communautaire, sans lien avec le National Weather Service ni la NOAA.
Prêt à l'emploi
Aucune configuration n'est nécessaire : l'API du NWS est gratuite et sans clé. Installez l'intégration, elle fonctionne immédiatement.
Le NWS ne couvre que les États-Unis et leurs territoires (Alaska, Hawaï, Porto Rico, Guam…). Pour une maison située ailleurs, Gladys utilise automatiquement un autre fournisseur météo.
Renseignez la position de chaque maison dans ses réglages : la surveillance des alertes, les actions de scène et les widgets en ont besoin.
Ce que l'intégration fournit
- Conditions actuelles mesurées par la station météo la plus proche (température, ressenti, humidité, point de rosée, pression, vent, rafales, visibilité). Si aucune station n'a transmis récemment, la prévision de l'heure en cours prend le relais.
- Prévisions heure par heure sur 24 heures : température, ressenti, humidité, nébulosité, vent et rafales, cumul et probabilité de pluie.
- Prévisions journalières sur 6 à 7 jours : maximum de la journée, minimum de la nuit suivante, ciel, risque de pluie, cumul, vent et rafales.
- Lever et coucher du soleil, calculés localement.
- Alertes officielles (veilles, alertes, avis) avec leur texte complet et les consignes.
Le NWS ne publie pas d'indice UV.
Le NWS rédige ses textes en anglais uniquement : noms des alertes, textes des prévisionnistes et bulletins restent en anglais ; tout le reste suit la langue de Gladys.
Les niveaux d'alerte américains
| Niveau | Signification |
|---|---|
| Warning | le phénomène est en cours ou imminent : agir maintenant |
| Watch | les conditions sont réunies pour qu'il se produise : se préparer |
| Advisory | phénomène moins grave, mais gênant |
| Statement | bulletin d'information ou de suivi |
Scènes déclenchées par une alerte
Gladys propose déjà les déclencheurs génériques « Alerte météo émise » et « Alerte météo terminée ». Gladys vérifie les alertes toutes les 30 minutes ; cette intégration les surveille en plus chaque minute et prévient Gladys dès qu'une alerte change : votre scène se déclenche en quelques secondes.
L'intégration ajoute ses propres déclencheurs, plus précis, dans la rubrique National Weather Service de l'éditeur de scène :
| Déclencheur | Se déclenche quand… | Filtres |
|---|---|---|
| Alerte NWS émise | une nouvelle veille, alerte ou un nouvel avis couvre la maison | maison, type d'alerte, niveau, sévérité |
| Fin d'une alerte NWS | une alerte a expiré ou a été annulée | maison, type d'alerte, niveau |
Types d'alerte : tornade, ouragan / tempête tropicale, orage violent, inondation, tempête hivernale, froid, chaleur, vent, risque d'incendie, brouillard, qualité de l'air, mer / littoral, autre.
Par exemple, pour être prévenu d'une tornade : déclencheur Alerte NWS émise, type Tornade, niveau Warning, puis une action d'envoi de message contenant la variable Résumé et la variable Consignes.
Bon à savoir :
- Le champ Maison doit contenir le nom de la maison exactement comme dans Gladys, majuscules comprises. Vide = toutes les maisons.
- Le NWS ne modifie jamais une alerte : il en publie une nouvelle qui remplace l'ancienne. L'intégration suit ces mises à jour : une alerte prolongée ou complétée ne redéclenche pas votre scène.
- Une alerte qui change de niveau (par exemple Hurricane Watch remplacée par Hurricane Warning) compte comme une nouvelle alerte : Fin d'une alerte NWS pour l'ancienne, Alerte NWS émise pour la nouvelle.
- Les alertes déjà en cours au démarrage de l'intégration ne déclenchent rien : seules les nouvelles comptent.
- Une alerte est considérée terminée dès que son heure de fin est passée, ou quand elle a disparu deux vérifications de suite et depuis au moins 5 minutes. Si elle réapparaît ensuite, elle redéclenche Alerte NWS émise : chaque fin est suivie d'un nouveau départ, jamais de deux fins d'affilée.
Scènes : actions NWS
| Action | Ce qu'elle renvoie |
|---|---|
| Obtenir les alertes NWS | nombre d'alertes, de warnings, de watches et d'advisories, liste des événements, la plus grave (type, niveau, consignes, fin), un résumé |
| Obtenir la prévision NWS d'un jour | d'aujourd'hui à dans 6 jours : maximum, minimum, ciel, risque de pluie, vent, texte du prévisionniste (jour et nuit), un résumé |
| Obtenir les conditions actuelles NWS | température, ressenti, humidité, point de rosée, pression, vent, rafales, visibilité, ciel, station, un résumé |
Chaque action propose une sortie Résumé, une phrase prête à envoyer dans un message.
Widgets du tableau de bord
| Widget | Contenu |
|---|---|
| Alertes NWS | compteurs warnings / watches / avis, puis chaque alerte ; un appui affiche son texte complet et les consignes. Mis à jour dès qu'une alerte change. |
| Prévision NWS détaillée | le texte du prévisionniste période par période (cette nuit, samedi, nuit de samedi…), avec les icônes du NWS |
| NWS heure par heure | 12, 24 ou 48 heures en courbe : température et ressenti, risque de pluie, ou vent et rafales |
Chaque widget a un réglage Maison (vide = première maison localisée), à écrire exactement comme dans Gladys.
Configuration (facultative)
| Réglage | Par défaut | Rôle |
|---|---|---|
| Email de contact | — | le NWS demande à chaque application de s'identifier ; votre email lui permet de vous prévenir avant de bloquer un trafic jugé abusif |
| Durée du cache (s) | 600 | durée de réutilisation d'une prévision (le NWS les met à jour environ une fois par heure) |
| Intervalle de vérification des alertes (s) | 60 | fréquence de vérification des alertes de vos maisons, de 30 à 900 secondes |
Paramètres de configuration
Voici les paramètres demandés par National Weather Service dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Prêt à l'emploi | section | Non | Les prévisions et les alertes fonctionnent sans configuration : l'API du National Weather Service est gratuite et sans clé. Elle ne couvre que les États-Unis et leurs territoires — une maison située ailleurs reçoit sa météo d'un autre fournisseur. |
| Email de contact (optionnel) | string | Non | Ajouté à l'identification que le NWS exige de chaque application, pour qu'il puisse vous prévenir avant de bloquer un trafic qu'il jugerait abusif. Jamais transmis à personne d'autre. |
| Durée du cache (s) | number | Non | En secondes, entre 0 et 3600. Durée pendant laquelle une prévision est réutilisée avant de rappeler le NWS. Le NWS met à jour ses prévisions environ une fois par heure : la valeur par défaut de 600 (10 min) ne fait rien perdre en fraîcheur. Mettre 0 pour toujours appeler l'API. Les alertes ne sont pas concernées : elles sont vérifiées selon leur propre rythme. |
| Intervalle de vérification des alertes (s) | number | Non | En secondes, entre 30 et 900. Fréquence de vérification des alertes officielles de vos maisons, pour les déclencheurs de scène et le widget des alertes. Une alerte tornade dure environ 30 minutes : la valeur par défaut de 60 s déclenche vos scènes moins d'une minute après son émission. |
Comment installer National Weather Service dans Gladys
- Dans Gladys, ouvrez Intégrations : National Weather Service apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/william-de71/gladys-national-weather-service:1.0.0), 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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/William-De71/gladys-national-weather-service.
National Weather Service nécessite Gladys >=5.1.1. 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
National Weather Service 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 William-De71, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation