Integración domótica Traccar, gratuita y de código abierto
Sus rastreadores GPS Traccar en Gladys: zonas, presencia, velocidad, batería, alarmas.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Lleva a Gladys los rastreadores GPS de su servidor Traccar: teléfonos con la aplicación Traccar Client, rastreadores de coche, de mascota o de bicicleta — cualquiera de los cientos de modelos que admite Traccar. Cada rastreador se convierte en un dispositivo Gladys con su zona, velocidad, batería y distancia de casa; las escenas pueden reaccionar cuando un rastreador entra en una zona o sale de ella, se desconecta o lanza una alarma; un rastreador en casa puede gestionar la presencia de un usuario de Gladys.
Traccar es un servidor de seguimiento completo que usted aloja. Si solo necesita la presencia de un teléfono, la integración OwnTracks de Gladys es más ligera; Traccar es la opción adecuada si ya lo utiliza, o para seguir vehículos y rastreadores GPS.
Probada con un servidor Traccar 6.16 real y teléfonos simulados (protocolo OsmAnd), no con rastreadores GPS reales: sus comentarios son bienvenidos.
Requisitos previos
- Gladys 5.1 o posterior.
- Un servidor Traccar (versión 5 o posterior) al que Gladys pueda acceder en su red, normalmente en el puerto 8082.
- Un usuario de Traccar que vea los rastreadores. Basta con un usuario de solo lectura: la integración nunca modifica nada en Traccar.
Configuración
- En Traccar, abra Ajustes → Preferencias, luego la sección Token, y genere un token (con una fecha de caducidad lo bastante lejana). También puede usar en su lugar el correo electrónico y la contraseña de un usuario de Traccar.
- En Gladys, abra la pestaña Configuración de la integración:
- Dirección de Traccar: tal como la abre en su navegador, por ejemplo
http://192.168.1.20:8082. Sin puerto, se usa el 8082. - Token, o Correo y Contraseña.
- Dirección de Traccar: tal como la abre en su navegador, por ejemplo
- Guarde. El botón Probar la conexión muestra la versión de Traccar y cuántos rastreadores y geocercas ve.
- Abra la pestaña Descubrir y añada a Gladys los rastreadores que desee.
Casa y presencia (opcional):
- La casa es un radio (150 m por defecto) alrededor de la ubicación de su vivienda Gladys (Configuración → Viviendas). Con varias viviendas, indique el nombre de la que debe usarse; por defecto, la primera que tiene ubicación.
- O indique una geocerca de Traccar (por ejemplo
Casa): un rastreador está entonces en casa cuando se encuentra dentro, y el radio se ignora. - Presencia: última posición como máximo: un rastreador en casa solo sigue indicando «visto en casa» mientras su última posición tenga menos de esta antigüedad (30 minutos por defecto).
- Idioma: el idioma de los nombres de las funciones y de los textos que escribe la integración (zonas, estados, frases). Francés por defecto.
Dispositivos
Un dispositivo por rastreador de Traccar, con:
| Función | Lo que muestra |
|---|---|
| Estado | En línea, desconectado o desconocido, según Traccar |
| Última actualización | Fecha y hora del último mensaje recibido por Traccar |
| Zona | Las geocercas de Traccar donde está el rastreador, o «Fuera de zona» |
| Velocidad | En km/h |
| Batería | En %, si el rastreador la transmite |
| En movimiento | Sí o no, si Traccar lo calcula |
| Contacto | Encendido o apagado, para los rastreadores de vehículo que lo envían |
| Dirección | Solo si su servidor Traccar calcula las direcciones (geocodificador) |
| Distancia de casa | En km, hasta la vivienda Gladys |
| En casa | Sí o no, según la regla de la casa anterior |
| Presencia | Una señal «visto en casa» para la presencia de un usuario |
Batería, movimiento, contacto y dirección aparecen en cuanto el rastreador los transmite: si uno aparece más tarde, Gladys propone Actualizar el dispositivo en la pestaña Descubrir. La distancia requiere una vivienda Gladys con ubicación; En casa y Presencia requieren una casa (radio o geocerca).
Las actualizaciones son en directo: Traccar envía cada nueva posición a la integración por su WebSocket. Si el enlace se cae, la integración consulta Traccar cada 30 segundos hasta que vuelve: se recupera la última posición de cada rastreador, no las intermedias.
Presencia de un usuario
Gladys decide quién está en casa mediante escenas. Dos formas, que se combinan bien:
- Sencilla: una escena activada cuando la función En casa del rastreador pasa a 1, con la acción Usuario visto en casa; otra cuando pasa a 0, con Usuario fuera de casa.
- Robusta: la función Presencia envía una señal «visto en casa» en cada posición en casa, y luego cada 5 minutos mientras la última posición sea reciente. Una escena programada (cada 5 o 10 minutos) con la acción Comprobar presencia del usuario (el usuario, la vivienda, la función Presencia de su rastreador, un plazo como 15 minutos) marca al usuario como ausente cuando el teléfono no se ha visto en casa durante ese plazo — aunque se haya quedado sin batería en la oficina.
Las escenas «el usuario sale de casa» y «el usuario vuelve a casa» de Gladys funcionan entonces como de costumbre.
Widget del panel
El widget Rastreadores GPS lista cada rastreador (ocho como máximo) con su zona, la hora de su última posición y su estado como distintivo de color. Toque un rastreador para ver su dirección, velocidad, batería, distancia de casa y un enlace al mapa (OpenStreetMap).
Escenas
La integración añade al editor de escenas, en Integraciones:
Desencadenantes
- Un rastreador entra en una geocerca y Un rastreador sale de una geocerca: opcionalmente para un rastreador y una geocerca (su nombre exactamente como en Traccar; vacío, cualquiera). Las acciones siguientes pueden usar el nombre del rastreador, la geocerca, la dirección y un enlace al mapa.
- Un rastreador se desconecta: el rastreador deja de transmitir y Traccar lo marca como desconectado o desconocido (los teléfonos y rastreadores HTTP pasan a desconocido), tras el plazo ajustado en Traccar (10 minutos por defecto). Variables: nombre del rastreador, última actualización.
- Alarma de un rastreador: el rastreador señala una alarma (SOS, batería baja, exceso de velocidad, corte de alimentación, caída, manipulación, vibración, movimiento), opcionalmente de un solo tipo. Variables: nombre del rastreador, código y nombre de la alarma, enlace al mapa.
Estos desencadenantes proceden de las propias posiciones: no hay que crear ninguna notificación en Traccar. Solo los rastreadores añadidos a Gladys los activan.
Acción
- Leer la posición de un rastreador: devuelve una frase lista («Coche está en la zona Trabajo, a 4,1 km de casa, posición de 16:08.»), y el estado, la zona, la dirección, en casa (sí/no), la distancia de casa (km, -1 si se desconoce), la velocidad (km/h), la hora de la posición y un enlace al mapa, para las acciones siguientes.
Ejemplos de escenas
- Los niños han llegado: desencadenante «Un rastreador entra en una geocerca», rastreador «Teléfono Lea», geocerca «Casa» → enviar el mensaje «Lea ha llegado a casa».
- ¿Dónde está el coche? Desencadenante: un botón o un mensaje → acción «Leer la posición de un rastreador» (Coche) → enviar un mensaje con la frase y el enlace al mapa.
- SOS: desencadenante «Alarma de un rastreador», alarma «SOS» → enviar a todos un mensaje con el nombre del rastreador y el enlace al mapa, y encender las luces.
Solución de problemas
- «Traccar ha rechazado el token»: el token ha caducado o ha sido revocado; genere uno nuevo. Con correo y contraseña, compruébelos en la interfaz web de Traccar.
- «Traccar no responde»: compruebe la dirección (con el puerto) desde otro
dispositivo de la red, y que Traccar esté en marcha. La integración se
ejecuta en un contenedor:
localhostno es allí su servidor, use su dirección IP. - Sin distancia de casa: la vivienda Gladys no tiene ubicación (Configuración → Viviendas), o la integración se instaló sin el permiso de leer la ubicación de la vivienda.
- Un rastreador nunca «en casa»: compruebe el radio, o el nombre exacto de la geocerca de la casa; un teléfono en el interior puede dar una posición a algunas decenas de metros.
- El detalle está en los registros de la integración, con
LOG_LEVEL=debugpara cada mensaje. Las posiciones nunca se escriben en los registros en el nivel normal.
Limitaciones
- Sin mapa en el panel: el vocabulario de los widgets de Gladys no tiene; el mapa se abre en OpenStreetMap.
- Solo lectura: no se envía ninguna orden a los rastreadores.
- Los eventos propios de Traccar (exceso de velocidad calculado por el servidor a partir de un límite, mantenimiento, combustible) no son desencadenantes; las alarmas transmitidas por los rastreadores, sí.
- Los límites de velocidad, las geocercas y los estados son los de Traccar: modifíquelos allí.
Parámetros de configuración
Estos son los parámetros que Traccar te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conecte su servidor Traccar | section | No | Introduzca la dirección de Traccar tal como la abre en su navegador (puerto 8082 por defecto). Pegue después un token: en Traccar, abra Ajustes, Preferencias, Token, y genere uno. Basta con un usuario de Traccar de solo lectura. O introduzca en su lugar el correo electrónico y la contraseña de un usuario de Traccar. |
| Dirección de Traccar | string | Sí | |
| Token (recomendado) | secret | No | |
| O bien: correo de un usuario de Traccar | string | No | |
| Contraseña de este usuario | secret | No | |
| Casa y presencia | section | No | Un rastreador está en casa cuando se encuentra en el radio indicado abajo alrededor de la ubicación de su casa Gladys o, si indica una, dentro de esa geocerca de Traccar. Utilice su función En casa en escenas con «Usuario visto en casa» y «Usuario fuera de casa», o su función Presencia con «Comprobar presencia del usuario». |
| Casa Gladys (opcional) | string | No | |
| Radio de la casa (metros) | number | No | |
| O bien: geocerca de Traccar de la casa | string | No | |
| Presencia: última posición como máximo (minutos) | number | No | |
| Idioma de los nombres y textos | select | No |
Cómo instalar Traccar en Gladys
- En Gladys, abre Integraciones: Traccar 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-traccar: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-traccar.
Traccar 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
Traccar 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