> ## 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.

# Datos en tiempo real

> Cómo obtener la posición más reciente de tus equipos y cuándo conviene consultar históricos.

La API entrega tanto el **último dato conocido** de cada equipo como los **históricos**.
La frescura del dato actual depende de la frecuencia de reporte del equipo GPS: la API
siempre devuelve lo último que el equipo transmitió.

## Posición y actividad actual

| Necesidad                                        | Operación                            |
| ------------------------------------------------ | ------------------------------------ |
| Última actividad y posición conocida de la flota | `POST /api/reports/last-activity`    |
| Estado de salud de un equipo                     | `GET /api/device-health/{trackerId}` |

## Históricos

| Necesidad                            | Operación                                    |
| ------------------------------------ | -------------------------------------------- |
| Posiciones históricas de un tracker  | `GET /api/trackers/{id}/positions`           |
| Detalle de posiciones por rango      | `POST /api/positions/detail`                 |
| Estadísticas de posiciones por rango | `POST /api/positions/stats`                  |
| Viajes, paradas y reportes           | ver la sección **Reportes** de la referencia |

## Integración por polling

Para mantener un sistema externo sincronizado, consultá periódicamente los endpoints de
actividad actual (**polling**). Recomendaciones:

* Ajustá el intervalo de consulta a la frecuencia real de reporte de tus equipos;
  consultar más seguido que lo que los equipos reportan no agrega información.
* Pedí rangos acotados en los endpoints históricos: son consultas más rápidas y baratas
  para ambos lados.

<Note>
  Hoy la API no ofrece webhooks ni un canal push para integradores — el detalle está en
  las [Preguntas frecuentes](/faq).
</Note>