Saltar al contenido principal

Servicios de Posiciones y Viajes

Esta página explica cómo recuperar posiciones de vehículos e historial de viajes con la Fleet API para audiencias de negocio y técnicas.

Acrónimos y Términos​

  • API: Interfaz de Programación de Aplicaciones.
  • GPS: Sistema de Posicionamiento Global.

¿Qué Endpoint Debo Usar?​

Usa este mapeo cuando los clientes pidan datos relacionados con ubicación:

1) Todas las Posiciones GPS​

Qué Significa​

Recuperar eventos históricos de posición durante un periodo para reconstruir por dónde ha estado un vehículo.

Mejores Endpoints​

Interpretación de Negocio​

  • Úsalo para investigaciones, replay de viajes, prueba de presencia y auditorías operativas.
  • Es la mejor fuente cuando los usuarios piden "todos los puntos" dentro de una ventana de tiempo.

Interpretación para Developers​

  • Trata los eventos como puntos de telemetría histórica.
  • Consulta por ventanas de tiempo y pagina según sea necesario.
  • Para periodos largos, recupera en bloques para evitar respuestas demasiado grandes.

2) Tracking Continuo (Tiempo Casi Real)​

Qué Significa​

Mostrar continuamente las últimas posiciones conocidas de los vehículos, similar a un mapa de flota en vivo.

Mejor Endpoint​

Interpretación de Negocio​

  • Úsalo para operación diaria en vivo y monitoreo de despacho.
  • Es ideal para casos de uso de "¿dónde está el vehículo ahora?".

Interpretación para Developers​

  • Implementa polling (por ejemplo, cada 10 a 30 segundos) para actualizar estados recientes.
  • Esto es polling de estado en tiempo casi real, no un stream websocket.
  • Combínalo con endpoints de events cuando se requiera detalle histórico tipo breadcrumb.

3) Historial Completo de Viajes​

Qué Significa​

Según la intención del cliente, "historial de viaje" puede significar:

  • Puntos breadcrumb completos de un trayecto, o
  • Resúmenes de viaje con ubicación de inicio y fin.

Selección de Endpoint​

Interpretación de Negocio​

  • Usa trips para reportes y análisis de KPI a nivel de viaje.
  • Usa events cuando los analistas necesiten detalle a nivel de trayectoria.

Interpretación para Developers​

  • Los trips son registros de resumen y no deben tratarse como datasets completos de puntos de ruta.
  • Construye el replay completo de rutas a partir de datos de events para el intervalo de tiempo seleccionado.

Patrón de Implementación Recomendado​

Para la mayoría de aplicaciones de flota:

  1. Haz polling del endpoint de estado de vehículos para obtener el estado actual del mapa.
  2. Consulta endpoints de events para replay histórico de rutas.
  3. Consulta endpoints de trips para reportes de viaje (inicio/fin y contexto del viaje).