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

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

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

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

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

Чтобы предоставить доступ курьерам к приложению Яндекс Курьер:

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

При работе через протокол 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 трекеры.

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