Skip to main content

Update GPS tracking position

POST 
/truckers/deliveries/tracking/:service_code

This endpoint registers the vehicle's current GPS position for an ongoing delivery and updates the tracking status.

Key Features:

  • Registers precise GPS coordinates (latitude, longitude)
  • Stores exact timestamp of the position (UTC)
  • Updates the carrier's last known position
  • Automatically associates the position with the specified delivery
  • Maintains position history for traceability

Primary Use Cases:

  • Real-time tracking during transportation
  • Generation of optimized routes based on current position
  • Dynamic estimated time of arrival (ETA) calculations
  • Geographic verification for loading/unloading processes
  • Fleet monitoring and asset management

Validations and Requirements:

  • Only works for deliveries in 'collected' status
  • GPS coordinates must be valid (lat: -90 to 90, lng: -180 to 180)
  • Timestamp must be current (no more than 5 minutes difference)
  • Maximum 1 update per minute to prevent spam

Example Flow:

  1. Mobile app obtains device GPS position
  2. Sends position to endpoint every 2-5 minutes
  3. System updates position and recalculates ETA
  4. Company can view position in real-time

Technical Notes:

  • Coordinates are stored in GeoJSON format
  • Timestamp is automatically converted to UTC
  • Old positions are archived after 30 days

Request​

Responses​

Position successfully registered.

Response Headers
    X-RateLimit-Remaining

    Number of remaining updates in the current period

    Example: 58