Saltar al contenido principal

Integración domótica USGS Volcanoes, gratuita y de código abierto

Integración USGS Volcanoes para Gladys Assistant

Niveles de alerta de los volcanes de EE. UU. (Hawái, Alaska, Cascadas, Yellowstone…) del USGS

Siga desde Gladys el nivel de alerta de los volcanes de Estados Unidos: Hawái, Alaska, las Cascadas, California, Yellowstone, las Islas Marianas del Norte y la Samoa Americana. Los cinco observatorios volcanológicos del USGS (United States Geological Survey) evalúan cada volcán vigilado dos veces:

  • el nivel de alerta volcánica, para la población en tierra: Normal, Aviso (Advisory), Vigilancia (Watch), Alerta (Warning);
  • el código de color de aviación, para los aviones: verde, amarillo, naranja, rojo.

La integración los lee en HANS, el sistema de notificación público del USGS. Sin cuenta ni clave de API.

Es un complemento, no es un sistema de alerta de seguridad: en caso de emergencia, siga los boletines oficiales y las instrucciones de las autoridades locales. Sin afiliación con el USGS.

Qué obtiene​

  • Un dispositivo por volcán seguido: nivel de alerta, código de color de aviación y el último boletín del USGS (tipo, fecha y, para los volcanes más activos, un resumen de una línea), con su historial.
  • Un dispositivo Volcanes cercanos: el nivel de alerta más alto de los volcanes vigilados en un radio alrededor de su casa, el número por encima de lo normal y el volcán correspondiente.
  • Un widget de panel que enumera sus volcanes, los más activos primero, cada uno con su boletín y su página del USGS.
  • Un disparador de escena cuando cambia el nivel de alerta o el código de color de un volcán seguido o cercano.
  • Una acción de escena que lee los niveles 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 volcanoes.usgs.gov).
  • Para los volcanes cercanos: una ubicación para su casa en Gladys (Ajustes → Casas) o coordenadas introducidas en la configuración.

Configuración​

