Setting up data transfer from devices
The Track & Trace API relies on couriers sending their order status and current location data.
The API supports sending data through the app or GPS tracker.
App
The actual data from the Yandex Courier mobile app is sent automatically after the route is selected.
Enabling access for couriers
To grant couriers access to the Yandex Courier app:
- Log in to your company account and go to Routing Workspace.
- In the menu on the left, go to Settings → Mobile app.
- Add the couriers' phone numbers in
+1**********format.
Instructions and a video tutorial for using the app are available in the Yandex Courier section.
GPS tracker
Sending actual data from the GPS tracker is possible using the ERA GLONASS Telematics Standard pursuant to order No. 285 (EGTS) of the Russian Ministry of Transport, or the FLEX protocol. Data from the GPS tracker must be sent in real time.
Configuration requirements:
|
Protocol |
EGTS |
FLEX |
|
Server address |
egts.yandex.net |
b2bgeo-flex-proxy.maps.yandex.net |
|
TCP port |
4000 |
6000 |
|
Device ID |
Number set by the device owner |
Number set by the device owner |
|
EGTS_SR_TERM_IDENTITY package |
Required, must include the IMEI number. |
— |
|
EGTS_SR_POS_DATA package |
Contains the FLG field required to specify additional navigation parcel parameters. It includes the VLD bit that indicates the validity of coordinate data. Data is considered valid if the VLD bit is equal to one when data is transmitted. |
— |
|
Frequency of sending location data, in motion |
Every 20 seconds |
Every 20 seconds |
|
Frequency of sending location data, not in motion |
Every 120 seconds |
Every 120 seconds |
|
Maximum location data sending delay |
24 hours |
24 hours |
Notes:
- Configuration settings are specified in the parameters of the GPS tracker or in the GPS provider's system.
- Devices are identified by a terminal ID: a number set by the device owner and sent in the protocol service data. The API only supports numeric IDs and IMEIs. The IMEI number consists of 15–17 digits. To avoid linking the device ID to the IMEI number, we recommend specifying the IMEI number when planning.
- The device ID, TID, and GPRS module IMEI are different numbers.
- The system ignores location messages with a time delay of more than one day.
- For EGTS:
- The unique TID is specified in the device documentation. TID is considered equal to the IMEI number if the
EGTS_SR_TERM_IDENTITYpackage, which establishes the TID-IMEI link, was not sent. - Authorization not supported.
- The unique TID is specified in the device documentation. TID is considered equal to the IMEI number if the
How to check data transfer
You can verify that data from the GPS tracker has been received in the GPS trackers section.
If you couldn't set up the data transfer via the GPS tracker, contact support.