Integración domótica FEMA Disasters, gratuita y de código abierto

Declaraciones de desastre de FEMA y ayudas abiertas para su condado de EE. UU.
Siga desde Gladys las declaraciones de desastre de FEMA, la agencia federal estadounidense para la gestión de emergencias, para su condado: huracanes, inundaciones, incendios, tormentas invernales, tornados… Cuando un desastre golpea, el Presidente (desastre mayor, emergencia) o FEMA (ayuda para la gestión de incendios) lo declara para una lista de condados y abre allí programas de ayuda: la asistencia individual (Individual Assistance, que se solicita en DisasterAssistance.gov), la asistencia pública (Public Assistance, para los gobiernos locales) y la mitigación de riesgos (Hazard Mitigation).
La integración lee estas decisiones en OpenFEMA, los datos abiertos de FEMA, para el condado de su casa o los condados que usted elija. Sin cuenta ni clave de API.
Las declaraciones son decisiones administrativas, a menudo tomadas días después del evento: no es un sistema de alerta de seguridad. En caso de emergencia, siga las instrucciones de sus autoridades locales y del National Weather Service. Sin afiliación con FEMA. Este producto utiliza la API OpenFEMA de FEMA, pero no está respaldado por FEMA.
Lo que obtiene
- Un dispositivo por condado: desastre declarado (sí / no), tipo de incidente y fecha de la última declaración, asistencia individual, asistencia pública y mitigación de riesgos abiertas (sí / no), y el número de declaraciones en 12 meses.
- Un widget del panel: una fila por condado, sus declaraciones en curso, sus programas, la fecha límite de solicitud y enlaces a la página de FEMA de cada desastre y a DisasterAssistance.gov.
- Dos disparadores de escena: una nueva declaración para su condado, y la asistencia individual abierta (con la fecha límite de solicitud).
- Una acción de escena que lee las declaraciones en curso en una frase, para enviar por mensaje o leer en voz alta.
Requisitos
- Gladys Assistant 5.3 o posterior.
- Acceso a Internet desde el equipo de Gladys (la integración lee
www.fema.gov, ygeo.fcc.govpara encontrar el condado de su casa). - Una casa en Estados Unidos (los 50 estados, el Distrito de Columbia, Puerto Rico y los territorios): su ubicación en Gladys (Ajustes → Casas), o códigos FIPS de condado introducidos en la configuración.
Configuración
Ajustes
| Ajuste | Función |
|---|---|
| Códigos FIPS de condados | Hasta 8 códigos de condado de 5 dígitos, separados por comas. Vacío: el condado de su casa. |
| Intervalo de actualización | 30 minutos, 1 hora (por defecto), 3 o 6 horas. |
| Idioma de los nombres y mensajes | Nombres de las funciones (al crearlas) y textos enviados a las escenas. Francés por defecto. |
Guarde, abra la pestaña Descubrir de la integración y cree el dispositivo de cada condado. El botón Mostrar las declaraciones en curso de la configuración responde enseguida: una forma rápida de comprobar los ajustes.
Encontrar su condado
Deje el campo vacío: la integración envía una vez la ubicación de su casa, redondeada a tres decimales (unos 100 m), a la FCC Area API, que devuelve su condado. Solo vuelve a preguntar si la ubicación de la casa cambia.
Para seguir otros condados (familia, una segunda residencia), introduzca sus códigos FIPS: 2 dígitos
para el estado y luego 3 para el condado. Ejemplos: 12086 condado de Miami-Dade, Florida; 06037
condado de Los Ángeles, California; 22071 parroquia de Orleans, Luisiana. El Census Bureau publica la
lista de los códigos. Un código que no
conoce se ignora y se indica en el estado de la configuración.
Declaración en curso
Una declaración afecta a su condado cuando FEMA lo designa, o al estado entero («Statewide»). Las declaraciones tribales, hechas para tierras tribales, no se cuentan. Una declaración está en curso cuando no está cerrada y:
- se hizo hace menos de 30 días;
- o su periodo de incidente sigue abierto (un incidente sin fecha de fin cuenta un año como máximo, 30 días para una ayuda para la gestión de incendios, que nunca la recibe);
- o las solicitudes de asistencia individual siguen abiertas (hasta la fecha límite).
«Asistencia individual» está a 1 mientras las solicitudes de una declaración en curso estén abiertas (60 días tras la declaración mientras FEMA no indique una fecha límite). «Asistencia pública» y «Mitigación de riesgos» están a 1 cuando una declaración en curso las incluye.
Dispositivo
| Función | Tipo | Valores |
|---|---|---|
| Desastre declarado | Binario | 1 cuando hay una declaración en curso |
| Tipo de incidente | Texto | Última declaración, p. ej. «Huracán · Hurricane Isaias» |
| Fecha de declaración | Texto | Su fecha y su número, p. ej. «27/10/2026 (DR-4955)» |
| Asistencia individual | Binario | 1 mientras las solicitudes estén abiertas |
| Asistencia pública | Binario | 1 cuando una declaración en curso la incluye |
| Mitigación de riesgos | Binario | 1 cuando una declaración en curso la incluye |
| Declaraciones en 12 meses | Contador | Declaraciones de los últimos 365 días |
El dispositivo se llama «FEMA · condado, estado»: cámbiele el nombre en Gladys como desee. Los valores solo se envían cuando cambian, y de nuevo cada 12 horas.
Widget del panel
Añada el widget Declaraciones FEMA a un panel. Muestra el número de declaraciones en curso y luego una fila por condado con una insignia roja «Declarada» o verde «Ninguna». Toque una fila para ver el detalle: número, tipo y fecha de cada declaración, periodo del incidente, programas, fecha límite de solicitud y enlaces. El pie indica la hora de la última lectura y un enlace a la página de declaraciones de FEMA (que se puede ocultar en los ajustes del widget).
Disparadores de escena
FEMA: nueva declaración para mi condado. Aparece una declaración de los últimos 90 días para un
condado seguido. Filtros: el condado (su dispositivo) y los tipos de declaración (desastre mayor,
emergencia, gestión de incendios). Variables: county_name, declaration_id (DR-4955-FL),
declaration_type_name, incident_type (tal como lo escribe FEMA, en inglés), incident_type_name,
title, declaration_date, individual_assistance (verdadero cuando las solicitudes están abiertas),
summary (una frase) y url.
FEMA: asistencia individual abierta. Los residentes de un condado seguido pueden solicitar la ayuda
de FEMA: con una nueva declaración o más tarde, cuando FEMA modifica una declaración para añadir el
condado al programa. Filtro: el condado. Variables: county_name, declaration_id,
incident_type_name, title, deadline (último día para solicitarla, cuando FEMA lo indica), summary,
url y registration_url.
Las declaraciones ya presentes cuando se empieza a seguir un condado no disparan nada: no son noticias. Un reinicio de la integración tampoco.
Acción de escena
FEMA: leer las declaraciones vuelve a consultar OpenFEMA si la última lectura es más antigua que el intervalo de actualización, y devuelve:
text: las declaraciones en curso de cada condado, en una frase;active_count: el número de declaraciones en curso;assistance_open: verdadero cuando las solicitudes de asistencia individual están abiertas en un condado seguido.
Ejemplos de escenas
- Avisar a la familia: con «asistencia individual abierta», enviar
{{triggerEvent.data.summary}}y el enlace{{triggerEvent.data.registration_url}}por mensaje. - Recordatorio semanal: cada lunes, ejecutar «leer las declaraciones» y enviar su texto si
assistance_openes verdadero. - Nueva declaración: con un desastre mayor declarado para su condado, enviar
{{triggerEvent.data.summary}}y{{triggerEvent.data.url}}.
Fuentes de datos, condiciones y cuotas
- Declaraciones: conjunto de datos OpenFEMA «Disaster Declarations Summaries» (v2), datos públicos del gobierno de Estados Unidos, leídos sin cuenta. Este producto utiliza la API OpenFEMA de FEMA, pero no está respaldado por FEMA. El gobierno federal y FEMA no garantizan los datos ni los análisis derivados de ellos una vez obtenidos de sus sitios web. Consulte las condiciones de OpenFEMA.
- Condado de la casa: FCC Area API, pública, sin cuenta.
- Nombres y códigos de los condados: US Census Bureau, códigos FIPS de 2020 (la versión que usa FEMA), incluidos en la integración.
- Cuotas: OpenFEMA no publica ninguna para este uso. La integración envía una petición por condado y por intervalo de actualización (cada hora por defecto), y una petición a la FCC cuando la casa cambia de ubicación.
Solución de problemas
- «Ningún condado»: indique la ubicación de su casa en Gladys (Ajustes → Casas), o introduzca códigos FIPS de condado.
- «Ningún condado de EE. UU. en la ubicación de su casa»: la casa está fuera de Estados Unidos (o su ubicación cae en el mar): introduzca los códigos FIPS de los condados que desea seguir.
- La casa cambió de condado: se ofrece un nuevo dispositivo en la pestaña Descubrir; elimine el dispositivo del condado anterior, que ya no recibe valores.
- «Ignorado (no es un código FIPS de condado)»: compruebe el código en la lista del Census (5
dígitos, cero inicial opcional:
6037y06037designan ambos el condado de Los Ángeles). - «OpenFEMA no responde»: el servicio está caído o no es accesible desde el equipo de Gladys. Los últimos valores se mantienen; la integración lo reintenta en cada actualización y lo indica una vez en sus registros.
- Ningún disparador tras un cambio de ajustes: es normal, las declaraciones ya presentes no son noticias.
- Los nombres de las funciones están en el idioma equivocado: se fijan al crear el dispositivo. Cambie el idioma, elimine el dispositivo y vuelva a crearlo desde la pestaña Descubrir.
- Registros: página de la integración en Gladys, pestaña Logs.
LOG_LEVEL=debugmuestra una línea por lectura.
Límites
- Las declaraciones son decisiones tomadas después de un evento, a veces semanas más tarde: dicen adónde va la ayuda federal, no dónde está el peligro. Para las alertas, consulte el National Weather Service y sus autoridades locales.
- Los centros de ayuda (Disaster Recovery Centers) no se muestran: FEMA los publica en su sitio y en su aplicación.
- Los tipos de incidente se traducen; los títulos de las declaraciones, los nombres de los condados y los números de FEMA quedan en inglés.
- Probada con el servicio real de OpenFEMA el 12/11/2026 (un condado afectado, un condado tranquilo, códigos no válidos); todavía no en una instancia real de Gladys: sus comentarios son bienvenidos en el foro.
Parámetros de configuración
Estos son los parámetros que FEMA Disasters te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su condado | section | No | Siga las declaraciones de desastre de FEMA de su condado. Deje el campo vacío para usar el condado de su casa (su ubicación en Gladys) o introduzca hasta 8 códigos FIPS de condado. Guarde y cree los dispositivos en la pestaña Descubrir. |
| Fuentes y límites | section | No | Datos de OpenFEMA, leídos sin cuenta. Las declaraciones son decisiones administrativas, a menudo tomadas días después del evento: no es un sistema de alerta de seguridad. Sin afiliación con FEMA. |
| Códigos FIPS de condados | string | No | 5 dígitos cada uno, separados por comas. Vacío: el condado de su casa. |
| Intervalo de actualización | select | Sí | |
| Idioma de los nombres y mensajes | select | Sí | Los nombres de las funciones se fijan al crear los dispositivos. |
Cómo instalar FEMA Disasters en Gladys
- En Gladys, abre Integraciones: FEMA Disasters 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/guim31/gladys-fema:1.0.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/guim31/gladys-fema.
FEMA Disasters requiere Gladys >=5.3.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
FEMA Disasters 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 guim31, 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