Intégration domotique FEMA Disasters, gratuite et open source

Déclarations de catastrophe FEMA et aides ouvertes pour votre comté américain.
Suivez depuis Gladys les déclarations de catastrophe de la FEMA, l'agence fédérale américaine de gestion des urgences, pour votre comté : ouragans, inondations, incendies, tempêtes hivernales, tornades… Quand une catastrophe frappe, le Président (catastrophe majeure, urgence) ou la FEMA (aide à la lutte contre l'incendie) la déclare pour une liste de comtés et y ouvre des programmes d'aide : l'aide aux particuliers (Individual Assistance, à demander sur DisasterAssistance.gov), l'aide publique (Public Assistance, pour les collectivités) et la réduction des risques (Hazard Mitigation).
L'intégration lit ces décisions sur OpenFEMA, les données ouvertes de la FEMA, pour le comté de votre maison ou les comtés que vous choisissez. Sans compte ni clé d'API.
Les déclarations sont des décisions administratives, souvent prises des jours après l'événement : ce n'est pas un système d'alerte de sécurité. En cas d'urgence, suivez les consignes des autorités locales et du National Weather Service. Non affiliée à la FEMA. Ce produit utilise l'API OpenFEMA de la FEMA, sans être approuvé par la FEMA.
Ce que vous obtenez
- Un appareil par comté : catastrophe déclarée (oui / non), type d'incident et date de la dernière déclaration, aide aux particuliers, aide publique et réduction des risques ouvertes (oui / non), et le nombre de déclarations sur 12 mois.
- Un widget de tableau de bord : une ligne par comté, ses déclarations en cours, ses programmes, la date limite de demande et des liens vers la page FEMA de chaque catastrophe et vers DisasterAssistance.gov.
- Deux déclencheurs de scène : une nouvelle déclaration pour votre comté, et l'aide aux particuliers ouverte (avec la date limite de demande).
- Une action de scène qui lit les déclarations en cours en une phrase, à envoyer par message ou à faire lire à voix haute.
Prérequis
- Gladys Assistant 5.3 ou plus récent.
- Un accès Internet depuis la machine de Gladys (l'intégration lit
www.fema.gov, etgeo.fcc.govpour trouver le comté de votre maison). - Une maison aux États-Unis (les 50 États, le district de Columbia, Porto Rico et les territoires) : sa position dans Gladys (Paramètres → Maisons), ou des codes FIPS de comté saisis dans la configuration.
Configuration
Réglages
| Réglage | Rôle |
|---|---|
| Codes FIPS des comtés | Jusqu'à 8 codes de comté à 5 chiffres, séparés par des virgules. Vide : le comté de votre maison. |
| Intervalle de mise à jour | 30 minutes, 1 heure (par défaut), 3 ou 6 heures. |
| Langue des noms et des messages | Noms des fonctionnalités (à leur création) et textes envoyés aux scènes. Français par défaut. |
Enregistrez, puis ouvrez l'onglet Découverte de l'intégration et créez l'appareil de chaque comté. Le bouton Afficher les déclarations en cours de la configuration répond tout de suite : un moyen rapide de vérifier les réglages.
Trouver votre comté
Laissez le champ vide : l'intégration envoie une fois la position de votre maison, arrondie à trois décimales (environ 100 m), à la FCC Area API, qui renvoie son comté. Elle ne la redemande que si la position de la maison change.
Pour suivre d'autres comtés (de la famille, une résidence secondaire), saisissez leurs codes FIPS :
2 chiffres pour l'État, puis 3 pour le comté. Exemples : 12086 comté de Miami-Dade, Floride ; 06037
comté de Los Angeles, Californie ; 22071 paroisse d'Orléans, Louisiane. Le Census Bureau publie la
liste des codes. Un code qu'elle ne
connaît pas est ignoré et signalé dans le statut de la configuration.
Déclaration en cours
Une déclaration concerne votre comté quand la FEMA le désigne, ou l'État entier (« Statewide »). Les déclarations tribales, faites pour des terres tribales, ne sont pas comptées. Une déclaration est en cours quand elle n'est pas clôturée et :
- qu'elle date de moins de 30 jours ;
- ou que sa période d'incident est encore ouverte (un incident sans date de fin compte un an au plus, 30 jours pour une aide à la lutte contre l'incendie, qui n'en reçoit jamais) ;
- ou que les demandes d'aide aux particuliers sont encore ouvertes (jusqu'à la date limite de dépôt).
« Aide aux particuliers » est à 1 tant que les demandes d'une déclaration en cours sont ouvertes (60 jours après la déclaration tant que la FEMA ne donne pas de date limite). « Aide publique » et « Réduction des risques » sont à 1 quand une déclaration en cours les comprend.
Appareil
| Fonctionnalité | Type | Valeurs |
|---|---|---|
| Catastrophe déclarée | Binaire | 1 quand une déclaration est en cours |
| Type d'incident | Texte | Dernière déclaration, ex. « Ouragan · Hurricane Isaias » |
| Date de déclaration | Texte | Sa date et son numéro, ex. « 27/10/2026 (DR-4955) » |
| Aide aux particuliers | Binaire | 1 tant que les demandes sont ouvertes |
| Aide publique | Binaire | 1 quand une déclaration en cours la comprend |
| Réduction des risques | Binaire | 1 quand une déclaration en cours la comprend |
| Déclarations sur 12 mois | Compteur | Déclarations faites sur les 365 derniers jours |
L'appareil s'appelle « FEMA · comté, État » : renommez-le à votre guise dans Gladys. Les valeurs ne sont envoyées que lorsqu'elles changent, et de nouveau toutes les 12 heures.
Widget de tableau de bord
Ajoutez le widget Déclarations FEMA à un tableau de bord. Il affiche le nombre de déclarations en cours, puis une ligne par comté avec une pastille rouge « Déclarée » ou verte « Aucune ». Touchez une ligne pour le détail : numéro, type et date de chaque déclaration, période d'incident, programmes, date limite de demande et liens. Le pied donne l'heure de la dernière lecture et un lien vers la page des déclarations de la FEMA (masquable dans les réglages du widget).
Déclencheurs de scène
FEMA : nouvelle déclaration pour mon comté. Une déclaration faite dans les 90 derniers jours apparaît
pour un comté suivi. Filtres : le comté (son appareil) et les types de déclaration (catastrophe majeure,
urgence, lutte contre l'incendie). Variables : county_name, declaration_id (DR-4955-FL),
declaration_type_name, incident_type (tel que la FEMA l'écrit, en anglais), incident_type_name,
title, declaration_date, individual_assistance (vrai quand les demandes sont ouvertes), summary
(une phrase) et url.
FEMA : aide aux particuliers ouverte. Les habitants d'un comté suivi peuvent demander l'aide de la
FEMA : avec une nouvelle déclaration, ou plus tard, quand la FEMA modifie une déclaration pour ajouter le
comté au programme. Filtre : le comté. Variables : county_name, declaration_id, incident_type_name,
title, deadline (dernier jour pour faire la demande, quand la FEMA le donne), summary, url et
registration_url.
Les déclarations déjà listées quand un comté commence à être suivi ne déclenchent rien : ce ne sont pas des nouvelles. Un redémarrage de l'intégration non plus.
Action de scène
FEMA : lire les déclarations relit OpenFEMA si la dernière lecture date de plus d'un intervalle de mise à jour, et renvoie :
text: les déclarations en cours de chaque comté, en une phrase ;active_count: le nombre de déclarations en cours ;assistance_open: vrai quand les demandes d'aide aux particuliers sont ouvertes dans un comté suivi.
Exemples de scènes
- Prévenir la famille : sur « aide aux particuliers ouverte », envoyer
{{triggerEvent.data.summary}}et le lien{{triggerEvent.data.registration_url}}par message. - Rappel hebdomadaire : chaque lundi, lancer « lire les déclarations », puis envoyer son texte si
assistance_openest vrai. - Nouvelle déclaration : sur une catastrophe majeure déclarée pour votre comté, envoyer
{{triggerEvent.data.summary}}et{{triggerEvent.data.url}}.
Sources des données, conditions et quotas
- Déclarations : jeu de données OpenFEMA « Disaster Declarations Summaries » (v2), données publiques du gouvernement américain, lues sans compte. Ce produit utilise l'API OpenFEMA de la FEMA, sans être approuvé par la FEMA. Le gouvernement fédéral et la FEMA ne garantissent ni les données ni les analyses qui en sont tirées une fois les données récupérées sur leurs sites. Voir les conditions d'OpenFEMA.
- Comté de la maison : FCC Area API, publique, sans compte.
- Noms et codes des comtés : US Census Bureau, codes FIPS de 2020 (le millésime qu'utilise la FEMA), fournis avec l'intégration.
- Quotas : OpenFEMA n'en publie aucun pour cet usage. L'intégration envoie une requête par comté et par intervalle de mise à jour (toutes les heures par défaut), et une requête à la FCC quand la maison change de position.
Dépannage
- « Aucun comté » : indiquez la position de votre maison dans Gladys (Paramètres → Maisons), ou saisissez des codes FIPS de comté.
- « Aucun comté américain à la position de votre maison » : la maison est hors des États-Unis (ou sa position tombe en mer) : saisissez les codes FIPS des comtés à suivre.
- La maison a changé de comté : un nouvel appareil est proposé dans l'onglet Découverte ; supprimez l'appareil de l'ancien comté, qui ne reçoit plus de valeurs.
- « Ignoré (pas un code FIPS de comté) » : vérifiez le code dans la liste du Census (5 chiffres, zéro
initial facultatif :
6037et06037désignent tous deux le comté de Los Angeles). - « OpenFEMA ne répond pas » : le service est en panne ou injoignable depuis la machine de Gladys. Les dernières valeurs restent ; l'intégration réessaie à chaque mise à jour et le signale une fois dans ses logs.
- Aucun déclencheur après un changement de réglages : normal, les déclarations déjà là ne sont pas des nouvelles.
- Les noms des fonctionnalités sont dans la mauvaise langue : ils sont fixés à la création de l'appareil. Changez la langue, supprimez l'appareil, puis recréez-le depuis l'onglet Découverte.
- Logs : page de l'intégration dans Gladys, onglet Logs.
LOG_LEVEL=debugdonne une ligne par lecture.
Limites
- Les déclarations sont des décisions prises après un événement, parfois des semaines plus tard : elles disent où va l'aide fédérale, pas où est le danger. Pour les alertes, voyez le National Weather Service et vos autorités locales.
- Les centres d'aide (Disaster Recovery Centers) ne sont pas listés : la FEMA les publie sur son site et dans son application.
- Les types d'incident sont traduits ; les intitulés des déclarations, les noms des comtés et les numéros FEMA restent en anglais.
- Testée contre le vrai service OpenFEMA le 12/11/2026 (un comté touché, un comté calme, des codes invalides) ; pas encore dans une vraie instance de Gladys : vos retours sont les bienvenus sur le forum.
Paramètres de configuration
Voici les paramètres demandés par FEMA Disasters dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre comté | section | Non | Suivez les déclarations de catastrophe FEMA de votre comté. Laissez le champ vide pour utiliser le comté de votre maison (sa position dans Gladys), ou saisissez jusqu'à 8 codes FIPS de comté. Enregistrez, puis créez les appareils dans l'onglet Découverte. |
| Sources et limites | section | Non | Données OpenFEMA, lues sans compte. Les déclarations sont des décisions administratives, souvent prises des jours après l'événement : pas un système d'alerte de sécurité. Non affiliée à la FEMA. |
| Codes FIPS des comtés | string | Non | 5 chiffres chacun, séparés par des virgules. Vide : le comté de votre maison. |
| Intervalle de mise à jour | select | Oui | |
| Langue des noms et des messages | select | Oui | Les noms des fonctionnalités sont fixés à la création des appareils. |
Comment installer FEMA Disasters dans Gladys
- Dans Gladys, ouvrez Intégrations : FEMA Disasters 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/guim31/gladys-fema: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/guim31/gladys-fema.
FEMA Disasters nécessite Gladys >=5.3.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
FEMA Disasters 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 guim31, 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