Integración domótica Mapbox Traffic, gratuita y de código abierto
Tráfico en tiempo real en sus trayectos: duración, retraso, gráficos y alertas de atascos (Mapbox).
Publicado por quentinlegay
- Dispositivos
- Versión 1.1.2
- Requiere Gladys >=5.1.0
- ★ 0
Siga la duración de sus trayectos habituales (casa → trabajo, colegio…) con el
tráfico en tiempo real, véala en un gráfico y reciba avisos de atascos o de
trayectos anormalmente largos. Los datos proceden de la
API Mapbox Directions
(perfil driving-traffic).
Qué obtiene
Un dispositivo trayecto por cada trayecto configurado (hasta 3), con:
| Funcionalidad | Descripción |
|---|---|
| Duración del trayecto | Duración con el tráfico actual, en minutos (guardada en el historial) |
| Duración habitual | Duración típica a esta hora de la semana según Mapbox |
| Retraso | Diferencia entre ambas, en minutos |
| Distancia | Longitud de la ruta recomendada, en km |
| Nivel de tráfico | 0 fluido, 1 lento, 2 atasco, 3 atasco grave |
| Tráfico | El mismo nivel en texto |
| Por | Las carreteras principales tomadas («A86, A1») |
Además:
- un widget de panel «Duración del trayecto»: duración, retraso, gráfico de la duración actual frente a la habitual, estado del tráfico y un botón «Actualizar»;
- cuatro disparadores de escena: Atasco en un trayecto, Fin del atasco, Duración del trayecto anormalmente larga, Duración del trayecto de nuevo normal;
- una acción de escena Obtener la duración de un trayecto, por ejemplo para enviar cada mañana «32 min (+7 min) · Lento».
Configuración
- Cree una cuenta gratuita en mapbox.com y
copie su token de acceso público predeterminado (empieza por
pk.). El plan gratuito incluye 100 000 solicitudes de rutas al mes. - En la pestaña Configuración de la integración, pegue el token.
- Rellene al menos el trayecto 1:
- Nombre: por ejemplo «Trabajo»;
- Origen: déjelo vacío para salir de la ubicación de la casa definida en Gladys (Ajustes → Casas), o escriba una dirección o unas coordenadas;
- Destino: una dirección o unas coordenadas «latitud, longitud» («48.8924, 2.2369», copiadas de Google Maps con un clic derecho);
- Pasar por (opcional): por defecto Mapbox sigue el camino más rápido.
Para seguir su camino, indique uno o varios lugares de paso, en orden,
separados por
;(hasta 3): un puente, una ciudad, un punto de la carretera que toma… Por ejemploPont de Normandie; 49.4431, 0.3601. Elija puntos sobre la carretera deseada (no al lado), o Mapbox dará un rodeo para alcanzarlos. No cuesta ninguna solicitud adicional.
- Haga clic en Probar Mapbox: la duración actual del trayecto 1 aparece bajo el botón.
- Abra la pestaña Descubrimiento y añada sus trayectos.
Actualización
- Intervalo: 300 s por defecto (60 s como mínimo).
- Días activos / Horas activas: consultar Mapbox solo cuando importa,
por ejemplo de lunes a viernes,
07:00-09:30, 16:30-19:00. Vacío significa siempre. Las horas se leen en la zona horaria configurada (Europe/Parispor defecto). - Evitar: peajes, autopistas, ferris.
Plan gratuito de Mapbox
La API Directions incluye 100 000 solicitudes gratuitas al mes; por encima, Mapbox factura las solicitudes adicionales (consulte los precios de Mapbox). La integración hace una solicitud por trayecto en cada actualización y geocodifica cada dirección una sola vez. Consumo mensual ≈ trayectos × actualizaciones por hora × horas activas por día × días.
Por ejemplo, 3 trayectos actualizados cada 5 minutos durante 5 horas cada día laborable consumen unas 4000 solicitudes al mes, y unas 26 000 si se actualizan todo el día: ambos casos quedan dentro del plan gratuito. Actualizar 3 trayectos cada minuto, 24 h/24, consume unas 130 000 solicitudes y lo supera.
Su consumo real se muestra en su cuenta de Mapbox.
Alertas
- Atasco: al menos el 10 % (configurable) de la distancia tiene tráfico denso según Mapbox, o el trayecto es claramente más largo de lo habitual (+35 %).
- Anormalmente largo: la duración supera la habitual en un 30 % y en al menos 5 minutos (ambos configurables), de modo que un trayecto corto que pasa de 4 a 6 minutos no genera alerta.
Ejemplos de escenas
- Alerta de atasco: disparador Atasco en un trayecto (trayecto
«Trabajo»), acción «Enviar un mensaje»:
Atasco hacia el trabajo: {{triggerEvent.data.summary}}. - Resumen matinal: a las 7 h los días laborables, acción Obtener la duración de un trayecto, y después «Enviar un mensaje» con la variable Resumen (o Duración del trayecto (min)) producida por la acción anterior.
- Umbral personal: el trayecto es un dispositivo estándar de Gladys, así que el disparador nativo «Valor de un dispositivo» también funciona: «cuando Duración del trayecto (Trabajo) > 45».
Los disparadores de eventos solo se activan con un cambio (un único «Atasco» mientras dura el atasco).
Solución de problemas
- «Mapbox refused the access token»: compruebe el token en account.mapbox.com.
- Dirección no encontrada: use una dirección más completa, o unas coordenadas.
- «the home has no location»: defina la ubicación de la casa en Gladys, o rellene el origen.
- Los registros de la integración (pestaña Registros, o
docker logs) detallan cada actualización; definaLOG_LEVEL=debugpara ver las solicitudes (el token queda oculto).
Parámetros de configuración
Estos son los parámetros que Mapbox Traffic te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Cuenta de Mapbox | section | No | Cree una cuenta gratuita de Mapbox y copie su token de acceso público predeterminado (empieza por pk.). |
| Plan gratuito de Mapbox | section | No | La API Directions incluye 100 000 solicitudes gratuitas al mes; por encima, Mapbox factura las solicitudes adicionales. Esta integración hace una solicitud por trayecto en cada actualización (las direcciones solo se geocodifican una vez). Consumo mensual ≈ trayectos × actualizaciones por hora × horas activas por día × días. Ejemplos: 3 trayectos cada 5 min, 5 h por día laborable ≈ 4000 solicitudes (gratis); 3 trayectos cada 5 min, 24 h/24 ≈ 26 000 (gratis); 3 trayectos cada minuto, 24 h/24 ≈ 130 000 (por encima del plan gratuito). Use los días y horas activos de abajo para quedarse holgadamente dentro. |
| Token de acceso de Mapbox | secret | Sí | |
| Idioma de los textos | select | No | |
| Trayecto 1 | section | No | Un lugar es una dirección («10 rue de Rivoli, Paris») o unas coordenadas «latitud, longitud» («48.8566, 2.3522», copiadas de Google Maps). Deje el origen vacío para salir de la ubicación de la casa definida en Gladys. Deje el destino vacío para desactivar el trayecto. Para tomar otro camino que el más rápido, indique lugares de paso (un puente, una ciudad, una carretera). |
| Nombre | string | No | |
| Origen (déjelo vacío para salir de su casa) | string | No | |
| Pasar por (opcional) | string | No | Obliga a pasar por estos lugares, en orden, en lugar del camino más rápido. Hasta 3 lugares separados por «;». |
| Destino | string | Sí | |
| Trayecto 2 | section | No | Trayecto adicional opcional, mismo formato que el trayecto 1. |
| Nombre | string | No | |
| Origen (déjelo vacío para salir de su casa) | string | No | |
| Pasar por (opcional) | string | No | Obliga a pasar por estos lugares, en orden, en lugar del camino más rápido. Hasta 3 lugares separados por «;». |
| Destino | string | No | |
| Trayecto 3 | section | No | Trayecto adicional opcional, mismo formato que el trayecto 1. |
| Nombre | string | No | |
| Origen (déjelo vacío para salir de su casa) | string | No | |
| Pasar por (opcional) | string | No | Obliga a pasar por estos lugares, en orden, en lugar del camino más rápido. Hasta 3 lugares separados por «;». |
| Destino | string | No | |
| Actualización | section | No | Los trayectos solo se actualizan durante los días y horas activos, para ahorrar su cuota de Mapbox. Déjelos vacíos para actualizar todo el tiempo. |
| Intervalo de actualización (s) | number | No | |
| Días activos (vacío = todos los días) | multi_select | No | |
| Horas activas (vacío = todo el día) | string | No | |
| Zona horaria | string | No | |
| Evitar | multi_select | No | |
| Alertas | section | No | Se detecta un atasco cuando al menos la parte indicada del trayecto tiene tráfico denso. La duración es anormalmente larga cuando supera la habitual tanto en el porcentaje como en el número de minutos indicados. Ambos activan escenas. |
| Atasco: parte congestionada del trayecto (%) | number | No | |
| Anormal: más largo de lo habitual en (%) | number | No | |
| Anormal: y al menos (min) de retraso | number | No |
Cómo instalar Mapbox Traffic en Gladys
- En Gladys, abre Integraciones: Mapbox Traffic 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/quentinlegay/gladys-mapbox-traffic:1.1.2), 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/quentinlegay/Gladys-mapbox-traffic.
Mapbox Traffic requiere Gladys >=5.1.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
Mapbox Traffic 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 quentinlegay, 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