Update Trip Tracking - Documentação DEVMOB

curl --request POST \ --url https://api.example.com/api/v1/driver/trips/{tripId}/tracking \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "latitude": -23.55052, "longitude": -46.63331, "source": "DRIVER_APP_BACKGROUND", "accuracyMeters": 12, "speedKmh": 42.7, "headingDegrees": 126.4, "recordedAt": "2026-07-04T08:15:08.000Z" } '

{ "tripTrackingId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "tripId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "driverId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "latitude": 123, "longitude": 123, "accuracyMeters": 123, "speedKmh": 123, "headingDegrees": 123, "recordedAt": "2023-11-07T05:31:56Z", "acceptedAt": "2023-11-07T05:31:56Z", "createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "createdAt": "2023-11-07T05:31:56Z", "updatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "updatedAt": "2023-11-07T05:31:56Z" }

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

Último ping GPS aceito de uma viagem

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