Trip Interface Description 1.2.2 Help

ETA Message

An ETA message is generated when the Drivers App calculates the ETA for stop.

The Drivers App can calculate the ETA for the next stop in the trip. Currently, there are 2 triggers for calculating the ETA.

  1. Starting a trip -> This action triggers the ETA calculation of the first stop in the trip

  2. Finishing a stop -> This action triggers the ETA calculation of the first unfinished stop in the trip

The data field of an ETA message consists of the properties described below.

Property

Nullable

Type

Description

foreignId

false

string

Contains the foreignId of the entity as provided in the trip message sent to the app

flag

false

string

Contains the flag of the entity as provided in the trip message sent to the app

eta

false

string

The ETA as an ISO 8601 formatted string

etaMillis

false

long

The ETA as a Unix timestamp (milliseconds)

calculatedAt

false

string

The moment the ETA was calculated as an ISO 8601 formatted string

calculatedAtMillis

false

long

The moment the ETA was calculated as a Unix timestamp (milliseconds)

Example

The example below contain an ETA message.

{ "type": "ETA", "data": { "foreignId": "2651576", "flag": "stop", "eta": "2025-03-13T16:10:37.200Z", "etaMillis": 1741882237200, "calculatedAt": "2025-03-13T14:41:37.200Z", "calculatedAtMillis": 1741876897200 }, "location": { "latitude": 52.0212486, "longitude": 5.6512005, "speedMs": 0.5, "bearing": 154.4633 }, "origin": { "appId": 60000100, "deviceId": "358240051111110", "driverNumber": "1", "coDriverNumber": null }, "vehicle": { "licensePlate": "TE-ST-12", "odometer": 250000 }, "messageTime": "2025-03-13T14:41:37.249Z" }
Last modified: 22 July 2025