Техническое задание для разработки системы спутникового мониторинга

Дата подготовки
Дата согласования
«
»
20 г.
«
»
20 г.
Код Проектного
Решения
Техническое задание для разработки системы
спутникового мониторинга
Клиент
«Пивоваренная компания „Ба́лтика“»
Проект
Внедрение решения ORTEC Транспорт и Дистрибуция
Версия документа
2.0
Дата
12 – 10 – 2013
Автор
ORTEC
Техническое задание для разработки системы спутникового мониторинга
1/17
Согласовано
Роль в проекте
ФИО
Подпись
Техническое задание для разработки системы спутникового мониторинга
Дата
2/17
Контроль над документом
Запись изменений
Дата
Автор
27-09-2013
Сергей Раджабов
Роль/Должность
Консультант ORTEC
Версия
Ссылка на изменение
Первая версия
1.0
Связанные документы:
Название документа
Номер версии /Имя файла
Техническое задание для разработки системы спутникового мониторинга
Дата
3/17
Содержание
Глоссарий .................................................................................................................................. 5
1.
Мониторинг ....................................................................................................................... 7
2.
Передача запланированных рейсов из ОТД в систему спутникового мониторинга . 7
3.
Список регистрируемых событий ................................................................................... 7
3.1. Регистрация показаний телеметрии
7
3.2. Реализация действий типа «STOP» и «TRAVEL»
4.
10
Инциденты....................................................................................................................... 13
4.1. Инцидент «Отклонение от маршрута»
14
4.2. Инцидент «Отключение GPS устройства»
15
4.3. Инцидент «Несоблюдение последовательности посещения запланированных точек»
15
4.4. Инцидент «Незапланированные остановки» 15
5.
Протокол обмена данными ............................................................................................ 16
5.1. Частота обращения к веб-сервису ................................................................................. 16
5.2. Перечень функций веб-службы системы спутникового мониторинга ...................... 16
5.3. Параметры функций веб-службы системы спутникового мониторинга ................... 16
5.4. Дополнительные требования к веб-службе системы спутникового мониторинга ... 17
Техническое задание для разработки системы спутникового мониторинга
4/17
Глоссарий
Русский
Английский
Система
спутникового
мониторинга
Satellite monitoring
system
Служба
спутникового
мониторинга
ОТД
Satellite monitoring
service
ОРТЕК
ТС
Действие
OTD – ORTEC
Transport and
Distribution
ORTEC
Vehicle or resource or
truck
Action
Описание
Система GPS-мониторинга и ГЛОНАССмониторинга, обрабатывающая данные
полученные от устройств спутниковой навигации,
разработанная провайдером услуг спутникового
мониторинга. Система будет производить
мониторинг, контроль соблюдения графика
движения, отслеживание инцидентов описанных в
данном документе.
Веб служба осуществляющая обмен данных
между системой спутникового мониторинга и
внешними системами.
ОРТЕК Транспорт и Дистрибуция – Система
маршрутизации, диспетчеризации и мониторинга
транспорта
Поставщик системы ОРТЕК Транспорт и
Дистрибуция
Транспортное средство
Тип действия
«Движение»
Тип действия
«Остановка»
«Состояние Т\С»
Геозона
Travel action
Активность, которая осуществляется во время
выполнения заявки на перевозку, например,
погрузка, разгрузка, поездка, стоянка и т.д.
Движение Т\С
Stop action
Стоянка или остановка Т\С
Vehicle state
Geo-fence
Гео-фенсинг
Geofencing
РЦ
ПО
Точка посещения
Depot
Software
Point of visit
Тип адреса
Address Type
Рейс
Trip
Информация о Т\С
Участок вокруг точки посещения, определяемый
радиусом идущим из фиксированной точки,
которая является географическими координатами
точки посещения.
Автоматическое обнаружение и выполнение
запланированных действий в том случае, если
мобильное устройство клиента оказывается на
заранее обозначенной территории или покидает
таковую.
Распределительный центр или склад.
Программное обеспечение
Любое именованное физическое местоположение,
где может осуществляться погрузка и/или
разгрузка.
Тип адреса может принимать значения:
- РЦ:
- не РЦ.
Последовательность действий, необходимых для
выполнения одной или нескольких заявок на
перевозку. Как правило, последовательность
действий начинается на РЦ и заканчивается на РЦ.
Техническое задание для разработки системы спутникового мониторинга
5/17
Тег (Дескриптор)
Телеметрия
Telemetry
За смену у водителя и ТС может быть более
одного рейса.
Элемент языка разметки гипертекста
Информации о значениях измеряемых параметров.
Например: местоположение, скорость,
температура, состояние датчиков дверей,
информация с датчика двигателя, уровень топлива
и т.д..
Техническое задание для разработки системы спутникового мониторинга
6/17
1. Мониторинг
Фиксация перемещений ТС и событий в процессе работы.
Система спутникового мониторинга будет в реальном времени фиксировать и хранить
телеметрическую информацию со всех транспортных средств, зарегистрированных в системе,
за которыми прикреплены устройства спутникового мониторинга. Результат обработки
информации будет передаваться в ОТД.
2. Передача запланированных рейсов из ОТД в систему спутникового
мониторинга
Запланированные в ОТД рейсы будут передаваться в систему спутникового мониторинга для
последующего отслеживания исполнения запланированных действий и выявления инцидентов.
Исполненные (реализованные) действия и инциденты будут передаваться из системы
спутникового мониторинга в ОТД.

