Integración domótica US National Parks, gratuita y de código abierto

Alertas, cierres y eventos de los parques nacionales de EE. UU. que sigue (Yosemite, Yellowstone…).
Siga en Gladys las alertas, cierres y eventos de los parques nacionales de EE. UU. que le interesan (Yosemite, Yellowstone, Gran Cañón…), a través de la API oficial del National Park Service (NPS).
Sin relación con el National Park Service. La punta de flecha del NPS es un emblema protegido: esta integración no la utiliza.
Lo que obtiene
- Un dispositivo por parque, con:
- el número de alertas actuales en cada categoría del NPS: cierre, peligro, precaución, información;
- cierre en curso (sí / no): hay publicada una alerta «Park Closure». A menudo es parcial (una carretera, un sendero, una zona), rara vez el parque entero;
- un nivel de alerta: 0 ninguna alerta, 1 información, 2 precaución, 3 peligro o cierre;
- la alerta más grave, en texto («Cierre: Tioga Road and Glacier Point Road will temporarily close…»);
- el próximo evento del calendario del parque (paseos con guardas, programas nocturnos…), a la hora local del parque.
- Un widget del panel con las alertas actuales, las más graves primero.
- Un disparador de escena «Nueva alerta de un parque», filtrable por parque y por categoría.
- Una acción de escena que lee las alertas en voz alta o las envía por mensaje.
Los títulos de las alertas y los nombres de los eventos vienen del NPS, en inglés.
Requisitos
- Gladys Assistant 5.3.0 o posterior.
- Acceso a Internet desde Gladys.
- Opcional pero recomendado: una clave API gratuita de api.data.gov.
Instalación
- En Gladys, vaya a Integraciones → Instalar desde GitHub.
- Pegue la dirección del repositorio:
https://github.com/guim31/gladys-nps. - Instale y abra la página de configuración de la integración.
Configuración
Ajustes
| Ajuste | Función |
|---|---|
| Clave API NPS | Su clave gratuita. Vacía: DEMO_KEY, compartida y limitada a pocas solicitudes por hora. |
| Parques nacionales | Los 63 parques nacionales. |
| Otros sitios del NPS | Códigos de otros sitios del NPS (monumentos, costas, sitios históricos…), separados por comas: stli, alca. |
| Actualización | Cada 30 minutos, cada hora (por defecto) o cada 2 horas. |
| Idioma de nombres y mensajes | Nombres de funciones (fijados al añadir el parque), textos, widget y frases de escenas. Francés por defecto. |
Obtener una clave: rellene el formulario de nps.gov/subjects/developer/get-started.htm (nombre y correo electrónico); la clave llega al instante por correo. Péguela en el campo Clave API NPS y guarde.
El código de un sitio es la parte de su dirección nps.gov tras el dominio:
https://www.nps.gov/stli/ da stli (Estatua de la Libertad).
Añadir parques
Guarde la configuración: cada parque aparece en la pestaña Descubrir de la integración. Añada a Gladys los que le interesen. Un parque quitado de la lista sigue funcionando mientras su dispositivo exista en Gladys.
Comprobar
El botón Estado de la página de configuración lista los parques seguidos, su número de alertas, la última lectura y el último error. Una clave no válida o un límite por hora alcanzado se muestra también arriba en la página de la integración.
Dispositivos
| Función | Tipo | Valores |
|---|---|---|
| Alertas de cierre | contador | alertas «Park Closure» actuales |
| Alertas de peligro | contador | alertas «Danger» actuales |
| Alertas de precaución | contador | alertas «Caution» actuales |
| Alertas de información | contador | alertas «Information» actuales |
| Cierre en curso | entrada (binaria) | 1 mientras hay publicada una alerta de cierre |
| Nivel de alerta | nivel de riesgo | 0 ninguna, 1 información, 2 precaución, 3 peligro/cierre |
| Alerta más grave | texto | «Peligro: <título>», o «Ninguna alerta» |
| Próximo evento | texto | «sáb, 14 nov, 18:30 · <título>», o «Ningún evento previsto» |
Los contadores, el cierre y el nivel guardan su historial: un gráfico muestra cuánto tiempo estuvo cerrada una carretera. Úselos en escenas («cuando Alertas de cierre de Yosemite cambia», «cuando Nivel de alerta vale 3»).
Widget del panel
Alertas de parques: las alertas actuales de los parques añadidos a Gladys, las más graves primero (cierres y peligros en rojo, precaución en naranja, información en azul), 10 líneas como máximo. Encima, el número por parque; debajo, un enlace a la página Current conditions del parque en nps.gov cuando se muestra un solo parque.
Ajustes: los parques mostrados (vacío: todos), e interruptores para ocultar las alertas de información, el número por parque y el enlace.
Disparadores de escena
Nueva alerta de un parque: el NPS publica una alerta que no estaba en la lectura anterior, para un parque añadido a Gladys. Filtros: parques (vacío: cualquiera) y categorías (cierre, peligro, precaución, información; vacío: cualquiera). Variables: nombre del parque, categoría, título de la alerta (inglés), texto «categoría: título», enlace a la alerta.
Las alertas ya publicadas al añadir un parque, o al iniciar la integración, no lo disparan.
Acción de escena
Leer las alertas de los parques: las alertas actuales de los parques
elegidos (vacío: todos) en una frase («Zion National Park: 4 alertas. Cierre:
…»), más números: número de alertas, alertas de cierre, alertas de peligro y la
categoría más grave (none, closure, danger, caution, information).
Ejemplos de escenas
- Viaje a la vista: disparador «Nueva alerta de un parque», parque Yosemite, categorías cierre y peligro → enviar el texto «categoría: título» y el enlace por mensaje.
- Resumen matinal durante el viaje: cada día a las 7:00 → «Leer las alertas de los parques» → decir la frase.
- Vigilar una carretera: cuando «Alertas de cierre» de Yellowstone vuelve a 0 → enviar un mensaje.
Datos y actualización
- Alertas: una solicitud agrupada para todos los parques en cada actualización.
- Eventos: una solicitud (o algunas páginas de 50) cada 6 horas y cada nuevo día, para los 31 días siguientes.
- Nombres de los sitios: una solicitud cuando se introducen sitios por código.
- api.data.gov permite 1.000 solicitudes por hora con una clave personal;
DEMO_KEYla comparten todos los usuarios de una misma dirección y está limitada a pocas solicitudes por hora: suficiente para una prueba, no para el uso diario. - Ante una clave no válida o un límite alcanzado, la integración lo indica en su página, hace una pausa tras un límite (el tiempo que pida la API, dos horas como máximo) y conserva los últimos valores.
Solución de problemas
- «La clave de la API NPS no es válida»: verifique la clave (sin espacios),
o vacíe el campo para probar con
DEMO_KEY. - «Límite de solicitudes de la API NPS alcanzado»: obtenga su propia clave (vea arriba).
- Un sitio introducido no aparece: el botón Estado lista los códigos que el NPS no conoce; verifique el código en la dirección nps.gov.
- Registros: en Gladys, los registros del contenedor de la integración;
ponga
LOG_LEVEL=debugpara una línea por lectura.
Limitaciones
- Datos del NPS: una alerta aparece cuando el parque la publica, a veces horas después de un cierre. Consulte siempre nps.gov antes de un viaje.
- «Cierre en curso» significa que hay publicada una alerta de cierre, no que todo el parque esté cerrado.
- Las horas de los eventos se dan a la hora local del parque (zona horaria de su estado).
- El estado de las carreteras no está cubierto: el NPS lo indica en el texto de las alertas.
- Desarrollada y probada contra la API real del NPS, pero sin uso prolongado: sus comentarios son bienvenidos en el foro.
Créditos
- Datos: API del National Park Service, dominio público (obra del gobierno de EE. UU.), a través de api.data.gov.
- Sin relación con el National Park Service. No se utiliza el emblema de la punta de flecha del NPS.
- Integración de guim31, licencia Apache 2.0.
Parámetros de configuración
Estos son los parámetros que US National Parks te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Funcionamiento | section | No | Elija sus parques y guarde: cada parque aparece en la pestaña Descubrir, añádalo a Gladys. Alertas y eventos provienen de la API oficial del National Park Service (NPS). |
| Clave API NPS | secret | No | Gratuita, en api.data.gov (enlace de arriba). Vacía: DEMO_KEY, limitada a pocas solicitudes por hora. |
| Parques nacionales | multi_select | No | Los 63 parques nacionales. Otros sitios del NPS: el campo de abajo. |
| Otros sitios del NPS | string | No | Códigos de otros sitios (monumentos, costas…), como en su dirección nps.gov, separados por comas. |
| Actualización | select | No | |
| Idioma de nombres y mensajes | select | No | Nombres de funciones (fijados al añadir el parque), textos, widget y frases de escenas. |
Cómo instalar US National Parks en Gladys
- En Gladys, abre Integraciones: US National Parks 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-nps: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-nps.
US National Parks 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
US National Parks 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