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

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

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

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

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

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

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

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

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

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

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

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

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

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

Особенности конфигураций:

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

• При подключении через Wialon Retranslator передавайте идентификатор устройства в поле unit_id. Мониторинг использует это значение в качестве IMEI трекера — отдельное сопоставление идентификаторов не предусмотрено. На каждый успешно принятый и записанный пакет сервер отправляет подтверждение в виде одного байта со значением 0x11. Если подтверждение не получено, повторно отправьте пакет после восстановления соединения. Данное поведение является штатным для клиента Wialon.

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

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

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

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

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

Подготовка к ретрансляции данных через Wialon Retranslator

Перед началом ретрансляции убедитесь, что выполнены следующие условия:

• Устройство или платформа Мониторинга поддерживает передачу потока по протоколу Wialon Retranslator 1.0 (TCP push).
• В Мониторинге заведен GPS-трекер, поле IMEI которого строго соответствует передаваемому в пакетах значению unit_id. Если это условие не выполнено, координаты не будут отображаться в треке, даже при успешном подтверждении приема пакетов сервером.
• Для каждого датчика на активном маршруте в Мониторинге создан сенсор с известным sensor_number. Имя параметра в Wialon должно побайтно совпадать с sensor_number.

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

Вы можете проверить поступление данных от 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-трекер не получилось, напишите в службу поддержки.