Каждое действие передаваемое из ОТД будет содержать уникальный номер действия,
номер адреса, номер рейса и т.д.;

Действие STOP содержит один адрес;

Действие TRAVEL содержит два адреса, начальный адрес и конечный адрес;

Каждый адрес имеет радиус и время, которое ТС должно простоять в геозоне адреса, что
остановка посчиталась прибытием в точку посещения.
Формат данных и пример рейса можно просмотреть в «Приложение_1_ТЗ_веб_сервис_GPS.xlsx», в
листе «OTD_to_GPS_trip_export».
3. Список регистрируемых событий
3.1.Регистрация показаний телеметрии
На момент написания данного задания, у Балтики не было финальных требований
относительно телеметрической информации, которую необходимо будет передавать в ОТД.
Список параметров будет определён на этапе согласования настоящего технического задания
с провайдером услуг спутникового мониторинга.
Показания телеметрии будут регистрироваться системой спутникового мониторинга и
передаваться в ОТД (см. Таблица 1. Телеметрия ТС ). Все поля указанные в таблице
обязательны для заполнения.
Периодичность
получения
телеметрии
от
устройства
спутникового
мониторинга
определяется поставщиком услуг спутникового мониторинга, но периодичность показаний
Техническое задание для разработки системы спутникового мониторинга
7/17
телеметрии передаваемых в ОТД, будет задаваться отдельно в этом документе. Таким
образом, в ОТД не будут передаваться все местоположения ТС, которые потенциально могут
регистрироваться каждую секунду, а промежуточные местоположения, с более редкой
периодичностью.
Данный подход является стандартным для ОТД, он направлен на уменьшение количества
передаваемых в ОТД данных, с целью уменьшения влияния обработки данных спутникового
мониторинга на производительность системы.
Информация о местоположение ТС
Предполагается, что система спутникового мониторинга будет передавать в ОТД сообщения
о местоположении ТС, для которых дата\время сообщений будет иметь периодичность
задаваемую в настройках системы спутникового мониторинга, рекомендуемое значение –
одно сообщение раз в 10 минут для каждого отдельного ТС. Балтика должна иметь
возможность изменять данный параметр.
Формат сообщений передаваемых в ОТД см. в «Приложение_1_ТЗ_веб_сервис_GPS.xlsx», в листах
«Telematics_during_STOP_action» и «Telematics_during_TRAVEL_action».
Техническое задание для разработки системы спутникового мониторинга
8/17
Таблица 1. Телеметрия ТС
Основная
информация
Тег
Описание
Алгоритм
Уникальный номер ТС.
<resourceId>
<position activity=""> Состояние ТС во время езды
(travel) или остановки (stop).
Система координат
<coordinatesystem>
<latitude>
<longitude>
<time>
Широта
Долгота
Число и время
Техническое задание для разработки системы спутникового мониторинга
Пример
<resourceId>10ORR</resourceId>
<position activity="travel">
<position activity="stop">
<coordinatesystem>Standard</coordinatesys
tem>
<latitude>56.9108</latitude>
<longitude>24.0835</longitude>
<time>2012-03-01T08:20:00</time>
9/17
Необходим
Да
Да
Да
Да
Да
Да
3.2.Реализация действий типа «STOP» и «TRAVEL»
Система спутникового мониторинга должна регистрировать и передавать в ОТД
информацию о исполнении запланированных действий, таких как «Остановка» и
«Движение» («STOP» и «TRAVEL» соответственно). Предварительно, из ОТД в службу
спутникового мониторинга будет передаваться плановая информация с привязкой к номеру
ТС. Описание плановой информации смотреть в разделе «Передача запланированных рейсов
из ОТД в систему спутникового мониторинга».
Далее представлены алгоритмы и форматы сообщений передаваемых в ОТД с информацией
о фактическом времени исполнения действий. В случае если, у поставщика услуг
спутникового мониторинга уже существуют реализации ПО имеющее схожие функции и
дающего схожий результат, допустимо изменение данного технического задания. Изменение
технического задание возможно только после согласования всех изменений между
поставщиком услуг спутникового мониторинга, Балтикой и ОРТЕК.
Алгоритмы генерации информации по реализациям действий типа «Остановка»
Начало действия
Фактом
начала
остановки
должен
считаться
момент
вхождения
ТС
в
геозону
запланированной точки посещения и его простоя в геозоне в течении минимум X минут.
Радиус геозоны и необходимое время простоя в каждой точке – значение X, будут
передаваться в систему спутникового мониторинга из ОТД.
В случае, если определённое действие было начато, его повторное начало недопустимо. К
примеру, если автомобиль въехал в геозону точки и простоял в ней определённое время,
необходимое для того, чтобы действие посчиталось начатым, при дальнейшем перемещении
автомобиля в геозоне и его повторной остановке, система спутникового мониторинга не
должна посчитать этот момент началом (повторным) действия.
Пример сообщения, которое служба спутникового мониторинга должна передавать в ОТД,
смотреть в «Приложение_1_ТЗ_веб_сервис_GPS.xlsx», лист «STOP_action_STARTED»).
Завершение действия
Фактом завершения остановки должен считаться момент выезда ТС из геозоны
запланированной точки посещения. В случае если определённое действие было завершено,
его повторное завершение недопустимо.
Техническое задание для разработки системы спутникового мониторинга
10/17
Пример сообщения, которое служба спутникового мониторинга должна передавать в
ОТД,
смотреть
в
«Приложение_1_ТЗ_веб_сервис_GPS.xlsx»,
лист
«STOP_action_FINISHED»).
Алгоритмы генерации информации по реализациям действий типа «Движение»
Начало действия
Фактом
начала
движения
должен
считаться
момент
выезда
ТС
из
геозоны
запланированной точки посещения. В случае если определённое действие было начато,
его повторное начало недопустимо.
Пример сообщения, которое служба спутникового мониторинга должна передавать в
ОТД,
смотреть
в
«Приложение_1_ТЗ_веб_сервис_GPS.xlsx»,
в
листе
«TRAVEL_action_STARTED»).
Завершение действия
Фактом окончания движения должен считаться момент, когда ТС входит в геозону
запланированной точки посещения. В случае если определённое действие было
завершено, его повторное завершение недопустимо.
Пример сообщения, которое служба спутникового мониторинга должна передавать в
ОТД, смотреть в приложении «Приложение_1_ТЗ_веб_сервис_GPS.xlsx», в листе
«TRAVEL_action_FINISHED».
Факт окончания действия типа «Остановка», будет также являться фактом начала
следующего действия типа «Движение», но только в том случае, когда следующее
действие типа «Движение» относится к тому же рейсу, к которому относится и действие
типа «Остановка». В таких случаях, сообщение об окончании действия типа «STOP» и
сообщение о начале действия типа «Движение», могут передаваться в одном сообщении
(пример см. в «Приложение_1_ТЗ_веб_сервис_GPS.xlsx», лист «Realise_multiple_actions»).
Техническое задание для разработки системы спутникового мониторинга
11/17
Таблица 2. Сообщение о начале\завершении выполнения действия
Тег
<actions>
Атрибут id
<planning-status>
<realised-times>
<distance>
Описание
Узел, содержащий информацию о начале и\или
завершении выполнения одного или нескольких действий
типа «Движение» и «Остановка» (теги <travel> и <stop>
соответственно).
Уникальный номер действия сгенерированный ОТД и
переданный в систему спутникового мониторинга.
Тег, содержащий статус действия. Список статусов,
которые могут быть присвоены действиям типа
«Движение» и «Остановка»:
«started» – начало выполнения действия;
«finished» – завершение исполнения действия.
Узел, содержащий теги с фактическим время выполнения
действия. Узел может содержать различные комбинации
следующих тегов:
- только время начала: <starttime>;
- время начала и окончания: <starttime>, <finishtime>;
- только время окончания: <finishtime>.
Пройденное расстояние с начала выполнения действия
типа «Движение» и до его завершения. Тег <distance>
должен передаваться только в сообщении содержащем
информацию о завершении действия типа «Движение».
Тип значения, которое может содержать тег: numeric(18,3)
Техническое задание для разработки системы спутникового мониторинга
Пример
<actions>
<stop id="9520">………</stop>
<travel id="9520"> ………</ travel>
Необходим
Да
</actions>
<stop id="9520">
<travel id="9520">
Да
<planning-status>started</planning-status>
<planning-status>finished</planning-status>
Да
<realised-times>
Да
<starttime>2012-03-01T08:05:00</starttime>
<finishtime>2012-03-01T08:05:00</finishtime>
</realised-times>
«Приложение_1_ТЗ_веб_сервис_GPS.xlsx», лист Нет
«TRAVEL_action_FINISHED».
12/17
4. Инциденты
Все события, которые происходят с ТС, будут отслеживаться и регистрироваться
системой спутникового мониторинга. В случае, если фактические показатели
отличаются от плановых показателей, либо не соответствуют определенным правилам,
служба спутникового мониторинга будет передавать в ОТД сообщения в виде
инцидентов.
Пример сообщения, которое служба спутникового мониторинга должна передавать в
ОТД, смотреть в «Приложение_1_ТЗ_веб_сервис_GPS.xlsx», в листе «GPS2OTD Alerts
example». Корневой узел «alerts», может содержать один и более узлов «alert».
Повторные сообщения об инциденте передаваться не должны. Продолжительность
инцидента фиксировать не надо.
Список инцидентов, которые предполагается, что будут отслеживаться системой
спутникового мониторинга:

