Гео-отслеживание

1. Способы отслеживания1. Способы отслеживания

Движение транспорта можно отслеживать двумя способами:

• через мобильное приложение водителя;
• с помощью датчиков мониторинга (ГЛОНАСС/GPS), установленных на транспорте.

Оба способа:

• передают на карту данные о местоположении;
• фиксируют прибытие в точки погрузки/разгрузки;
• отмечают, выполнено действие вовремя или с опозданием.

2. Мобильное приложение2. Мобильное приложение

Особенности

• используется для отслеживания через мобильный телефон водителя;
• водитель устанавливает приложение, получает заказы и фиксирует статусы внутри приложения;
• приложение транслирует на платформу данные о передвижении водителя (на основе сигнала мобильного интернета и геопозиции);
• для работы требуются обязательные разрешения на мобильном устройстве и передача данных в приложение.

Подробнее о функциональности мобильного приложения

3. Датчики мониторинга3. Датчики мониторинга

Особенности

• датчики ГЛОНАСС/GPS устанавливаются на транспорт поставщиками специализированных услуг;
• поставщик ретранслирует данные в "Магистрали" - на платформе появляются сведения о движении транспорта.

Подробнее о настройке ретрансляции данных

4. Интерфейс и данные гео-отслеживания4. Интерфейс и данные гео-отслеживания

В столбце "гео-отслеживание" вкладки "В рейсе" доступны:

• кнопка перехода в детализацию - при нажатии открывается карта с гео-отслеживанием;
• квадраты статуса посещения точки - с указанием источника отслеживания (тягач, фургон, полуприцеп, мобильное приложение). Если источников несколько - отображаются все.

При наведении курсора на квадрат статуса отображаются:

• адрес точки прибытия (погрузка/разгрузка);
• статус посещения точки;
• время прибытия/убытия из геозоны.

При клике на квадрат статуса открывается детализация, где видны все въезды и выезды в геозону точки.

Цвета квадратов статуса:

• зелёный - прибыл вовремя;
• красный - опоздал;
• серый - статус неизвестен (до начала рейса или при разрыве связи).

5. Карта и детализация гео-отслеживания5. Карта и детализация гео-отслеживания

При нажатии кнопки перехода в детализацию открывается карта, на которой:

• показан подробный маршрут движения транспорта;
• отмечены точки погрузки/разгрузки.

На карте можно:

• посмотреть, в какое время транспорт находился в конкретной точке;
• кликнуть на точку - увидеть координаты и время присутствия, скопировать координаты.

Левая часть окна детализации:

• номер открытого рейса;
• детализация посещения точек:
  • список точек погрузки/разгрузки (по времени от ранней к поздней);
  • текущий статус посещения точки («посещено вовремя», «посещено с опозданием», «не начато/статус неизвестен»);
  • плановое и фактическое время посещения (источник: водитель, прицеп, машина).

Правая часть окна детализации (вверху):

• выпадающий список для переключения источника данных отслеживания - позволяет выбрать один источник для детального просмотра на карте.

Дополнительные элементы:

• значок - открывает детализацию по водителю и транспорту, переход к текущей точке местоположения;
• правый нижний угол - информация по источникам данных отслеживания, переход к последней точке присутствия, копирование координат.

6. Статусы рейса и груза6. Статусы рейса и груза

Статус рейса (общий для всего рейса):

• «Не начат» - по грузам нет статусов, работа не начата;
• «В пути» - по одному из грузов проставлен статус;
• «Завершён» - по всем грузам проставлен завершающий статус;
• «Отменён до начала» - рейс отменён до исполнения;
• «Отказ» - рейс начат, но заказ отменён исполнителем/заказчиком.

Статус груза в рейсе:

• каждый груз имеет уникальный статус;
• при проставлении статуса исполнителем меняется текущий статус груза;
• чтобы посмотреть статус груза:
  • раскройте детализацию груза в таблице;
  • в столбце «Статус груза рейса» будет виден статус по каждому грузу;
  • в свёрнутом виде в этом столбце отображаются все уникальные статусы, актуальные на текущий момент.

7. Настройка передачи телеметрических данных через ретрансляцию7. Настройка передачи телеметрических данных через ретрансляцию

Для того, чтобы платформа начала получать данные о местоположении транспортных средств:

1. Обратитесь к оператору вашей системы мониторинга с запросом на настройку ретрансляции данных на адрес платформы и передайте ему следующие параметры:

2. После настройки ретрансляции со стороны оператора впишите IMEI-номера устройств (ID) в карточки транспортных средств.

3. В течение часа при правильных настройках на платформу прогрузятся данные по местоположению.

7.1 Описание протокола Wialon IPS v1.17.1 Описание протокола Wialon IPS v1.1

Все пакеты передаются в текстовом формате.

Структура пакета

Каждый пакет имеет следующий формат:

#TP#msg\r\n

