Saltar al contenido principal

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

Integración CDC Respiratory Viruses para Gladys Assistant

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​

AjustePor defectoQué hace
EstadosningunoLos estados a seguir, un dispositivo cada uno.
CondadosvacíoCondado, ST separados por punto y coma, 10 como máximo: Harris, TX; Cook, IL
Token de aplicación (opcional)vacíoUn token gratuito de data.cdc.gov, solo si se alcanza el límite de solicitudes.
Idioma de los nombres de las funcionesFrancésNombres 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)TipoValor
Aguas residuales …, nivelnúmero1 Muy bajo, 2 Bajo, 3 Moderado, 4 Alto, 5 Muy alto
Aguas residuales …, tendenciatextoal alza, estable o a la baja
Hospital …, nivelnúmero1 a 5, el nivel NHSN de las hospitalizaciones del estado
Hospitalizaciones … /100.000númeronuevas hospitalizaciones por 100.000 habitantes en la semana
Semana de los datostextofecha 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ámetroTipoObligatorioDescripción
Sus lugaressectionNoElija 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ímitessectionNoDatos 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.
Estadosmulti_selectNoUn dispositivo por estado elegido.
CondadosstringNoNombre 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)secretNoToken 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 funcionesselectNoNombres de las nuevas funciones e idioma de sus textos (tendencias, semanas, variables de escena y resumen).

Cómo instalar CDC Respiratory Viruses en Gladys​

  1. En Gladys, abre Integraciones: CDC Respiratory Viruses aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. 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).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. 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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