Отклонение от маршрута

Отключение устройства спутникового мониторинга установленного на ТС

Несоблюдение последовательности посещения запланированных точек

Незапланированные остановки
Инциденты переданные в ОТД будут храниться в операционной базе данных ОТД либо
в архивной базе данных.
13 / 17
Таблица 3. Описание тегов инцидентов
Описание
Тег
Пример
Число и время.
<datetime>
<latitude>
<longitude>
<stop>
(или <travel>)
<Summary>
<Description>
<EntityType>
<EntityExtern
alId>
<datetime>2012-0301T08:20:00+04:00</datetime>
Широта. Тег может отсутствовать.
<latitude>56.9108</latitude>
Долгота. Тег может отсутствовать.
<longitude>24.0835</longitude>
Номер действия типа «Остановка» <stop id="947844"/>
или
«Движение»,
которое
выполняется.
Тег
может
отсутствовать.
Тип инцидента.
<Summary>Нарушение
температурного
режима
(начало)</Summary>
Дополнительная информация.
<Description>
Температура
10
градусов</Description>
Тип объекта, всегда будет иметь <EntityType>resource</EntityType>
значение “resource”
Значением этого тега должно быть <EntityExternalId>TRUCK_1</Entity
значение тега <id>, то есть <resource- ExternalId>
data><id>10ORR</id>
из
файла
переданного из ОТД в службу
спутникового мониторинга.
4.1.Инцидент «Отклонение от маршрута»
Инцидент должен возникать при выезде ТС из коридора маршрута. Коридор
маршрута может определяться расстоянием от основного графа маршрута. Значение
допустимого отклонении ТС от запланированного маршрута будет передаваться из
ОТД в систему спутникового мониторинга во время передачи спланированных
рейсов, на уровне информации о ТС, а именно в теге:
<udfield name=" allowedDeviation">10</udfield>
Значение данного тега будет измеряться в километрах. Точки прохождения
запланированного маршрута будут передаваться из ОТД в систему спутникового
мониторинга для каждого действия типа «Движение». Пример графа маршрута
смотреть в «Приложение_1_ТЗ_веб_сервис_GPS.xlsx», лист «OTD_to_GPS_trip_export»,
узел <route-info><coordinates>).
В ОТД будут передаваться сообщения о начале и завершении инцидента.

