Integración domótica CDC Respiratory Viruses, gratuita y de código abierto

Gripe, COVID-19 y VRS en su estado o condado de EE. UU.: aguas residuales y hospitales (CDC).
COVID-19, gripe y VRS en su estado o condado de EE. UU., según los datos abiertos de los CDC (Centers for Disease Control and Prevention): el nivel de actividad viral en aguas residuales del National Wastewater Surveillance System (NWSS) y las hospitalizaciones del National Healthcare Safety Network (NHSN). Un dispositivo por lugar, disparadores de escena, una acción de escena y un widget.
Información de salud pública, no un consejo médico. Son niveles de todo un estado o de algunas plantas de tratamiento. Para su salud, consulte a su médico.
Sin afiliación con los CDC.
Qué obtiene
- Un dispositivo por lugar elegido: un estado (los 50 estados, el Distrito de Columbia y Puerto Rico) o un condado que usted escribe.
- Para COVID-19, gripe y VRS: el nivel en aguas residuales (1 Muy bajo a 5 Muy alto) y su tendencia, las hospitalizaciones por 100.000 habitantes de la semana y su nivel (1 a 5).
- La semana de los datos («Semana hasta el 31 oct.»).
- Dos disparadores de escena (un nivel sube hasta un nivel elegido o baja de él), una acción de escena (la semana en una frase) y un widget.
Requisitos
- Gladys Assistant 5.3.0 o posterior.
- Acceso a Internet desde Gladys. Sin cuenta ni clave.
- Solo Estados Unidos.
Configuración
Ajustes
| Ajuste | Por defecto | Qué hace |
|---|---|---|
| Estados | ninguno | Los estados a seguir, un dispositivo cada uno. |
| Condados | vacío | Condado, ST separados por punto y coma, 10 como máximo: Harris, TX; Cook, IL |
| Token de aplicación (opcional) | vacío | Un token gratuito de data.cdc.gov, solo si se alcanza el límite de solicitudes. |
| Idioma de los nombres de las funciones | Francés | Nombres de las nuevas funciones, idioma de sus textos y del resumen. |
Guarde, abra la pestaña Descubrir de la integración y cree los dispositivos que desee.
Un condado se encuentra por su nombre entre los condados que atiende cada planta de tratamiento («Harris County» y «Harris» son lo mismo). Un condado sin planta propia muestra los niveles de todo su estado, y su semana lo indica («aguas residuales del estado»). Sus cifras hospitalarias son siempre las de su estado: el NHSN no publica datos por condado.
Dispositivos
| Función (× COVID-19, gripe, VRS) | Tipo | Valor |
|---|---|---|
| Aguas residuales …, nivel | número | 1 Muy bajo, 2 Bajo, 3 Moderado, 4 Alto, 5 Muy alto |
| Aguas residuales …, tendencia | texto | al alza, estable o a la baja |
| Hospital …, nivel | número | 1 a 5, el nivel NHSN de las hospitalizaciones del estado |
| Hospitalizaciones … /100.000 | número | nuevas hospitalizaciones por 100.000 habitantes en la semana |
| Semana de los datos | texto | fecha de fin de la semana (sábado), de cada fuente si difieren |
El nivel en aguas residuales de un estado o condado es la mediana de los niveles de sus plantas que informaron esa semana, como en el mapa de los CDC; la integración la calcula a partir de los niveles por planta que publican los CDC, por lo que rara vez puede diferir un escalón del mapa. Para la gripe, las aguas residuales miden la influenza A; los hospitales cuentan toda gripe.
Una semana cuenta en cuanto al menos la mitad de las plantas de la semana anterior la han publicado: hasta entonces, el dispositivo conserva la semana anterior.
La tendencia compara la mediana de las aguas residuales con la semana anterior: «al alza» desde +20 % (y al menos +0,5), «a la baja» desde −1/6 (y al menos −0,5); si no, «estable».
Los niveles son números: una condición de escena como «Aguas residuales VRS, nivel ≥ 4» funciona directamente.
Widget
Virus respiratorios: el lugar elegido (si no, el primero seguido), con una línea por virus para las aguas residuales (nivel y tendencia) y otra para los hospitales (hospitalizaciones y nivel), en verde hasta Bajo, naranja en Moderado y rojo desde Alto, y una leyenda con la semana y la fuente. Un ajuste elige los indicadores mostrados y otro oculta la leyenda.
Disparadores de escena
- Sube el nivel de un virus respiratorio: al publicarse una nueva semana, un nivel de aguas residuales u hospitalario de un lugar alcanza desde abajo el nivel elegido (Bajo a Muy alto). Filtros: lugar, virus, indicador, nivel.
- Baja el nivel de un virus respiratorio: lo mismo a la baja: el nivel vuelve a quedar por debajo del elegido.
Variables: lugar, virus, indicador, nivel (número), nombre del nivel, nivel anterior, semana. La primera semana leída tras la instalación solo fija la referencia: no dispara nada.
Acción de escena
CDC: obtener la semana en una frase: devuelve, para un lugar (vacío: el primero seguido), una frase lista para una notificación, como «Texas, semana hasta el 31 oct.: COVID-19: nivel bajo y a la baja en aguas residuales, 1,15 hospitalizaciones por 100.000 hab.; Gripe: …», en el idioma de la configuración, con cada nivel y tasa como salidas separadas.
Ejemplos de escenas
- Cada sábado a las 9, enviar la frase de su condado al grupo familiar.
- Cuando el nivel de gripe en las aguas residuales de su condado llegue a Alto, recordar a todos que se laven las manos o planificar la vacuna.
- Cuando el nivel del VRS vuelva por debajo de Moderado, anunciar el fin de la ola.
Fuentes de datos, licencia y cuotas
- Fuente: CDC, data.cdc.gov, dominio público (obra del gobierno de EE. UU.), leído sin
cuenta:
atcp-73re, «CDC Wastewater Viral Activity Level for SARS-CoV-2, Influenza A and RSV» (NWSS), actualizado los viernes;vdzy-6i9v, «Weekly Hospital Respiratory Admission Levels and Rates by Jurisdiction» (NHSN), semanal.
- Los datos son semanales; la integración los lee cada 6 horas (dos solicitudes, solo para los estados seguidos y las cuatro últimas semanas): una semana nueva aparece menos de 6 horas después de su publicación.
- Sin token, data.cdc.gov limita las solicitudes de cada dirección; un hogar queda muy por debajo. Tras una respuesta «demasiadas solicitudes», la integración espera una hora (luego más), reinicios incluidos. Un token de aplicación (gratuito, en data.cdc.gov) eleva el límite.
Solución de problemas
- Ningún valor tras crear el dispositivo: espere unos segundos a la primera lectura; compruebe que Gladys tiene acceso a Internet.
- Ningún valor de aguas residuales: ninguna planta del estado informó en las cuatro últimas semanas (Dakota del Norte y Oklahoma, por ejemplo, en noviembre de 2026). Los valores hospitalarios llegan igualmente.
- El estado de conexión indica que no se puede leer data.cdc.gov: el portal no responde; se conservan los últimos valores y la integración vuelve a intentarlo 30 minutos después y luego cada 6 horas.
- El estado de conexión indica que data.cdc.gov limita las solicitudes: la integración espera y vuelve a intentarlo sola; añada un token de aplicación si ocurre a menudo.
Límites
- Desarrollada y probada con el data.cdc.gov real, aún no dentro de un Gladys en funcionamiento: sus comentarios son bienvenidos.
- Los niveles en aguas residuales de estados y condados los calcula la integración a partir de los niveles por planta (mediana); no se leen del mapa de los CDC.
- Los datos hospitalarios solo existen por estado; un condado recibe los de su estado.
- Fuera de temporada, un nivel puede quedar sin publicar («Data Unavailable»): el dispositivo conserva su último valor.
Parámetros de configuración
Estos son los parámetros que CDC Respiratory Viruses te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus lugares | section | No | Elija sus estados y, si lo desea, condados: un dispositivo por lugar, con el nivel en aguas residuales de COVID-19, gripe y VRS, su tendencia y las hospitalizaciones del estado. Guarde y cree los dispositivos en la pestaña Descubrir. |
| Fuentes y límites | section | No | Datos abiertos de los CDC (aguas residuales NWSS, hospitales NHSN), leídos sin cuenta cada 6 horas; los CDC publican una vez por semana. Solo Estados Unidos. Información de salud pública, no un consejo médico. Sin afiliación con los CDC. |
| Estados | multi_select | No | Un dispositivo por estado elegido. |
| Condados | string | No | Nombre del condado y código del estado, separados por punto y coma, 10 como máximo. Aguas residuales de sus propias plantas; sin planta, el nivel del estado. |
| Token de aplicación (opcional) | secret | No | Token gratuito de data.cdc.gov que eleva el límite de solicitudes de su dirección. Innecesario en la mayoría de los hogares. |
| Idioma de los nombres de las funciones | select | No | Nombres de las nuevas funciones e idioma de sus textos (tendencias, semanas, variables de escena y resumen). |
Cómo instalar CDC Respiratory Viruses en Gladys
- En Gladys, abre Integraciones: CDC Respiratory Viruses 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-cdc-respiratory: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-cdc-respiratory.
CDC Respiratory Viruses 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
CDC Respiratory Viruses 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