Типы пакетов

Описание пакетовОписание пакетов

Пакет логина (L)

#L#imei;password\r\n

Ответы сервера (AL):

Примеры:

#AL#1\r\n
#AL#0\r\n

Сокращённый пакет с данными (SD)

#SD#date;time;lat1;lat2;lon1;lon2;speed;course;height;sats\r\n

Если date и time содержат NA — используется текущее время сервера.

Ответы сервера (ASD):

Примеры:

#ASD#1\r\n
#ASD#0\r\n
#ASD#10\r\n

Полный пакет с данными (D)

#D#date;time;lat1;lat2;lon1;lon2;speed;course;height;sats;hdop;inputs;outputs;adc;ibutton;params\r\n

Формат дополнительных параметров (params)

Каждый параметр имеет формат NAME:TYPE:VALUE:

Зарезервированные параметры:

• SOS:1:1 — нажатие тревожной кнопки (тип int, значение 1)
• text:3:<сообщение> — текстовое сообщение от водителя

Примеры:

count1:1:564,fuel:2:45.8,hw:3:V4.5
SOS:1:1

Ответы сервера (AD):

Примеры:

#AD#1\r\n
#AD#0\r\n
#AD#10\r\n
#AD#11\r\n

Пинговый пакет (P)

#P#\r\n

Служит для поддержания активного TCP-соединения и проверки работоспособности канала.

Ответ сервера (AP):

#AP#\r\n

7.2 Описание протокола Wialon IPS v2.07.2 Описание протокола Wialon IPS v2.0

Все пакеты передаются в текстовом формате.

Структура пакета

Каждый пакет имеет следующий формат:

#TP#msg\r\n

Типы пакетов

Описание пакетовОписание пакетов

L — Пакет логина

Отправляется оборудованием при установке соединения с сервером.

#L#protocol_version;imei;password;crc16\r\n

Пример:

#L#2.0;imei;N/A;BB2B\r\n

Ответ сервера (AL):

#AL#1\r\n
#AL#0\r\n

SD — Сокращённый пакет с данными

#SD#date;time;lat1;lat2;lon1;lon2;speed;course;height;sats;crc16\r\n

Если поля date и time содержат значение NA — берётся текущее время сервера.

Ответ сервера (ASD):

#ASD#1\r\n
#ASD#0\r\n
#ASD#10\r\n

D — Пакет с данными

#D#date;time;lat1;lat2;lon1;lon2;speed;course;height;sats;hdop;inputs;outputs;adc;ibutton;params;crc16\r\n

Формат поля params:

Каждый параметр имеет вид NAME:TYPE:VALUE, где:

Специальные параметры:

• Тревожная кнопка SOS: параметр типа 1 с именем SOS, значение 1 означает нажатие.
• Текстовое сообщение от водителя: параметр типа 3 с именем text.

Примеры params:

count1:1:564,fuel:2:45.8,hw:3:V4.5
SOS:1:1

Если поля date и time содержат значение NA — берётся текущее время сервера.

Ответ сервера (AD):

#AD#1\r\n
#AD#0\r\n
#AD#10\r\n

P — Пинговый пакет

Служит для поддержания активного TCP-соединения с сервером, а также для проверки работоспособности канала.

#P#\r\n

Ответ сервера (AP):

#AP#\r\n

Вычисление CRC16Вычисление CRC16

Поле crc16 содержит контрольную сумму в шестнадцатеричном формате, big-endian, без ведущих нулей.

Пример: AA13BB (десятичное: 11146171)

Что входит в расчёт

Пример для #SD#:

#SD#date;time;lat1;lat2;lon1;lon2;speed;course;height;sats;crc16\r\n

CRC16 рассчитывается для:

date;time;lat1;lat2;lon1;lon2;speed;course;height;sats;

7.3 Описание протокола Wialon Retranslator v1.07.3 Описание протокола Wialon Retranslator v1.0

Все данные передаются в бинарном формате по протоколу TCP.

Входящие данныеВходящие данные

Cтруктура пакета

Каждый входящий пакет имеет следующую структуру:

Битовые флаги сообщения

Остальные биты зарезервированы или предназначены для внутреннего использования Wialon.

Структура блока данных

Набор блоков данных следует сразу за полями заголовка пакета. Блоки идут последовательно без разделителей.

Типы данных блока

Стандартные имена блоков

Если значения первых трёх параметров блока posinfo (lon, lat, altitude) отсутствуют — весь блок не включается в пакет.

Структура блока posinfo

Блок posinfo передаётся в бинарном формате как значение поля «Block value»:

Исходящие данныеИсходящие данные

После приёма каждого входящего пакета оборудование должно отправить на сервер байт подтверждения 0x11.

Пример разбора пакетаПример разбора пакета

Исходный пакет (HEX)