Пример сообщения о началом инцидента, которое служба спутникового
мониторинга
должна
передавать
в
ОТД,
смотреть
в
14 / 17
Необхо
дим
Да
Нет
Нет
Нет
Да
Нет
Да
Да
«Приложение_1_ТЗ_веб_сервис_GPS.xlsx»,
в
листе
«GPS2OTD
Alerts
example», пункт «Отклонение от маршрута (начало)».

Пример сообщения об окончанием инцидента, которое служба спутникового
мониторинга
должна
передавать
в
«Приложение_1_ТЗ_веб_сервис_GPS.xlsx»,
в
ОТД,
листе
смотреть
«GPS2OTD
в
Alerts
example», пункт «Отклонение от маршрута (окончание)».
4.2.Инцидент «Отключение GPS устройства»
Инцидент должен возникать при отключении устройства спутникового мониторинга
установленного на ТС.
Пример сообщения, которое служба спутникового мониторинга должна передавать
в ОТД, смотреть в «Приложение_1_ТЗ_веб_сервис_GPS.xlsx», в листе «GPS2OTD
Alerts example», пункт «Отключение GPS устройства».
4.3.Инцидент
«Несоблюдение
последовательности
посещения
запланированных точек»
Инцидент должен возникать при несоблюдении последовательности посещения
запланированных точек посещения, действий типа «Остановка».
Пример сообщения, которое служба спутникового мониторинга должна передавать
в ОТД, смотреть в «Приложение_1_ТЗ_веб_сервис_GPS.xlsx», в листе «GPS2OTD
Alerts
example»,
пункт
«Несоблюдение
последовательности
посещения
запланированных точек».
4.4.Инцидент «Незапланированные остановки»
Инцидент должен возникнуть при выявлении незапланированных остановок
произведённых ТС. Незапланированной остановкой будет считаться:

