Настройка передачи данных c устройств
Для работы с API Мониторинга курьер должен передавать данные о статусе заказов и текущем местоположении.
В API реализована поддержка передачи данных через приложение или через GPS-трекер.
Через приложение
Фактические данные с мобильного приложения Яндекс Курьер поступают в сервис автоматически после выбора маршрута.
Включение доступа у курьеров
Чтобы предоставить доступ курьерам к приложению Яндекс Курьер:
- Перейдите в интерфейс Рабочего места логиста, авторизовавшись с помощью учетной записи компании.
- В меню слева выберите Настройки → Мобильное приложение.
- Добавьте номера телефонов курьеров в формате
+7**********.
Инструкция и видеокурс по мобильному приложению доступны по ссылке в разделе Приложение Яндекс Курьер.
Через GPS-трекер
Поступление фактических данных с GPS-трекера поддерживается в протоколе ERA GLONASS Telematics Standard, приказ МинТранс №285 (EGTS) или протоколе FLEX. Данные с GPS-трекера должны передаваться в онлайн-режиме.
Требования к конфигурации
|
Протокол |
EGTS |
FLEX |
|
Адрес сервера |
egts.yandex.net |
b2bgeo-flex-proxy.maps.yandex.net |
|
TCP-порт |
4000 |
6000 |
|
Идентификатор устройства |
Номер, заданный владельцем устройства |
Номер, заданный владельцем устройства |
|
Пакет EGTS_SR_TERM_IDENTITY |
Обязателен, должен включать IMEI-номер |
— |
|
Пакет EGTS_SR_POS_DATA |
Содержит поле FLG, необходимое для указания дополнительных параметров навигационной посылки. В него входит бит VLD, который указывает на валидность координатных данных. Данные считаются валидными, если при их передаче бит VLD равен единице |
— |
|
Частота отсылки местоположения, в движении |
каждые 20 секунд |
каждые 20 секунд |
|
Частота отсылки местоположения, при стоянке |
каждые 120 секунд |
каждые 120 секунд |
|
Максимальная задержка отправления позиции |
1 сутки |
1 сутки |
Настройки конфигурации и идентификация устройства
Настройки конфигурации задаются в параметрах GPS-трекера или в системе GPS-провайдера.
Если данные о местоположении устройства не передаются в течение 1 минуты, сервис закроет соединение с GPS-трекером. Сообщения о местоположении со временем, отстающим от текущего времени более чем на одни сутки, будут игнорироваться системой.
Для идентификации устройства могут использоваться уникальные значения:
|
Уникальный номер |
Определение |
Комментарий |
|
Идентификатор терминала |
Число, заданное владельцем устройства, которое передается в служебных данных протокола |
Чтобы не привязывать идентификатор терминала к IMEI-номеру, рекомендуем указывать IMEI-номер при планировании. |
|
IMEI |
Номер, состоящий из 15-17 цифр |
Из 15-17 цифр IMEI-номера по протоколу EGTS будут передаваться только последние 8-10 цифр. |
|
TID |
Номер, указанный в документации устройства |
TID считается равным IMEI-номеру, если по протоколу EGTS не присылался пакет |
Важно
Идентификатор терминала, IMEI и TID — это разные числа.
В API можно использовать только числовые идентификаторы и IMEI-номера.
Как проверить передачу данных
Проверить поступление данных от GPS-трекера можно в разделе GPS трекеры.
Если настроить передачу данных через GPS-трекер не получилось, напишите в службу поддержки.