Integración domótica HERE Travel Time, gratuita y de código abierto
Tiempos de trayecto con tráfico de HERE: coche, camión, transporte, retraso.
Publicado por William-De71
- Dispositivos
- Versión 0.1.0
- Requiere Gladys >=5.3.0
- ★ 0
Presentación
Esta integración sigue sus trayectos habituales — casa-trabajo, colegio, aeropuerto — con los tiempos de trayecto de HERE. Para cada trayecto da la duración con tráfico en tiempo real, el retraso por el tráfico, la distancia y las carreteras principales, o las líneas y horarios en transporte público, y puede iniciar sus escenas cuando el tráfico empeora o la ruta cambia.
- Cada trayecto se convierte en un dispositivo: duración, duración sin tráfico y retraso por tráfico (coche, camión, scooter / moto), distancia, carreteras principales o líneas.
- Seis modos de transporte: coche (con o sin tráfico en tiempo real), camión, scooter / moto, bicicleta, a pie, transporte público (líneas, transbordos, primera salida, retraso en tiempo real).
- Los trayectos solo se miden en sus días y horas, para que las solicitudes se queden en el uso mensual gratuito de HERE.
- Disparadores de escena: la ruta de un trayecto cambia, el presupuesto del mes está casi gastado, HERE rechaza la clave de API. Acciones de escena: calcular una ruta ahora, medir un trayecto ahora.
- Tres widgets de panel: los tiempos de trayecto, un trayecto, las solicitudes del mes.
La imagen de arriba es una ilustración generada, no una captura de pantalla. Sin relación con HERE; todavía no probada con una clave de API real.
Requisitos previos
- Gladys Assistant 5.3.0 o posterior.
- Una clave de API de HERE (gratuita dentro del uso mensual de abajo):
- Cree una cuenta en platform.here.com («Sign up»). Las cuentas nuevas están en el plan Base: HERE pide un método de pago al registrarse y solo factura lo que supera el uso gratuito.
- Abra el Access Manager desde el lanzador (arriba a la derecha), pestaña Apps, y luego Register new app; dele un nombre («Gladys») y confirme con Register.
- En la aplicación, pestaña Credentials, elija API Keys y luego Create API key, y copie la clave (dos claves como máximo por aplicación).
- La zona horaria de Gladys bien configurada (Ajustes > Sistema): las horas de los trayectos se leen en ella.
- Para usar «casa» como lugar: la ubicación de su casa configurada en Ajustes > Casas. Para ello, la integración pide el permiso de ubicación al instalarla.
Coste. HERE cuenta una transacción por solicitud y da cada mes, en el plan Base, un uso gratuito por tipo de solicitud (precios de HERE, consultados el 26 de octubre de 2026):
| Tipo de solicitud | Gratis al mes | Después, por 1000 |
|---|---|---|
| Coche con tráfico («Time-aware routing») | 5000 | 2,92 USD |
| Coche sin tráfico, bicicleta, a pie («Routing») | 30 000 | 0,88 USD |
| Camión | 5000 | 2,92 USD |
| Scooter / moto | 5000 | 2,92 USD |
| Transporte público | 5000 | 2,92 USD |
| Geocodificación (una dirección a coordenadas, una vez) | 30 000 | 0,88 USD |
Un trayecto en coche medido cada 15 minutos de 6:00 a 21:00, de lunes a viernes, gasta unas 1300 solicitudes al mes. Por defecto, la integración se queda bajo el 90 % de cada uso gratuito y mide con menos frecuencia antes que superarlo. El uso gratuito pertenece a la cuenta HERE: las otras aplicaciones de la cuenta también cuentan.
Configuración
Los trayectos no se escriben en JSON: cada uno es un pequeño formulario, tras los botones al final de la página de configuración.
| Campo o botón | Descripción |
|---|---|
| Clave de API de HERE | Obligatoria. Gladys la guarda en secreto, nunca se vuelve a mostrar ni se escribe en los registros. |
| Intervalo por defecto | Minutos entre dos medidas de un trayecto sin intervalo propio (5 a 240, 15 por defecto). |
| Umbral de retraso por defecto | Retraso por tráfico, en minutos, a partir del cual un trayecto se muestra en rojo en los widgets (naranja desde 3 minutos). 10 por defecto. |
| Presupuesto mensual | Parte del uso gratuito de cada tipo de solicitud que la integración puede gastar. 90 por defecto; por encima de 100, HERE factura las solicitudes adicionales. |
| Idioma de los textos | Nombres de las funciones, textos de ruta, resúmenes de escenas, mensajes de los botones, idioma pedido a HERE. Elíjalo antes de añadir sus dispositivos: un dispositivo conserva los nombres de su creación. |
| Añadir un trayecto | Nombre, origen, destino, modo de transporte, tráfico en tiempo real (coche), evitar peajes / autopistas / ferris, días, horas («6-10, 16-20», vacío: 6-21), intervalo y umbral propios. Los lugares se comprueban al momento. |
| Modificar un trayecto | El trayecto por su nombre o número (#2); solo cambian los campos rellenados. 0 devuelve el intervalo o el umbral al valor por defecto. |
| Eliminar un trayecto | El trayecto por su nombre o número. Su dispositivo permanece en Gladys hasta que lo elimine. |
| Listar los trayectos | Cada trayecto con su horario, las solicitudes que prevé, su última medida y su último error, y las solicitudes del mes. |
| Probar la clave de API | Calcula un breve paseo en París a partir de coordenadas (una solicitud «Rutas») y dice qué corregir cuando HERE rechaza la clave. |
Origen y destino aceptan:
- una dirección o un nombre de lugar («Estación de Atocha, Madrid»): HERE la convierte en coordenadas una sola vez (una solicitud de geocodificación) y luego la integración las guarda;
- coordenadas «latitud, longitud», como
40.4065, -3.6895(sin geocodificación); - casa (o
home,hogar,maison,domicile,zuhause): la primera casa de Gladys con ubicación; - @nombre: la casa de Gladys con ese nombre, como
@Chalet.
Uso
Trayectos
- Pegue la clave de API y pulse Probar la clave de API.
- Pulse Añadir un trayecto para cada trayecto habitual. La respuesta muestra los lugares tal como HERE los entendió: compruébelos. Por defecto, un trayecto en coche se mide entre semana de 6:00 a 21:00 cada 15 minutos: ajuste los días y las horas.
- La primera medida llega en un minuto si el trayecto está en sus horas. Fuera de sus horas, el trayecto conserva su última medida.
Un trayecto en coche usa el tráfico en tiempo real por defecto. Desactive Tráfico en tiempo real (coche) para un trayecto cuyo retraso no importe: entonces cuenta en las 30 000 solicitudes «Rutas» gratuitas en lugar de las 5000 «Rutas con tráfico». Un trayecto en scooter / moto usa autopistas salvo que Evitar autopistas esté marcado.
Dispositivos
Abra la pestaña Descubrir y añada los trayectos que quiera. Cada dispositivo tiene:
- Duración con tráfico (minutos; «Duración» sin tráfico en tiempo real). En transporte público: de puerta a puerta, desde la primera salida a pie hasta la llegada, esperas incluidas;
- Duración sin tráfico y Retraso por tráfico (minutos; trayectos con tráfico en tiempo real);
- Distancia (km) y Ruta: las carreteras principales (como «A-6, M-30»), o en transporte público las líneas y los horarios (como «Bus C1 → Métro B · 07:49–08:16»).
Los valores siguen las medidas del trayecto; Gladys guarda su historial.
Widgets de panel
- Tiempos de trayecto: los trayectos con duración, distancia y carreteras o líneas, una insignia de retraso (verde, naranja desde 3 minutos, rojo desde el umbral del trayecto; en transporte público, la hora de la primera salida o el retraso anunciado en tiempo real), un enlace a la ruta en HERE WeGo y Actualizar todo.
- Trayecto: un trayecto, elegido entre los dispositivos: hasta cuatro mosaicos, ruta, horarios en transporte público, última medida, Actualizar.
- Solicitudes HERE: un indicador por tipo de solicitud usado (cinco como máximo), lo que prevén los trayectos al mes, el estado de la clave.
Un botón de actualización gasta una solicitud por trayecto, ninguna para un trayecto medido hace menos de un minuto.
Escenas
Disparadores de la integración:
- La ruta de un trayecto cambia: en una medida programada, la ruta más rápida pasa por otras carreteras (u otras líneas) que en la anterior. Variables: nombre, ruta, ruta anterior, duración, retraso, distancia, frase de resumen.
- El presupuesto mensual está casi gastado: un tipo de solicitud alcanza el 80 % y luego el 100 % de su presupuesto (una vez cada uno al mes).
- HERE rechaza la clave de API: una vez, hasta que una solicitud vuelva a funcionar; el resumen dice qué corregir.
Para un umbral («el retraso supera 10 minutos», «la duración supera 40 minutos»), use el disparador de dispositivo de Gladys sobre la función del trayecto.
Acciones: Calcular una ruta (dos lugares cualesquiera, ahora) y Medir un trayecto ahora (también fuera de sus horas). Ambas devuelven la duración, la duración sin tráfico, el retraso, la distancia, la ruta, las horas de salida y llegada y una frase como «Trabajo: 38 min, 14 min de tráfico, 11,8 km por M6, A6.» para enviar en un mensaje.
Ejemplos:
- Cuando el retraso de «Trabajo» supera 10 minutos → enviar el resumen del trayecto.
- Cada día laborable a las 7:15 → medir «Oficina (bus)» ahora → enviar
{{0.0.summary}}(líneas, primera salida, transbordos, retraso) a la familia. - Cuando la ruta de «Aeropuerto» cambia → enviar un mensaje: accidente o carretera cortada en el camino habitual.
Transporte
La integración usa los servidores de HERE (nube): las coordenadas de sus trayectos se envían a HERE en cada medida, y una dirección una vez al geocodificarla, con su clave de API en la solicitud. Los trayectos se guardan en la configuración de Gladys; las últimas medidas, el contador de solicitudes y las direcciones geocodificadas, en el volumen /data de la integración.
Solución de problemas
- «HERE rechaza la clave de API»:
API_KEY_INVALID— copie de nuevo la clave desde la pestaña Credentials de la aplicación (una clave eliminada o desactivada también se rechaza);API_KEY_MISSING— ninguna clave llegó a HERE;FORBIDDEN— la clave es válida pero no puede usar el servicio: compruebe que la cuenta está en el plan Base (método de pago introducido) y que la aplicación está activa. La integración vuelve a intentarlo cada hora, y al momento tras Probar la clave de API o una clave nueva. - «HERE no conoce la dirección»: añada la ciudad y el país, o escriba coordenadas.
- Un trayecto no tiene medida: compruebe sus días y horas con Listar los trayectos (la zona horaria mostrada debe ser la suya) y su último error.
noRouteFound,couldNotMatchOrigin,couldNotMatchDestination: ninguna carretera para este modo cerca de un lugar (ponga el punto en una calle);noCoverage,noStationsFound: sin datos de transporte público alrededor de los lugares. - Medidas menos frecuentes que el intervalo: «alargado … para no salir del presupuesto» en Listar los trayectos significa que los trayectos de ese tipo de solicitud prevén más que el presupuesto; reduzca las horas, los trayectos o el intervalo, o aumente el presupuesto.
- «Se han usado las solicitudes del mes»: se alcanzó el presupuesto de ese tipo de solicitud; los trayectos afectados esperan al mes siguiente (UTC). El recuento de HERE en platform.here.com es la referencia.
- 429: HERE limita las solicitudes de la clave; la integración espera 15 minutos.
- Para informar de un problema, indique las versiones de Gladys y de la integración, el texto de Listar los trayectos (oculte sus direcciones si quiere) y los registros de la integración (Ajustes → Supervisión). Nunca pegue su clave de API.
Parámetros de configuración
Estos son los parámetros que HERE Travel Time te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| HERE Travel Time | section | No | Cómo funciona: 1. Cree una cuenta gratuita en platform.here.com (plan Base: se pide un método de pago, el uso gratuito no se factura), registre una aplicación en el Access Manager, cree una clave de API en su pestaña Credentials y péguela abajo. 2. Declare cada trayecto con «Añadir un trayecto»: origen, destino, modo, días y horas. 3. En la pestaña Descubrir, añada el trayecto: se convierte en un dispositivo (duración, retraso, distancia, ruta). 4. Añada los widgets y use las escenas. Coste: una solicitud por medida. Gratis cada mes: 5000 en coche con tráfico, camión, scooter y transporte público; 30 000 en coche sin tráfico, bicicleta y a pie; 30 000 geocodificaciones (una vez por dirección). Por defecto la integración se queda bajo el 90 % y alarga los intervalos. Los lugares se envían a HERE. |
| Clave de API de HERE | secret | Sí | Una clave de API de una aplicación de su cuenta de la plataforma HERE (Access Manager → Apps → su aplicación → Credentials → API Keys). Solo se envía a HERE y nunca se vuelve a mostrar. |
| Intervalo por defecto (minutos) | number | No | Con qué frecuencia se mide un trayecto sin intervalo propio, dentro de sus horas (5 a 240). |
| Umbral de retraso por defecto (minutos) | number | No | A partir de este retraso, un trayecto sin umbral propio se muestra en rojo en los widgets (naranja desde 3 minutos). |
| Presupuesto mensual (% del uso gratuito) | number | No | Parte del uso mensual gratuito de cada tipo de solicitud que la integración puede gastar: 90 deja un margen (HERE cuenta también las otras aplicaciones de la cuenta). Por encima de 100, HERE factura las solicitudes adicionales. |
| Idioma de los textos | select | No | Nombres de las funciones, textos de ruta, resúmenes de escenas, mensajes de los botones e idioma pedido a HERE. Automático: el idioma de su panel en cuanto se haya mostrado un widget, deducido de la zona horaria de Gladys antes de eso. |
Cómo instalar HERE Travel Time en Gladys
- En Gladys, abre Integraciones: HERE Travel Time 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/william-de71/gladys-here-travel-time:0.1.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/William-De71/gladys-here-travel-time.
HERE Travel Time 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
HERE Travel Time 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 William-De71, 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