--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/delivery/quickstart/data.md - https://yandex.kz/routing/doc/kk/delivery/quickstart/data.md - https://yandex.kz/routing/doc/ru/delivery/quickstart/data.md - href: kk/delivery/quickstart/data.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt title: Яндекс Маршрутизация — порядок внедрения API — настройка передачи данных с устройств --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/kk/llms.txt # Настройка передачи данных c устройств Для работы с API Мониторинга курьер должен передавать данные о статусе заказов и текущем местоположении. ## Через приложение {#app} Фактические данные с мобильного приложения Яндекс Маршрутизация поступают в сервис автоматически после выбора маршрута. ### Включение доступа у курьеров {#app-courier-access} Чтобы предоставить доступ курьерам к приложению Яндекс Маршрутизация: 1. Перейдите в интерфейс [Рабочего места логиста](https://yandex.kz/courier), авторизовавшись с помощью учетной записи компании. 2. В меню слева выберите **Настройки** → **Мобильное приложение**. 3. Добавьте номера телефонов курьеров в формате `+7**********`. Инструкции по мобильным приложениям доступны в соответствующей документации приложения [Яндекс Маршрутизация](https://yandex.kz/routing/doc/kk/rq-app/index.md). ## Через GPS-трекер {#gps} Поступление фактических данных с GPS-трекера поддерживается в протоколах: * ERA GLONASS Telematics Standard (EGTS), приказ МинТранс №285; * [FLEX](https://wiki.navtelecom.ru/ru/home/developers); * [Wialon Retranslator](https://help.wialon.com/ru/wialon-local/2504/user-guide/management-system/retranslators). Данные с GPS-трекера должны передаваться в онлайн-режиме. ### Требования к конфигурации {#gps-configuration} #| || **Протокол** | **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**. Другие сервисы не поддерживаются, так как они не предназначены для отправки координат. * При подключении через Wialon Retranslator передавайте идентификатор устройства в поле `unit_id`. Мониторинг использует это значение в качестве IMEI трекера — отдельное сопоставление идентификаторов не предусмотрено. На каждый успешно принятый и записанный пакет сервер отправляет подтверждение в виде одного байта со значением `0x11`. Если подтверждение не получено, повторно отправьте пакет после восстановления соединения. Данное поведение является штатным для клиента Wialon. ### Настройки конфигурации и идентификация устройства {#gps-configuration-settings} Настройки конфигурации задаются в параметрах GPS-трекера или в системе GPS-провайдера. Если данные о местоположении устройства не передаются в течение 1 минуты, сервис закроет соединение с GPS-трекером. Сообщения о местоположении со временем, отстающим от текущего времени более чем на одни сутки, будут игнорироваться системой. Для идентификации устройства могут использоваться уникальные значения: #| || **Уникальный номер** | **Определение** | **Комментарий** || || **Идентификатор терминала** | Число, заданное владельцем устройства, которое передается в служебных данных протокола | Чтобы не привязывать идентификатор терминала к IMEI-номеру, рекомендуем [указывать IMEI-номер](https://yandex.kz/routing/doc/kk/vrp/excel-fill-guide.md#vehicles-general) при планировании. || || **IMEI** | Номер, состоящий из 15-17 цифр | Из 15-17 цифр IMEI-номера по протоколу EGTS будут передаваться только последние 8-10 цифр. || || **TID** | Номер, указанный в документации устройства | TID считается равным IMEI-номеру, если по протоколу EGTS не присылался пакет `EGTS_SR_TERM_IDENTITY`, в котором устанавливается соответствие TID-IMEI. Авторизация не поддерживается. || |# {% note warning %} Идентификатор терминала, IMEI и TID — это разные числа. {% endnote %} В API можно использовать только числовые идентификаторы и IMEI-номера. #### Подготовка к ретрансляции данных через Wialon Retranslator {#gps-configuration-wialon-setup} Перед началом ретрансляции убедитесь, что выполнены следующие условия: * Устройство или платформа Мониторинга поддерживает передачу потока по протоколу Wialon Retranslator 1.0 (TCP push). * В Мониторинге заведен GPS-трекер, поле IMEI которого строго соответствует передаваемому в пакетах значению `unit_id`. Если это условие не выполнено, координаты не будут отображаться в треке, даже при успешном подтверждении приема пакетов сервером. * Для каждого датчика на активном маршруте в Мониторинге создан сенсор с известным `sensor_number`. Имя параметра в Wialon должно побайтно совпадать с `sensor_number`. {% note info %} Идентификаторы IMEI и `unit_id` должны быть числовыми. Пакеты с нечисловым идентификатором не обрабатываются и отбрасываются без ответа об ошибке. При отсутствии данных в треке в первую очередь проверьте формат передаваемого идентификатора. {% endnote %} ### Как проверить передачу данных {#check} Вы можете проверить поступление данных от GPS-трекера одним из способов: * в интерфейсе [Рабочего места логиста](https://yandex.kz/courier). Подробнее см. в разделе [GPS-трекеры](https://yandex.kz/routing/doc/kk/delivery/interface/gps-trackers.md); * через API: Отправьте POST-запрос к ресурсу [gps-trackers/status](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsCompanyGpsTrackerStatus). В теле запроса укажите 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": , "imeis": [123456789012345, 987654321098765] }' ``` **Результат** Метод возвращает массив объектов. Каждый объект соответствует одному GPS-трекеру и содержит поля: * `imei` — номер GPS-трекера; * `imei_str` — номер GPS-трекера в строковом формате; * `time` — дата и время последней известной позиции курьера в формате [ISO 8601](https://wikipedia.org/wiki/ISO_8601). Пример ответа: ```json [ { "imei": 123456789012345, "imei_str": "123456789012345", "time": "2026-07-24T10:30:00.000Z" } ] ``` Если данные с трекера не передавались, трекер не будет включен в ответ. Если настроить передачу данных через GPS-трекер не получилось, напишите в службу поддержки. [//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\))