Skip to main content
POST
Update Trip Tracking

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

tripId
string<uuid>
required

Trip identifier.

Query Parameters

fields
string

Comma-separated list of fields to include in the response. Supports dot notation.

Body

application/json

Trip tracking update payload.

latitude
number
required

Latitude.

Required range: -90 <= x <= 90
Example:

-23.55052

longitude
number
required

Longitude.

Required range: -180 <= x <= 180
Example:

-46.63331

source
enum<string>
required

Ping source.

Available options:
DRIVER_APP_FOREGROUND,
DRIVER_APP_BACKGROUND
Example:

"DRIVER_APP_BACKGROUND"

accuracyMeters
integer | null

Accuracy in meters.

Required range: x >= 0
Example:

12

speedKmh
number | null

Speed in km/h.

Required range: x >= 0
Example:

42.7

headingDegrees
number | null

Heading in degrees.

Required range: 0 <= x <= 360
Example:

126.4

recordedAt
string<date-time> | null

Device recorded time.

Example:

"2026-07-04T08:15:08.000Z"

Response

OK

Último ping GPS aceito de uma viagem. O histórico completo fica em TripTrackingPoint.

tripTrackingId
string<uuid>
required

Identificador único

tripId
string<uuid>
required

Referência única à viagem

driverId
string<uuid>
required

Referência ao motorista que enviou o último ping

latitude
number
required

Latitude do último ping aceito

longitude
number
required

Longitude do último ping aceito

accuracyMeters
integer | null
required

Precisão do último ping em metros

speedKmh
number | null
required

Velocidade reportada no último ping

headingDegrees
number | null
required

Direção reportada no último ping, em graus

source
enum<string>
required

Origem do último ping

Available options:
DRIVER_APP_FOREGROUND,
DRIVER_APP_BACKGROUND
recordedAt
string<date-time> | null
required

Data/hora do último ping informada pelo dispositivo

acceptedAt
string<date-time>
required

Data/hora em que o backend aceitou o último ping

createdBy
string<uuid> | null
required

Usuário que criou o registro, quando aplicável

createdAt
string<date-time>
required

Data de criação

updatedBy
string<uuid> | null
required

Usuário que atualizou o registro, quando aplicável

updatedAt
string<date-time>
required

Data da última atualização