Instale la integración desde la tienda (o Integraciones → Instalar desde GitHub, con la dirección https://github.com/guim31/gladys-usgs-volcanoes) y abra su pestaña Configuración.

Ajustes​

AjustePor defectoEfecto
Volcanes seguidosvacíoNombres, números de volcán o códigos de observatorio, separados por comas
Volcanes cercanos: radio200 kmDesactivado, 50, 100, 200, 500 o 1000 km alrededor del centro
Latitud del centrovacíoDeje ambas coordenadas vacías para usar la ubicación de su casa
Longitud del centrovacíoGrados decimales, oeste negativo (-121.7603)
Intervalo de actualización15 minutos10, 15, 30 o 60 minutos
Idioma de los textosFrancésNombres de dispositivos y funciones (al crearlos) y textos de las escenas

Guarde y abra la pestaña Descubrimiento: un dispositivo por volcán seguido, más Volcanes cercanos si eligió un radio. Añada a Gladys los que quiera.

Elegir los volcanes​

Escriba los nombres como los escribe el USGS, separados por comas. Mayúsculas, acentos y «Mount»/«Mt» no importan: kilauea, Kīlauea, St. Helens y mt rainier funcionan, igual que una parte de un solo nombre (shasta). Una parte común a varios volcanes (sitkin: Great Sitkin y Little Sitkin) es ambigua y se ignora. También puede escribir el número Smithsonian del volcán (332010) o un código de observatorio para seguir todos sus volcanes. La pestaña Configuración enumera los nombres no encontrados.

Los volcanes vigilados el 12/11/2026, por observatorio:

  • avo, Alaska Volcano Observatory: Akutan, Aniakchak, Atka volcanic complex, Augustine, Cleveland, Dutton, Edgecumbe, Fisher, Gareloi, Great Sitkin, Griggs, Iliamna, Isanotski, Kanaga, Katmai, Korovin, Little Sitkin, Mageik, Makushin, Martin, Novarupta, Okmok, Pavlof, Redoubt, Semisopochnoi, Shishaldin, Snowy Mountain, Spurr, Takawangha, Tanaga, Trident, Ugashik-Peulik, Ukinrek Maars, Veniaminof, Westdahl, Wrangell.
  • calvo, California Volcano Observatory: Clear Lake Volcanic Field, Coso Volcanic Field, Lassen Volcanic Center, Long Valley Caldera, Mammoth Mountain, Medicine Lake volcano, Mono Lake Volcanic Field, Mono-Inyo Craters, Mount Shasta, Salton Buttes, Ubehebe Craters.
  • cvo, Cascades Volcano Observatory: Crater Lake, Glacier Peak, Mount Adams, Mount Baker, Mount Hood, Mount Jefferson, Mount Rainier, Mount St. Helens, Newberry, Three Sisters.
  • hvo, Hawaiian Volcano Observatory: Haleakala, Hualalai, Kilauea, Mauna Kea, Mauna Loa y, en la Samoa Americana, Ofu-Olosega, Ta'u Island, Tutuila Island.
  • nmi, Islas Marianas del Norte: Ahyi Seamount.
  • yvo, Yellowstone Volcano Observatory: Yellowstone.

Los demás volcanes de EE. UU. no tienen nivel de alerta (sin vigilancia en tiempo real): no se pueden seguir.

Dispositivos​

Cada volcán seguido es un dispositivo con su nombre («Volcán Kilauea»):

FunciónValores
Nivel de alerta volcánica0 Normal, 1 Aviso, 2 Vigilancia, 3 Alerta (nivel de riesgo)
Código de color de aviación0 verde, 1 amarillo, 2 naranja, 3 rojo (nivel de riesgo)
Último boletín del USGS«Boletín diario, 11/11/2026: …» — tipo, fecha, resumen

Volcanes cercanos resume los volcanes vigilados dentro del radio:

FunciónValores
Nivel de alerta más alto0 a 3, como arriba
Volcanes por encima de lo normalnúmero de volcanes por encima de Normal o verde
Volcán más activo«Mount Rainier: Vigilancia / Naranja, a 94 km», o ninguno

Los niveles de alerta tienen un valor numérico: una condición de escena «nivel de alerta mayor o igual a 2» reacciona a Vigilancia y Alerta, los casos en que el USGS considera una erupción probable o en curso. El historial de la función de nivel de alerta da la fecha de cada cambio.

Widget de panel​

Añada el widget Volcanes USGS a un panel: el número de volcanes por encima de lo normal, luego sus volcanes seguidos y los cercanos por encima de lo normal (8 como máximo), los más activos primero. Cada fila muestra el código de color de aviación, el observatorio y la distancia; tóquela para ver el último boletín, su resumen, la fecha del último cambio de nivel (en cuanto la integración haya visto uno) y los enlaces al boletín y a la página del volcán.

Dos ajustes: Solo por encima de lo normal oculta los volcanes tranquilos, Enlace a USGS HANS muestra u oculta el botón inferior.

Disparadores de escena​

Volcán USGS: nivel de alerta cambiado se dispara cuando cambia el nivel de alerta o el código de color de aviación de un volcán seguido, o de un volcán dentro del radio. Filtros, todos opcionales: el nuevo nivel de alerta, el nuevo color de aviación y el sentido (en aumento o en descenso).

Variables: alert_level, aviation_color y direction (palabras inglesas estables), volcano, vnum, observatory, alert_level_name y aviation_color_name (en el idioma de la configuración), previous_alert_level, previous_aviation_color, distance_km (vacía sin centro), summary («Kilauea: Vigilancia / Naranja, a 4317 km») y notice_url.

Los niveles ya presentes en el primer arranque no disparan nada, como tampoco un volcán que empieza a seguir: solo cuentan los cambios vistos por la integración. Los últimos niveles se conservan: un cambio ocurrido mientras la integración está detenida se dispara en el siguiente arranque, nada más.

Acción de escena​

Volcanes USGS: leer los niveles vuelve a leer HANS si hace falta y devuelve:

  • text: una frase, por ejemplo «1 volcán por encima de lo normal: Kilauea: Aviso / Amarillo; Mount Rainier: Normal / Verde, a 94 km.» (5 volcanes como máximo, luego «y N más»);
  • max_level: none, normal, advisory, watch o warning;
  • elevated_count: el número de volcanes por encima de lo normal.

El botón Mostrar los niveles actuales de la pestaña Configuración da la misma frase.

Ejemplos de escenas​

  • Recibir un mensaje cuando un volcán cercano pasa a Vigilancia o Alerta: disparador «Volcán USGS: nivel de alerta cambiado», filtros «Vigilancia, Alerta» y «En aumento», luego enviar summary y notice_url.
  • Cada mañana, leer los niveles en voz alta: disparador programado, acción «Volcanes USGS: leer los niveles», luego decir text.
  • Encender una lámpara en naranja mientras el Mount Rainier esté por encima de lo normal: condición sobre su dispositivo de nivel de alerta.

Fuentes de datos, condiciones y cuotas​

Los datos proceden del Volcano Hazards Program del USGS, a través de la API pública HANS (https://volcanoes.usgs.gov/hans-public/api/): los volcanes vigilados y sus niveles en cada actualización, los resúmenes de los más activos (alertas CAP) y la posición de los volcanes de EE. UU. una vez al día. Los datos del USGS son de dominio público; la integración cita la fuente en el widget. HANS no publica cuotas: la integración pide como máximo tres pequeños documentos por actualización, cada 15 minutos por defecto.

Lea los niveles de alerta explicados por el USGS (en inglés).

Solución de problemas​

  • «No encontrado entre los volcanes vigilados, o ambiguo»: compruebe la ortografía en la lista de arriba o escriba el número del volcán. Un volcán sin vigilancia en tiempo real no tiene nivel.
  • «Sin centro para los volcanes cercanos»: indique la ubicación de su casa en Gladys o introduzca coordenadas.
  • «El USGS (HANS) no responde»: los valores se mantienen; la integración vuelve a intentarlo en la siguiente actualización. Compruebe el acceso a Internet del equipo de Gladys.
  • Ningún dispositivo nuevo tras cambiar la lista: abra la pestaña Descubrimiento y añádalo.
  • Inicie el contenedor con LOG_LEVEL=debug para ver cada actualización en sus registros.

Límites​

  • Solo los volcanes de Estados Unidos vigilados por el USGS; los niveles son los del último boletín.
  • La fecha del último cambio de nivel solo se conoce por la observación de la integración (HANS no la da); el historial de la función en Gladys la conserva.
  • Los boletines y resúmenes están en inglés, como los escribe el USGS.
  • El nombre de un dispositivo y de sus funciones se fija al crearlo, en el idioma elegido entonces.

Parámetros de configuración​

Estos son los parámetros que USGS Volcanoes te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Sus volcanessectionNoLos observatorios volcanológicos del USGS clasifican los volcanes vigilados de EE. UU.: nivel de alerta en tierra (Normal, Aviso, Vigilancia, Alerta) y código de color de aviación (verde a rojo). Siga volcanes por su nombre y/o todos los que rodean su casa.
Volcanes seguidosstringNoNombres separados por comas (Kilauea, Mount St. Helens…), números de volcán o un observatorio (avo, calvo, cvo, hvo, nmi, yvo) para todos sus volcanes. Un dispositivo por volcán.
Volcanes cercanos: radioselectNoUn dispositivo «Volcanes cercanos» da el nivel de alerta más alto de los volcanes vigilados a esta distancia de su casa. Desactivado: sin dispositivo.
Latitud del centrostringNoDeje ambas coordenadas vacías para usar la ubicación de su casa en Gladys.
Longitud del centrostringNoGrados decimales, oeste negativo.
Intervalo de actualizaciónselectNoLos observatorios publican unos pocos boletines al día como máximo; un cambio de nivel siempre llega con un boletín.
Idioma de los textosselectNoNombres de los dispositivos y funciones (al crearlos) y textos enviados a las escenas.
Fuentes y límitessectionNoDatos: USGS Volcano Hazards Program (dominio público), leídos sin cuenta. Sin afiliación con el USGS. No es un sistema de alerta de seguridad: siga los boletines oficiales y a las autoridades locales.

Cómo instalar USGS Volcanoes en Gladys​

  1. En Gladys, abre Integraciones: USGS Volcanoes 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-usgs-volcanoes: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-usgs-volcanoes.

USGS Volcanoes 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​

USGS Volcanoes 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 🙂