Skip to main content

Actualizar posición GPS de seguimiento

POST 
/deliveries/tracking/:service_code

Este endpoint registra la posición GPS actual del vehículo para una entrega en curso y actualiza el estado de seguimiento.

Funcionalidades clave:

  • Registra coordenadas GPS precisas (latitud, longitud)
  • Almacena timestamp exacto de la posición (UTC)
  • Actualiza la última posición conocida del transportista
  • Asocia automáticamente la posición a la entrega especificada
  • Mantiene historial de posiciones para trazabilidad

Casos de uso principales:

  • Seguimiento en tiempo real durante el transporte
  • Generación de rutas optimizadas basadas en posición actual
  • Cálculo de tiempos estimados de llegada (ETA) dinámicos
  • Verificación geográfica para procesos de carga/descarga
  • Monitoreo de flota y gestión de activos

Validaciones y requisitos:

  • Solo funciona para entregas en estado 'collected'
  • Coordenadas GPS deben ser válidas (lat: -90 a 90, lng: -180 a 180)
  • Timestamp debe ser actual (no más de 5 minutos de diferencia)
  • Máximo 1 actualización por minuto para evitar spam

Ejemplo de flujo:

  1. App móvil obtiene posición GPS del dispositivo
  2. Envía posición al endpoint cada 2-5 minutos
  3. Sistema actualiza posición y recalcula ETA
  4. Empresa puede visualizar posición en tiempo real

Notas técnicas:

  • Las coordenadas se almacenan en formato GeoJSON
  • El timestamp se convierte automáticamente a UTC
  • Las posiciones antiguas se archivan después de 30 días

Request​

Responses​

Posición registrada correctamente

Response Headers
    X-RateLimit-Remaining

    Número de actualizaciones restantes en el período actual

    Example: 58