Estimated Time of Arrival (ETA)
The Estimated Time of Arrival (ETA) is calculated by Track & Trace every few minutes based on incomplete and active orders on the route. The estimate is based on current traffic and road condition data.
Warning
Required conditions for calculating the ETA:
- The courier's coordinates have been received.
- The courier follows the route according to the delivery sequence.
The ETA affects:
- When SMS notifications are sent to clients (for more information, see Setting up SMS notifications).
- The logic of generating events in the order notification API.
The ETA calculation method affects the notification creation time.
Viewing the ETA
Logistics coordinators
In Routing workspace, the ETA can be found on multiple pages:
- Go to Track & Trace → Dashboard and select a route.
- Scroll down to the table with orders and find the Time on site column.
Note
The route page also shows when the ETA was calculated.
- Go to Track & Trace → Orders.
- Scroll the order table to the right to the Expected delivery time column.
- Go to Reports → Courier performance report.
- Scroll the report table to the right to the Order delivered (or canceled) column.
Clients
Clients can find the ETA in the widget by following the URL in the format https://yandex.ru/courier/tracking/<track ID>
. For more information, see Client widget.
Calculation specifics
-
If the route's starting point isn't the depot, the ETA for the route locations (depots, garages, or orders) won't be calculated.
-
ETA for the following route locations is calculated only after visiting the previous location.
Examples
-
The courier must visit Depots 1, 2, and 3 in sequence, and then deliver several orders. ETA for orders will start to be calculated when the courier marks Depot 3 as visited and leaves it.
-
Route locations have the following sequence: Depot 1 — Order group 1 — Depot 2 — Order group 2 — Depot 3 — Order group 3. ETAs for the first group of orders are calculated after the first depot is visited. There will be no calculated values for the second and third groups of orders: they'll appear after the courier visits the second and third depots.
-
-
If the route includes intermediate depots, ETAs for locations are calculated based on the travel time between the last visited depot and the next one.
Example
The courier starts the route at Depot 1, delivering a portion of the orders. The courier then proceeds to an intermediate depot and delivers the remaining orders. At the end of the route, the courier returns to Depot 1. ETAs for the first portion of orders are calculated between the visit to Depot 1 and arrival at the intermediate depot. ETAs for the second portion of orders are calculated after a stop at the intermediate depot.
-
If the courier deviates from the planned sequence of visiting locations, ETAs will no longer be calculated for the entire route.
Using the API
You can get the order ETA by sending a request to the order-info resource.