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

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
| Ajuste | Por defecto | Efecto |
|---|---|---|
| Volcanes seguidos | vacío | Nombres, números de volcán o códigos de observatorio, separados por comas |
| Volcanes cercanos: radio | 200 km | Desactivado, 50, 100, 200, 500 o 1000 km alrededor del centro |
| Latitud del centro | vacío | Deje ambas coordenadas vacías para usar la ubicación de su casa |
| Longitud del centro | vacío | Grados decimales, oeste negativo (-121.7603) |
| Intervalo de actualización | 15 minutos | 10, 15, 30 o 60 minutos |
| Idioma de los textos | Francés | Nombres 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ón | Valores |
|---|---|
| Nivel de alerta volcánica | 0 Normal, 1 Aviso, 2 Vigilancia, 3 Alerta (nivel de riesgo) |
| Código de color de aviación | 0 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ón | Valores |
|---|---|
| Nivel de alerta más alto | 0 a 3, como arriba |
| Volcanes por encima de lo normal | nú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,watchowarning;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
summaryynotice_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=debugpara 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ámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus volcanes | section | No | Los 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 seguidos | string | No | Nombres 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: radio | select | No | Un 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 centro | string | No | Deje ambas coordenadas vacías para usar la ubicación de su casa en Gladys. |
| Longitud del centro | string | No | Grados decimales, oeste negativo. |
| Intervalo de actualización | select | No | Los observatorios publican unos pocos boletines al día como máximo; un cambio de nivel siempre llega con un boletín. |
| Idioma de los textos | select | No | Nombres de los dispositivos y funciones (al crearlos) y textos enviados a las escenas. |
| Fuentes y límites | section | No | Datos: 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
- En Gladys, abre Integraciones: USGS Volcanoes 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-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). - 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-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.
- 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