Настройка передачи данных c устройств

Для работы с API Мониторинга курьер должен передавать данные о статусе заказов и текущем местоположении.

В API реализована поддержка передачи данных через приложение или через GPS-трекер.

Через приложение

Фактические данные с мобильного приложения Яндекс Маршрутизация поступают в сервис автоматически после выбора маршрута.

Включение доступа у курьеров

Чтобы предоставить доступ курьерам к приложению Яндекс Маршрутизация:

Перейдите в интерфейс Рабочего места логиста, авторизовавшись с помощью учетной записи компании.
В меню слева выберите Настройки → Мобильное приложение.
Добавьте номера телефонов курьеров в формате +7**********.

Инструкции по мобильным приложениям доступны в соответствующей документации приложения Яндекс Маршрутизация.

Через GPS-трекер

Поступление фактических данных с GPS-трекера поддерживается в протоколах:

ERA GLONASS Telematics Standard (EGTS), приказ МинТранс №285;
FLEX;
Wialon Retranslator.

Данные с GPS-трекера должны передаваться в онлайн-режиме.

Требования к конфигурации

Протокол	EGTS	FLEX	Wialon Retranslator
Адрес сервера	egts.yandex.net	b2bgeo-flex-proxy.maps.yandex.net	telematics-proxy.routeq.yandex.net
TCP-порт	4000	6000	20332
Идентификатор устройства	Номер, заданный владельцем устройства	Номер, заданный владельцем устройства	IMEI
Пакет EGTS_SR_TERM_IDENTITY	Обязателен, должен включать IMEI-номер. Предназначен для идентификации устройства	—	—
Пакет EGTS_SR_POS_DATA	Содержит поле FLG, необходимое для указания дополнительных параметров навигационной посылки. В него входит бит VLD, который указывает на валидность координатных данных. Данные считаются валидными, если при их передаче бит VLD равен единице	—	—
Новая сессия для каждого пакета	Опциональная настройка, которая должна быть отключена при настройке ретрансляции	—	—
Частота отсылки местоположения, в движении	Каждые 20 секунд	Каждые 20 секунд	Каждые 20 секунд
Частота отсылки местоположения, при стоянке	Каждые 120 секунд	Каждые 120 секунд	Каждые 120 секунд
Максимальная задержка отправления позиции	1 сутки	1 сутки	1 сутки

При работе через протокол EGTS Яндекс Маршрутизация поддерживает сервисы EGTS_AUTH_SERVICE и EGTS_TELEDATA_SERVICE. Другие сервисы не поддерживаются, так как они не предназначены для отправки координат.

Настройки конфигурации и идентификация устройства

Настройки конфигурации задаются в параметрах GPS-трекера или в системе GPS-провайдера.

Если данные о местоположении устройства не передаются в течение 1 минуты, сервис закроет соединение с GPS-трекером. Сообщения о местоположении со временем, отстающим от текущего времени более чем на одни сутки, будут игнорироваться системой.

Для идентификации устройства могут использоваться уникальные значения:

Уникальный номер	Определение	Комментарий
Идентификатор терминала	Число, заданное владельцем устройства, которое передается в служебных данных протокола	Чтобы не привязывать идентификатор терминала к IMEI-номеру, рекомендуем указывать IMEI-номер при планировании.
IMEI	Номер, состоящий из 15-17 цифр	Из 15-17 цифр IMEI-номера по протоколу EGTS будут передаваться только последние 8-10 цифр.
TID	Номер, указанный в документации устройства	TID считается равным IMEI-номеру, если по протоколу EGTS не присылался пакет `EGTS_SR_TERM_IDENTITY`, в котором устанавливается соответствие TID-IMEI. Авторизация не поддерживается.

Важно

Идентификатор терминала, IMEI и TID — это разные числа.

В API можно использовать только числовые идентификаторы и IMEI-номера.

Как проверить передачу данных

Вы можете проверить поступление данных от GPS-трекера одним из способов:

в интерфейсе Рабочего места логиста. Подробнее см. в разделе GPS-трекеры;
через API:

Отправьте POST-запрос к ресурсу gps-trackers/status. В теле запроса укажите ID компании и один или несколько IMEI-номеров GPS-трекеров.

Запрос

cURL
```
curl -H "Authorization: OAuth <ваш-токен>" \
     -H "Content-Type: application/json" \
     -X POST https://courier.yandex.ru/api/v1/companies/gps-trackers/status \
     -d '{
           "company_id": <ID-вашей-компании>,
           "imeis": [123456789012345, 987654321098765]
         }'
```
Результат

Метод возвращает массив объектов. Каждый объект соответствует одному GPS-трекеру и содержит поля:
- imei — номер GPS-трекера;
- imei_str — номер GPS-трекера в строковом формате;
- time — дата и время последней известной позиции курьера в формате ISO 8601.
Пример ответа:
```
[
  {
    "imei": 123456789012345,
    "imei_str": "123456789012345",
    "time": "2026-07-24T10:30:00.000Z"
  }
]
```
Если данные с трекера не передавались, трекер не будет включен в ответ.

Если настроить передачу данных через GPS-трекер не получилось, напишите в службу поддержки.

Написать в службу поддержки

Была ли статья полезна?

Формирование маршрутов на день

Предоставление доступа