любая остановка вне радиуса запланированных точек посещения, действий
типа «Остановка», а также;

остановка продолжительностью Х и более минут. Х является параметром,
настраиваемым в системе спутникового мониторинга. Балтика должна иметь
возможность изменять данный параметр.
В случае если местоположение ТС не изменилось с момента выявления инцидента,
повторный инцидент передаваться не должен.
15 / 17
Пример сообщения, которое служба спутникового мониторинга должна передавать
в ОТД, смотреть в «Приложение_1_ТЗ_веб_сервис_GPS.xlsx», в листе «GPS2OTD
Alerts example», пункт «Незапланированная остановка».
5. Протокол обмена данными
Для обмена сообщениями между службой спутникового мониторинга и ОТД,
планируется использовать веб-службу и сообщения на основе протокола SOAP.
Предполагается, что обращаться будет веб-служба ОТД к веб-службе системы
спутникового мониторинга, обратное обращения не предусматривается.
5.1.Частота обращения к веб-сервису
Предполагается, что веб-служба ОТД будет обращаться к веб-службе системы
спутникового мониторинга с определённой периодичностью (к примеру раз в 5
минут). В ответ, веб-служба спутникового мониторинга будет передавать в ОТД
телеметрию, события и инциденты описанные в разделах «Список регистрируемых
событий» и «Инциденты».
5.2.Перечень функций веб-службы системы спутникового мониторинга
Для каждого типа сообщения (телеметрия, события или инцидент) в веб-службе
должна быть разработана отдельная функция, к примеру:
o GET_Telematics;
o GET_Realizations;
o GET_Alerts.
5.3.Параметры функций веб-службы системы спутникового мониторинга
Для каждой из вышеуказанных функций, необходимо предусмотреть параметры
определяющие для каких именно ТС и за какой период времени необходимо
сгенерировать данные.
Название
параметра
Resource_By
Пример
Division
Описание
Значение тега соответствует значению тега <division><code>,
относящегося
к
узлу
<resource>,
смотреть
в
«Приложение_1_ТЗ_веб_сервис_GPS.xlsx»,
лист
«OTD_to_GPS_trip_export».
16 / 17
PeriodOfTime
1
Параметр измеряется в часах, параметр указывает на то, что
для каждого ТС необходимо сгенерировать данные с момента
последнего запроса, но с продолжительностью не более 1-го
часа. Таким образом, если со стороны ОТД не были
произведены запросы в течение 10 часов, при следующем
запросе, указывая в данном параметре значение 1, система
спутникового мониторинга выдаст данные по каждому ТС за
период не более 1-го часа. Данные, которые не были переданы
в ОТД в течение 10 часов, будут переданы пакетами в 1 час за
10 запросов.
5.4.Дополнительные требования к веб-службе системы спутникового
мониторинга
5.4.1.
Предполагается, что веб-служба системы спутникового мониторинга
будет исключать дублирование данных.
5.4.2.
Предполагается, что все данные относящиеся к каждому ТС в
отдельности, будут передаваться в ОТД отсортированными по времени в
порядке нарастания.
17 / 17