> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ugps.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Detección de viajes

> Cómo se arman los viajes y paradas que devuelven los reportes: perfiles de detección y sus umbrales.

Los viajes y las paradas no se calculan al pedir el reporte: la plataforma los genera en tiempo real a partir de los mensajes GPS de cada equipo, y la API los sirve ya construidos. Entender el perfil de detección del equipo evita la mayoría de las dudas al interpretar un reporte.

## Perfiles de detección

Cada equipo tiene un perfil de viaje, configurable en el panel de administración. El perfil define qué señal delimita un viaje y con qué umbrales:

| Perfil                  | Un viaje es…                                                      | Arranca                          | Termina                                  | Se descarta si dura menos de | Se corta si el equipo no reporta por |
| ----------------------- | ----------------------------------------------------------------- | -------------------------------- | ---------------------------------------- | ---------------------------- | ------------------------------------ |
| **Velocidad** (default) | Movimiento sostenido (más de 5 km/h)                              | Tras 10 s de movimiento continuo | Tras 5 min detenido                      | 30 s                         | 10 min                               |
| **Ignición**            | Una sesión con el motor encendido                                 | Al encender el motor             | Al apagar el motor, en el momento exacto | 60 s                         | 30 min                               |
| **Movimiento**          | Movimiento sostenido, para equipos satelitales de reporte esparso | Tras 60 s de movimiento continuo | Tras 5 min detenido                      | 60 s                         | 2 h                                  |

La diferencia clave está en el perfil **Ignición**: la velocidad no participa. Una máquina que trabaja en sitio con el motor encendido y velocidad 0 genera un único viaje que cubre toda la sesión de trabajo — el caso típico de maquinaria, generadores o equipos con toma de fuerza. En los perfiles por velocidad, ese mismo período aparecería como parqueo.

## Paradas

Las paradas son entidades propias, no huecos entre viajes:

* **Parada en viaje**: detención breve dentro de un viaje (semáforo, carga/descarga). Se registra si dura al menos 3 minutos.
* **Parqueo (parada entre viajes)**: el período completo entre el fin de un viaje y el inicio del siguiente. Se registra cuando la detención cumple 5 minutos, con inicio en el momento real de la detención. En equipos con perfil Ignición, el parqueo es exactamente el período con el motor apagado.

## Preguntas frecuentes al leer un reporte

* **«El viaje se partió en dos»** — hubo una detención mayor a la tolerancia del perfil, o el equipo estuvo sin reportar más que el umbral de corte (túnel, apagado, sin cobertura).
* **«El viaje no aparece»** — duró menos que el mínimo del perfil, o el movimiento no se sostuvo lo suficiente para arrancar el viaje.
* **«El parqueo aparece tarde»** — el registro se crea cuando la detención cumple 5 minutos, pero su inicio queda en la detención real.
* **«Cambié el perfil del equipo y el histórico cambió»** — los reportes muestran los viajes generados con el perfil **actual** del equipo. El perfil nuevo aplica solo hacia adelante; nada se recalcula retroactivamente.