74000000333533393736303133343435343835004B0BFB70000000030BBB00000027
0102706F73696E666F00A027AFDF5D9848403AC7253383DD4B400000000000805A40
003601460B0BBB000000120004707772 5F657874002B8716D9CE973B400BBB000000
11010361766C5F696E707574730000000001

Разбор заголовка

Блок 1 — posinfo

Блок 2 — pwr_ext

Блок 3 — avl_inputs

7.4 Описание протокола EGTS7.4 Описание протокола EGTS

Общие принципы

• Все числовые типы (USHORT, UINT, ULONG, FLOAT, DOUBLE) передаются в порядке little-endian (младший байт вперед).
• Строки (STRING) — в кодировке CP-1251, оканчиваются байтом 0x00.
• Тип BINARY — массив байт без фиксированной длины.
• Поля помечены как M (Mandatory — обязательное) или O (Optional — необязательное).
• Контрольная сумма заголовка — CRC-8, тела пакета — CRC-16 CCITT.

Используемые типы данных

Структура пакета транспортного уровняСтруктура пакета транспортного уровня

Каждый пакет состоит из заголовка и опциональной области данных (SFRD).

Битовые флаги заголовка (PRF-байт)

Типы пакетов (PT)

Структура области данных (SFRD)Структура области данных (SFRD)

EGTS_PT_APPDATA

SFRD для пакетов типа EGTS_PT_APPDATA содержит один или несколько записей сервисного уровня (SDR):

EGTS_PT_RESPONSE

SFRD для ответных пакетов содержит:

EGTS_PT_SIGNED_APPDATA

Структура записи сервисного уровня (SDR)Структура записи сервисного уровня (SDR)

Каждая запись (SDR) имеет фиксированный заголовок и поле данных:

Флаги записи (RFL)

Структура подзаписи (Subrecord)

Сервисы протоколаСервисы протокола

Перечень сервисов

EGTS_AUTH_SERVICE — Сервис авторизации

Типы подзаписей

EGTS_SR_TERM_IDENTITY — Идентификация терминала

EGTS_SR_MODULE_DATA — Данные о модуле

EGTS_SR_AUTH_INFO — Данные аутентификации

EGTS_SR_RESULT_CODE — Код результата

Единственное поле: RCD (BYTE) — код результата авторизации (см. таблицу кодов ответа).

EGTS_SR_DISPATCHER_IDENTITY — Идентификация диспетчера

EGTS_SR_SERVICE_INFO — Информация о сервисе

EGTS_TELEDATA_SERVICE — Телематический сервис

Типы подзаписей

EGTS_SR_RECORD_RESPONSE — Подтверждение записи

EGTS_SR_POS_DATA — Основные навигационные данные

Флаги FLG:

EGTS_SR_EXT_POS_DATA — Расширенные навигационные данные

EGTS_SR_AD_SENSORS_DATA — Аналоговые и цифровые датчики

EGTS_SR_COUNTERS_DATA — Данные счётчиков

EGTS_SR_ACCEL_DATA — Данные акселерометра

Каждая структура ADS:

EGTS_SR_STATE_DATA — Состояние устройства

EGTS_SR_LOOPIN_DATA — Данные шлейфов

EGTS_SR_ABS_DIG_SENS_DATA — Абсолютный цифровой датчик

EGTS_SR_ABS_AN_SENS_DATA — Абсолютный аналоговый датчик

EGTS_SR_ABS_CNTR_DATA — Абсолютный счётчик

EGTS_SR_LIQUID_LEVEL_SENSOR — Датчик уровня жидкости

EGTS_SR_PASSENGERS_COUNTERS — Счётчики пассажиров

EGTS_COMMANDS_SERVICE — Сервис команд

EGTS_SR_COMMAND_DATA — Данные команды

Значения ACT:

Параметры соединенияПараметры соединения

Коды результата обработкиКоды результата обработки

Вычисление CRC-8 и CRC-16Вычисление CRC-8 и CRC-16

CRC-8 (заголовок пакета)

• Полином: 0x31 (x⁸ + x⁵ + x⁴ + 1)
• Init: 0xFF, Revert: false, XorOut: 0x00
• Контрольное значение для 123456789: 0xF7

unsigned char CRC8(unsigned char *lpBlock, unsigned char len) {
    unsigned char crc = 0xFF;
    while (len--)
        crc = CRC8Table[crc ^ *lpBlock++];
    return crc;
}

CRC-16 CCITT (данные пакета — SFRD)

• Полином: 0x1021 (x¹⁶ + x¹² + x⁵ + 1)
• Init: 0xFFFF, Revert: false, XorOut: 0x0000
• Контрольное значение для 123456789: 0x29B1

unsigned short Crc16(unsigned char *pcBlock, unsigned short len) {
    unsigned short crc = 0xFFFF;
    while (len--)
        crc = (crc << 8) ^ Crc16Table[(crc >> 8) ^ *pcBlock++];
    return crc;
}