Формат сообщений сервисов

Приложение №2 к Оферте
Договор о взаимодействии и информационном
обмене в сфере навигационной деятельности
г. Тюмень
«___»_________ 2012 г.
Государственное казенное учреждение Тюменской области «Центр
информационных технологий Тюменской области», являясь региональным
центром спутникового мониторинга ГЛОНАСС, а также уполномоченной
организацией, обеспечивающей техническую поддержку при внедрении
навигационно-информационных технологий на территории Тюменской
области (далее – РНИЦ), в лице директора Усманова Артура Рифовича,
действующего на основании Устава
с одной стороны и участник
информационного взаимодействия -___________________________________
______________________________________________ (далее – Участник) в
лице _____________________________________________________________,
действующего на основании __________________, с другой стороны, вместе
именуемые Стороны,
руководствуясь Федеральным законом от 14.02.2009 №22–ФЗ «О
навигационной деятельности», постановлением Правительства Российской
Федерации от 02.04.2012 № 280 «Об утверждении Положения о
лицензировании пассажирских перевозок», постановлением Правительства
Российской Федерации от 23.04.1994 № 372 «О мерах по обеспечению
безопасности при перевозке опасных грузов автомобильным транспортом»,
распоряжением правительства Российской Федерации от 30.07.2010 № 1285р «Об утверждении Комплексной программы обеспечения безопасности
населения на транспорте», приказом Минтранса России от 26.01.2012 №20
«Об утверждении Порядка оснащения транспортных средств, находящихся в
эксплуатации, включая специальные транспортные средства, категории М,
используемых для коммерческих перевозок пассажиров, и категории N,
используемых для перевозки опасных грузов, аппаратурой спутниковой
навигации ГЛОНАСС или ГЛОНАСС/GPS», приказом Минтранса России от
31.07.2012 №285 «Об утверждении требований к средствам навигации,
функционирующим с использованием навигационных сигналов системы
ГЛОНАСС или ГЛОНАСС/GPS и предназначенным для обязательного
оснащения транспортных средств категории М, используемых для
коммерческих перевозок пассажиров, и категории N, используемых для
перевозки опасных грузов», распоряжением Правительства Тюменской
области от 15.10.2012 №2020-рп «Об обеспечении использования технологии
глобальной навигационной спутниковой системы ГЛОНАСС» и иными
нормативными правовыми актами, заключили настоящий Договор о
нижеследующем.
1. Предмет Договора
1.1. Предметом настоящего Договора является передача Участником
мониторинговой информации от аппаратуры спутниковой навигации
ГЛОНАСС или ГЛОНАСС/GPS (далее – аппаратура ГЛОНАСС),
установленной на транспортных средствах в информационную систему
РНИЦ для:
- предоставления доступа Уральскому управлению государственного
автодорожного надзора Федеральной службы по надзору в сфере транспорта
(далее - Уральское УГАДН);
- передачи в федеральные органы исполнительной власти,
исполнительные органы государственной власти Тюменской области, органы
местного самоуправления.
1.2. Перечень
мониторинговой
информации,
передаваемой
Участником в РНИЦ, устанавливается в Приложении №1 к настоящему
Договору.
1.3. При организации взаимодействия Стороны руководствуются
следующими принципами:
- соблюдение интересов граждан, общества и государства в области
обеспечения безопасности перевозок пассажиров и грузов и безопасности
дорожного движения;
- приоритет жизни и здоровья граждан, участвующих в дорожном
движении, над экономическими результатами хозяйственной деятельности;
- использование
информационных ресурсов в соответствии с
действующим законодательством Российской Федерации.
- обязательность и надлежащего исполнения условий настоящего
Договора;
- обеспечение защиты информации и контроля доступа к информации.
1.4. Исходя из общих интересов, Стороны договорились путем участия
каждой из Сторон профессиональными знаниями и опытом сотрудничать
друг с другом и совместно действовать для успешного достижения целей
настоящего Договора, в том числе для:
1) повышения эффективности управления движением транспортных
средств;
2) обеспечения
безопасности перевозок пассажиров и грузов
транспортными средствами и безопасности дорожного движения;
3) повышения степени доступности информации гражданам об
организации и качестве транспортного обслуживания на территории
Тюменской области.
1.5. Обмен информацией в электронном виде осуществляется с
использованием сетей связи согласно Технических условий (Приложение
№2).
2.Права и обязанности Сторон
2.1. Каждая из Сторон:
2.1.1. Назначает лицо, ответственное за сотрудничество в рамках
исполнения настоящего Договора.
2.1.2. Осуществляет консультативную поддержку деятельности другой
стороны в сфере, регулируемой настоящим Договором.
2.1.3. Самостоятельно
создает
необходимые
организационные,
финансовые и технические возможности для реализации установленных
настоящим Договором целей и задач.
2.1.4. Обязуется соблюдать требования информационной безопасности,
принимать меры по предотвращению несанкционированного доступа к
полученным сведениям.
2.1.5. Осуществляет
предоставление
и
обмен
информацией
посредством
web-сервисов
согласно
Унифицированному
протоколу
взаимодействия телематических платформ систем мониторинга и управления
подвижными объектами (Приложение №3).
2.2. РНИЦ:
2.2.1. Предоставляет доступ Уральскому УГАДН к мониторинговой
информации, которая передается в региональную информационную систему
Участником на основании отдельного Соглашения, заключаемого между
РНИЦ и Уральским УГАДН.
2.2.2. Предоставляет мониторинговую информацию федеральным
органам исполнительной власти, исполнительным органам государственной
власти Тюменской области, органам местного самоуправления в целях
оказания ими государственных и муниципальных услуг и исполнения
государственных и муниципальных функций.
2.2.3. Размещает на своем официальном
сайте www.citto.ru
информацию об Участнике.
2.2.4. Размещает
на
своем
официальном
сайте
www.citto.ru
информацию о недобросовестном исполнении обязательств Участником, в
случае неоднократного (более 3-х раз) не предоставления мониторинговой
информации в РНИЦ, предусмотренной настоящим Договором.
Под не предоставлением мониторинговой информации понимается
отсутствие в информационной системе РНИЦ мониторинговой информации о
зарегистрированной в информационной системе Участника аппаратуре
ГЛОНАСС,
которое
подтверждается
письменным
официальным
уведомлением (обращением, письмом) Уральского УГАДН, направленным в
адрес РНИЦ, в том числе по электронной почте.
Информация о недобросовестном исполнении обязательств Участником
размещается на официальном сайте после предварительного письменного
уведомления Участника со стороны РНИЦ.
2.3. Участник:
2.3.1. На основании заключенных отдельных договоров на оказание
услуг (выполнение работ) оформляет и выдает владельцам транспортных
средств, в обязанности которых входит оснащение транспортных средств
аппаратурой ГЛОНАСС (далее - Заказчики), документ, подтверждающий
оснащение транспортного средства аппаратурой ГЛОНАСС по форме,
установленной в Приложении 4 к настоящему Договору.
2.3.2. В течение одного месяца с даты заключения настоящего Договора
обеспечивает взаимодействие информационных систем Сторон путем
соблюдения Технических условий подключения к информационной системе
РНИЦ.
2.3.3. По истечении срока установленного пунктом 2.3.2. обеспечивает
непрерывную передачу в РНИЦ мониторинговой информации от аппаратуры
ГЛОНАСС, установленной на транспортном средстве и регистрирует
подключенное устройство в информационной системе РНИЦ не позднее 24
(двадцати четырех) часов с даты подписания документа, подтверждающего
оснащение транспортного средства аппаратурой ГЛОНАСС.
Критерии непрерывности передачи мониторинговой информации
установлены пунктом 7 Технических условий.
2.3.4. Подключает
аппаратуру
ГЛОНАСС,
соответствующую
требованиям действующих нормативных правовых актов и обеспечивающую
передачу мониторинговой информации в РНИЦ.
2.3.5. Информирует Заказчиков, в обязанности которых, в соответствии
с нормативными правовыми актами Российской Федерации, входит установка
аппаратуры ГЛОНАСС на транспортные средства о том, что доступ
Уральскому УГАДН к мониторинговой информации о таких транспортных
средствах предоставляется через информационную систему РНИЦ.
2.3.6. Обеспечивает бесперебойную работу аппаратуры ГЛОНАСС
установленной на транспортных средствах своих Заказчиков, путем
своевременного проведения технического обслуживания, ремонта и замены
вышедшего из строя аппаратуры ГЛОНАСС.
2.3.7. При получении уведомления от РНИЦ на адрес своей электронной
почты о недостоверности полученной мониторинговой информации и (или) о
неисправности аппаратуры ГЛОНАСС принимает незамедлительные меры к
устранению неисправности в срок, не превышающий 20 (двадцати) часов с
даты получения уведомления.
3.
Срок действия Договора,
порядок его изменения и расторжения.
3.2. Настоящий Договор вступает в силу с даты его заключения
Сторонами и действует бессрочно.
3.3. Настоящий Договор может быть расторгнут по инициативе любой
Стороны, о чем необходимо письменно уведомить каждую Сторону не
позднее чем за два месяца до его расторжения.
3.4. Настоящий Договор может быть расторгнут РНИЦ в одностороннем
порядке в случае несоответствия Участника Техническим условиям и (или)
нарушения Участником срока, установленного пунктом 2.3.2 настоящего
Договора. Расторжение договора в одностороннем порядке осуществляется
по истечение 5 рабочих дней с даты направления со стороны РНИЦ
официального уведомления о расторжении договора на электронный адрес
Участника.
3.5. Изменения и дополнения к настоящему Договору могут быть
внесены Сторонами путём подписания ими дополнительных соглашений. При
этом Стороны обеспечивают непрерывность информационного обмена.
3.6. При расторжении настоящего Договора РНИЦ уведомляет об этом
Уральское УГАДН.
4.Заключительные положения
4.1. Настоящий договор является безвозмездным.
4.2. Все споры и разногласия, возникающие при исполнении настоящего
Договора Стороны договорились разрешать путем переговоров, в случае не
достижения согласия споры передаются на рассмотрение в Арбитражный суд
Тюменской
области
в
порядке,
установленном
действующим
законодательством РФ.
4.3. В случае изменения у какой-либо из Сторон адреса регистрации
(адреса местонахождения) или почтового адреса, наименования, банковских и
иных реквизитов данная Сторона обязана в течение 5 (Пяти) календарных
дней, с даты наступления соответствующего события, направить в
письменной форме соответствующие изменения или информацию о них
другой Стороне.
4.4. Настоящий Договор заключен и подписан в двух экземплярах,
имеющих одинаковую юридическую силу, по экземпляру каждой из Сторон
4.5. По вопросам, не урегулированным настоящим Договором, Стороны
руководствуются действующим законодательством Российской Федерации.
5. Адреса и подписи Сторон:
РНИЦ
Государственное казенное
учреждение Тюменской области
«Центр информационных
технологий Тюменской области»
Местонахождение: 625004, Тюменская
обл., г. Тюмень, ул. Володарского, д.45
Почтовый адрес: 625026, Тюменская обл.,
г. Тюмень, ул. Республики, д.142
ИНН 7202190205, КПП 720201001
ОГРН: 1087232038794
Лицевой счет: УФК по Тюменской области
(ДФ Тюменской области ГКУ ТО «ЦИТТО»
л/с ЛС000020855 ЦИНТ))
в ГРКЦ ГУ Банка России по Тюменской
обл. г.Тюмень р/с 40201810200000100009
БИК 047102001
Тел(факс). 543-040 (543-046)
Директор
______________А.Р. Усманов
Участник
Приложение №1
к договору о взаимодействии
и информационном обмене
в сфере навигационной деятельности
от_________ № _____
Виды мониторинговой информации,
которая предоставляется Участником в рамках
Договора о взаимодействии и информационном обмене
в сфере навигационной деятельности от ___________ №__
1.
2.
3.
4.
5.
6.
Идентификационный номер абонентского телематического терминала.
Географическая широта местоположения транспортного средства.
Географическая долгота местоположения транспортного средства.
Скорость движения транспортного средства
Путевой угол транспортного средства.
Время и дата фиксации местоположения транспортного средства.
РНИЦ
Директор
ГКУ ТО «ЦИТТО»
______________А.Р. Усманов
Участник
Приложение № 2
к договору о взаимодействии
и информационном обмене
в сфере навигационной деятельности
от ___________№ _____
ТЕХНИЧЕСКИЕ УСЛОВИЯ
к Участнику информационного обмена
в сфере навигационной деятельности.
№№
п/п
Показатели
1.
Лицензионные
требования
2.
Квалификационные
требования
Критерии
Наличие лицензии на услуги
связи в сети передачи данных,
за исключением передачи
голосовой информации
(подтверждается
предоставлением копии,
заверенной подписью
руководителя и печатью
организации) или договора с
организацией, имеющей
указанную лицензию
Наличие лицензии на
телематические услуги связи
(подтверждается
предоставлением копии,
заверенной подписью
руководителя и печатью
организации) или договора с
организацией, имеющей
указанную лицензию
Наличие квалифицированного
штатного персонала с высшим
техническим образованием,
опытом работы по
специальности более 1 года
(количество специалистов
подтверждается
предоставлением копий
дипломов, копий трудовых
книжек, заверенных кадровой
службой по месту работы)
Подтверждающий
документ номер и
дата выдачи
3.
4.
Наличие договора с оператором
связи о присоединении сетей
электросвязи (подтверждается
предоставлением копии
договора, заверенного подписью
руководителя и печатью
организации)
Технологические
Интернет-канал с пропускной
требования
способностью (скоростью) не
менее 2 Мбит (подтверждается
предоставлением копии
договора, заверенной подписью
руководителя и печатью
организации)
Наличие мониторингового
сервера с лицензионным
программным обеспечением,
позволяющим собирать и
передавать РНИЦ данные
мониторинга транспортных
средств и соответствующего
требованиям Приложения N 1 к
приказу Министерства
транспорта Российской
Федерации от 31 июля 2012 г. N
285 (подтверждается
предоставлением копии
лицензионного договора,
заверенной подписью
руководителя и печатью
организации)
Соответствие устанавливаемой
на транспортные средства
аппаратуры спутниковой
навигации ГЛОНАСС или
ГЛОНАСС/GPS требованиям
Приложения N2, №3 или №4 к
приказу Министерства
транспорта Российской
Федерации от 31 июля 2012 г.
N 285
Требования к защите Наличие установленного и
передаваемых
настроенного SSL-туннеля для
данных
передачи мониторинговой
информации
5.
6.
7.
Организация
технической
поддержки
Наличие службы
регламентированной
технической поддержки
Публикация на сайте
информации для заказчиков
(потребителей услуг) о
предоставляемой ТП: виды,
содержание, условия
предоставления, правила
взаимодействия
Обеспечение выделенного
(отличного от общего телефона
компании) телефона службы ТП.
Процедура контроля качества
услуг
Формат
72МММНННННН
идентификационного МММ – порядковый номер
номера абонентского Участника в реестре РНИЦ
телематического
НННННН – порядковый номер
терминала
терминала у Участника
Критерии
непрерывности
передачи
мониторинговой
информации
Критерии непрерывности
передачи мониторинговой
информации устанавливаются в
соответствии с требованиями
Приложения N 1 к Приказу
Министерства транспорта
Российской Федерации от 31
июля 2012 N 285
Приложение № 3
к договору о взаимодействии
и информационном обмене
в сфере навигационной деятельности
от __________ № ______
УНИФИЦИРОВАННЫЙ ПРОТОКОЛ ВЗАИМОДЕЙСТВИЯ
ТЕЛЕМАТИЧЕСКИХ ПЛАТФОРМ СИСТЕМ МОНИТОРИНГА И
УПРАВЛЕНИЯ ПОДВИЖНЫМИ ОБЪЕКТАМИ
V1.4
Москва, 2011 г.
Содержание
1 Назначение Унифицированного протокола
2 Субъекты взаимодействия
3 Сетевое взаимодействие клиентской и серверной стороны, архитектура обмена
информацией
4 Типы передаваемой информации
4.1
Информация, передаваемая в направлении от внешней системы к платформе,
обслуживающей объект мониторинга
4.2
Информация, передаваемая в направлении от платформы, обслуживающей
объект, к внешней системе
5 Необходимые сервисы Клиентской и Серверной частей
5.1
Сервисы Серверной части
5.2
Сервисы Клиентской части
6 Формат сообщений сервисов
6.1
Формат сообщений сервисов Серверной стороны
6.1.1 Формат сообщений сервиса приема запроса на определение местоположения
и состояния объекта
6.1.2 Формат сообщений сервиса приема запроса на отправку команды на объект
6.1.3 Формат сообщений сервиса приема запроса на отправку сообщения на объект
с вариантами ответа
6.2
Формат сообщений сервисов Клиентской стороны
6.2.1 Формат сообщений сервиса приема местоположение и состояния объекта
6.2.2 Формат сообщений сервиса приема сообщений, поступивших от объекта
6.2.3 Формат сообщений сервиса приема подтверждений на ранее переданные на
объект команды
6.2.4 Формат сообщений сервиса приема подтверждений о прочтении и варианта
ответа на ранее переданное на объект сообщение
7 Статус документа
Назначение Унифицированного протокола
Унифицированный протокол взаимодействия телематических платформ
систем мониторинга и управления подвижными объектами предназначен для
обеспечения межсерверного обмена между телематическим сервером BNComplex и сторонними телематическими серверами.
Применение
Унифицированного
протокола
обеспечивает
передачу
навигационной телематической информации о местоположении и состоянии
транспортных средств в систему мониторинга в едином формате.
Субъекты взаимодействия
Субъектами взаимодействия в рамках Унифицированного протокола для
целей обслуживания объекта мониторинга и управления являются:
Платформа, обслуживающая объект мониторинга, непосредственно
осуществляющая сетевое или иное взаимодействие с аппаратными средствами,
установленными на объекте мониторинга. Данная платформа далее именуется
Сервером.
Платформа,
которая
не
обслуживает
объект
мониторинга
непосредственно, но участвует в информационном обмене с объектом
мониторинга через платформу посредника – Сервер. Данная платформа далее
именуется Клиентом.
Сетевое взаимодействие клиентской и серверной стороны,
архитектура обмена информацией
Клиент и Сервер взаимодействуют по протоколу TCP/IP на транспортном
уровне и по протоколу SOAP на уровне приложения, с использованием
протокола HTTP для SOAP диалога.
Отправитель SOAP сообщения инициирует соединение на указанный
владельцем противоположной стороны сервиса адрес, порт и URL, проходит
авторизацию стандартным для протокола HTTP способом, передает SOAP
сообщение и получает от противоположной стороны соответствующий SOAP
ответ с наполнением информацией или SOAP сообщение о сбое.
При этом в связках систем с большой частотой обмена информацией
целесообразно поддержание постоянных (KeepAlive) HTTP соединений, что
приведёт к уменьшению накладных расходов на авторизацию и инициирование
соединений.
Поддерживаются виды авторизации Basic, Digest и NTLM.
Для целей закрытия канала передачи информации должна быть
применена технология SSL. Применение SSL необходимо в направлении от
Сервера к Клиенту, в котором поток информации на порядки больше, и, в тоже
время, содержит конфиденциальную информацию о местоположении и
состоянии объектов.
Т. к. обмен информацией носит двусторонний характер, то обе стороны
реализуют сервисы по обработке SOAP сообщений.
Типы передаваемой информации
Передаваемая при межсерверном обмене информация разделяется на два
типа: информация, передаваемая от Сервера к Клиенту и информация,
передаваемая то Клиента к Серверу.
Информация, передаваемая в направлении от внешней системы к
платформе, обслуживающей объект мониторинга
В направлении от Клиента к Серверу осуществляется передача
следующих видов информации:
- SOAP запрос местоположения и состояния объекта. В ответ от
Сервера приходит телематическое сообщение.
- Статусное SOAP сообщение о сбое или успешном подтверждении
сообщения о местоположении и состоянии объекта, переданного со
стороны
Сервера.
Отправляется
Клиентом
в
ответ
на
телематическое сообщение, поступившее от Сервера по его
собственной инициативе.
- SOAP сообщение с командой для передачи на объект. Сервер в
ответ передает статусное сообщение о приеме команды для
дальнейшей обработки или ошибку.
- SOAP сообщение с данными и, возможно, вариантами ответа для
передачи на объект. Сервер в ответ передает статусное сообщение о
приеме данных для дальнейшей обработки или ошибку.
- Статусное SOAP сообщение о сбое или успешном подтверждении
сообщения о подтверждении выполнения переданной ранее
команды,
переданного
со
стороны
платформы.
Передается
Клиентом в ответ на сообщение от Сервера о подтверждении
выполнения ранее переданной команды.
- Статусное SOAP сообщение о сбое или успешном подтверждении
сообщения о сообщении, поступившем с объекта, и переданного со
стороны Сервера. Отправляется Клиентом в ответ на сообщение от
Сервера,
содержащее
информацию
о
текстовом
или
ином
сообщении, поступившем с объекта.
- Статусное SOAP сообщение о сбое или успешном подтверждении
сообщения
о
прочтении
ранее
переданного
сообщения
с
возможным вариантом ответа на него, поступившем с объекта, и
переданного со стороны Сервера. Передается Клиентом в ответ на
сообщение от Сервера, содержащее информацию об ответе или
подтверждении прочтения ранее переданного на объект сообщения.
Информация,
передаваемая
в
направлении
от
платформы,
обслуживающей объект, к внешней системе
В направлении от Сервера к Клиенту осуществляется передача
следующих видов информации:
- SOAP сообщение с телематической информацией, передаваемое в
ответ на запрос Клиентом местоположения объекта. Может
содержать
не
только
координатную
информацию,
но
и
информацию о состоянии входов, выходов, аналоговых входов,
данные о режиме движения, данные из пользовательского порта,
мультимедийную
информацию
–
полный
пакет
данных,
описывающих измерения на объекте.
- SOAP сообщение с телематической информацией, передаваемое
сервером по его собственной инициативе в момент поступления
данных от объекта. Клиент в ответ Серверу возвращает статусное
SOAP сообщение о принятии информации или сбое.
- Статусное SOAP сообщение о подтверждении приема команды для
передачи на объект или сообщение об ошибке. Передается
Сервером в ответ на сообщение от Клиента с командой для объекта.
- Статусное SOAP сообщение о подтверждении приема сообщения
для передачи на объект или сообщение об ошибке. Передается
Сервером в ответ на сообщение от Клиента с сообщением для
объекта.
- SOAP сообщение с подтверждением выполнения команды, ранее
переданной на объект. В ответ Клиент передает статусное
сообщение о приеме подтверждения о выполнении команды или
ошибку.
- SOAP сообщение с данными, поступившими с объекта. В ответ
Клиент отправляет статусное сообщение о подтверждении приема
данных или ошибку.
- SOAP сообщение с информацией о подтверждении прочтения или с
вариантом ответа на ранее переданное на объект сообщение.
Передается Сервером по собственной инициативе в момент
поступления информации с объекта. Клиент подтверждает прием
статусным сообщением или выдает ошибку.
Необходимые сервисы Клиентской и Серверной частей
Для построения полнофункционального взаимодействия необходимо
организовать набор сервисов, как с Клиентской, так и с Серверной стороны.
При отсутствии необходимости передачи на бортовое оборудование части
информации, например, сообщений, соответствующая часть сервисов не
требуется к реализации.
Сервисы Серверной части
- Прием запроса на определение местоположения и состояния
объекта.
- Прием запроса на отправку команды на объект.
- Прием запроса на отправку сообщения на объект с вариантами
ответа.
Сервисы Клиентской части
- Прием местоположения и состояния объекта.
- Прием сообщения от объекта.
- Прием подтверждения о выполнении ранее переданной на объект
команды.
- Прием подтверждения о прочтении и варианта ответа на ранее
переданное на объект сообщение.
Формат сообщений сервисов
Ниже подробно описаны форматы соответствующих SOAP запросов и
ответов на них от противоположной стороны, как содержащих информацию,
так и сообщений о сбое. Также указано, какие действия должен выполнить
Сервер и Клиент после приема или передачи того или иного сообщения,
получения успешного статуса или сообщения о сбое.
Формат сообщений сервисов Серверной стороны
Формат
сообщений
сервиса
приема
запроса
на
определение
местоположения и состояния объекта
При необходимости получить внеочередное местоположение и состояние
объекта Клиент выдает запрос вида:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope
xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:GetCoord>
<ObjectID>ObjectNumber</ObjectID>
</ws:GetCoord>
</soapenv:Body>
</soapenv:Envelope>
После получения данного запроса Сервер пытается определить текущее
местоположение и состояние объекта с идентификатором ObjectNumber и, если
это удалось сделать, то выдает следующий SOAP ответ:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:GetCoordResponce>
<ObjectID>ObjectNumber</ObjectID>
<Coord
time="KMLTimeStamp"
lon="Longitude"
lat="Latitude"
alt="Altitude" speed="Speed" dir="Direction" valid="Validity"/>
<AddInfo
motion="Run_mode_on_off"
dist="by_distance"
online="point_type" mileage="Current_milage"/>
<DigI inpnum="Input_number"/>
...
<DigO outnum="Output_number"/>
...
<AnalogI num="Input_number" val="Sens_value"/>
...
<PortData port="Port_num" recvd="base64_data_from port"/>
<Multimedia mmtp="MIME-type_of_data" read="base64_multimedia_data"/>
</ws:GetCoordResponce>
</soapenv:Body>
</soapenv:Envelope>
В
параметре
ObjectID
передается
идентификатор
объекта,
местоположение которого определяется (например, номер телефона в формате
79032058458 или другого абонентского оборудования, например, 80066670).
Обязательная структура Coord, которая определяет географическую
составляющую сообщения. Обязательные атрибуты:
- time указывается момент времени UTC (Гринвичское время) определения
местоположения. Формат соответствует формату кодирования даты и
времени,
передаваемого
в
Гринвиче
(YYYY-MM-DDThh:mm:ssZ).
Например, 2010-01-29T01:28:01Z соответствует четырем часам двадцати
восьми минутам одной секунде московского стандартного времени двадцать
девятого января 2010 года.
- lon, lat – градусы долготы и широты местоположения. Отрицательные
значения широты соответствуют южному полушарию. Отрицательные
значения долготы соответствуют западному полушарию. Количество знаков
в дробной части определяется точностью измерения местоположения,
достигаемой бортовым оборудованием, но общее количество значащих цифр
целой и дробной частей вместе не должно превышать 15 знаков.
- alt – высота в метрах – опциональный атрибут. Дробное значение.
- speed – скорость в км/ч. Точность один знак после запятой.
- dir – направление движения в градусах от северного направления при
вращении по часовой стрелке. Целое число в пределах от 0 до 359.
- valid – признак валидности полученных навигационных данных. Значение
1 соответствует валидным координатам, 0 – не валидным.
Разделитель целой и дробной частей – точка. Следующие структуры
располагаются в сообщении последовательно.
Опциональная структура AddInfo, которая определяет дополнительную
информацию к замеренной координате сообщения. Обязательные атрибуты:
Атрибут motion устанавливается в 1, когда данная координата замерена
в режиме, когда объект двигался. Если объект стоял, и не была осуществлена
отбивка по дистанции, то устанавливается в 0. Соответственно, в случае
отбивки по дистанции или отбивки по таймеру или превышения порога угла
поворота, атрибут устанавливается в 1.
Атрибут dist устанавливается в 1, когда посылка сгенерирована после
прохождения очередного участка заданной протяженностью (отбивка по
пройденной дистанции). Иначе - 0.
Атрибут online устанавливается в 1, если эту замеренную координату
удалось доставить на Сервер с первой попытки передачи между бортовым
оборудованием и связным шлюзом на Сервере, в противном случае, координата
передается из «черного ящика» прибора – значение 0.
Атрибут mileage является опциональным и содержит пробег в километрах,
накопленный нарастающим итогом. Дробная часть имеет один знак.
Структуры DigitIn, являются опциональными. Таких структур может
быть несколько по числу логических датчиков (дискретных входов и
виртуальных логических датчиков), чьё состояние было активно в момент
замера координаты. Значением параметра является номер активного в момент
измерения местоположения цифрового входа прибора, задействованного на
объекте, или виртуального датчика.
Структуры DigitOut, являющиеся опциональными. Таких структур
может быть несколько,
в зависимости от количества активных на момент
измерения данной координаты выходов. Значением параметра является номер
цифрового выхода, активного в момент определения данного местоположения.
Структуры AnalogIn, являются опциональными. Структур может быть
несколько, в зависимости от количества одновременно измеряемых на объекте
аналоговых величин. Параметр num
задает номер аналогового входа,
измеренное значение которого посылается вместе с данной координатой.
Параметр val задает значение измеренной аналоговой величины. Разделитель
дробной и целой частей - точка. Количество знаков в дробной части
определяется
точностью
измерения
величины,
достигаемой
бортовым
оборудованием, но общее количество значащих цифр целой и дробной частей
вместе не должно превышать 15 знаков
Структура PortData опциональна и содержит в себе два параметра:
port - номер порта бортового оборудования, через который подключено
дополнительное измерительное оборудование, с которого пришло данное
сообщение, recvd - является base64 закодированная строка полученного с
порта байтового потока.
Структура Multimedia является опциональной и парой параметров
задает тип содержимого передаваемой мультимедийной информации - mmtp (в
представлении MIME type) и само содержимое, base64 кодированное, - read.
Пример ответа Сервера на запрос местоположения объекта:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:GetCoordResponce>
<ObjectID>79032058458</ObjectID>
<Coord
time="2010-01-29T01:28:01Z"
lon="37.754689"
lat="55.6586458"
speed="20.1" dir="301" valid="1"/>
</ws:GetCoordResponce>
</soapenv:Body>
</soapenv:Envelope>
Пример отправки телематического сообщения от полнофункционального
AVL оборудования:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:GetCoordResponce>
<ObjectID>80066670</ObjectID>
<Coord
time="2010-01-29T01:28:01Z"
lon="37.754689"
lat="55.6586458"
speed="20.1" dir="301" valid="1"/>
<AddInfo motion="1" dist="0" online="1" mileage="321.1"/>
<DigI inpnum="1"/>
<DigI inpnum="9"/>
<DigO outnum="1"/>
<AnalogI num="1" val="0.05"/>
<AnalogI num="10" val="662.5"/>
<PortData port="3" recvd="abcd1280"/>
</ws:GetCoordResponce>
</soapenv:Body>
</soapenv:Envelope>
Если Серверу не удалось получить информацию о местоположении и
состоянии запрашиваемого объекта, то он возвращает сообщение о сбое вида:
<?xml version='1.0' encoding="windows-1251"?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
<env:Body>
<env:Fault>
<env:Code>
<env:Value>env:Receiver</env:Value>
</env:Code>
<env:Reason>
<env:Text xml:lang="en-US">No location info</env:Text>
</env:Reason>
</env:Fault>
</env:Body>
</env:Envelope>
Формат сообщений сервиса приема запроса на отправку команды на
объект
Если необходимо передать команду на абонентское оборудование,
установленное на объекте, то Клиент инициирует передачу следующего XML
документа:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:SendCommand>
<ObjectID>ObjectNumber</ObjectID>
<CommandID>CommandIdentity</CommandID>
<CommandString>CommandToSend</CommandString>
</ws:SendCommand>
</soapenv:Body>
</soapenv:Envelope>
Все параметры обязательны. ObjectNumber задает идентификатор
объекта, на который должна быть отправлена команда. CommandID задает
уникальный идентификатор команды так, чтобы клиентская сторона позже
могла однозначно связать данный идентификатор, используемый, например,
в ответе на команду, с исходным идентификатором переданным в данном
пакете. Целое число в десятичной системе исчисления от 1 до 2147483647.
CommandString задает содержимое передаваемой команды. Зависит от
типа абонентского оборудования на объекте.
В ответ на данный запрос Сервер передает статусное ответное
сообщение SendCommandResponce или сообщение об ошибке, указывая
Envelope.Body.Fault.Reason.Text соответствующую причину ошибки, которая
привела к невозможности принятия команды для отправки на объект.
Формат ответа в случае успешного приёма команды:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:SendCommandResponce>
<ObjectID>ObjectNumber</ObjectID>
<CommandID>CommandIdentity</CommandID>
</ws:SendCommandResponce>
</soapenv:Body>
</soapenv:Envelope>
При постановке в очередь команд на отправку Сервер должен
сохранять идентификатор команды, полученный в данном пакете. Кроме
того, при отслеживании подтверждений команд он должен сопоставлять
какой ответ от абонентского оборудования объекта соответствует какой
ранее посланной на него команде, чтобы однозначно связывать строку ответа
с изначальным идентификатором команды.
Формат сообщений сервиса приема запроса на отправку сообщения на
объект с вариантами ответа
Если
необходимо
передать
текстовое
сообщение
на
абонентское
оборудование, установленное на объекте, возможно, с предлагаемыми
вариантами ответа, то Клиент инициирует передачу следующего XML
документа:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:SendMessage>
<ObjectID>ObjectNumber</ObjectID>
<MessageID>MessageIdentity</MessageID>
<MessageText>MessageToSend</MessageText>
<Answer num="Answer_number">AnswerString</Answer>
...
</ws:SendMessage>
</soapenv:Body>
</soapenv:Envelope>
Параметры ObjectID, MessageID, MessageText обязательны и
задают идентификатор объекта, идентификатор сообщения и текст сообщения
для передачи на объект.
Далее идет произвольное количество необязательных структур Answer, в
которых параметр num задает порядковый номер ответа, а содержимое самого
тега определяет текст варианта ответа.
В ответ на данный запрос Сервер передает статусное ответное
сообщение SendMessageResponce или сообщение об ошибке, указывая
Envelope.Body.Fault.Reason.Text соответствующую причину ошибки, которая
привела к невозможности принятия сообщения для отправки на объект.
Формат ответа в случае успешного приёма сообщения:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:SendMessageResponce>
<ObjectID>ObjectNumber</ObjectID>
<MessageID>MessageIdentity</MessageID>
</ws:SendMessageResponce>
</soapenv:Body>
</soapenv:Envelope>
Получение абонентским оборудованием сообщения и отображение его на
экране квитируется как обычная команда. Поэтому значение параметра
MessageID должно быть уникальным и среди идентификаторов сообщений, и
среди идентификаторов команд CommandID. После получения Сервером
подтверждения
доставки
сообщения,
сервер
инициирует
отправку
подтверждения выполнения команды.
Формат сообщений сервисов Клиентской стороны
Формат сообщений сервиса приема местоположение и состояния
объекта
Данным сервисом пользуется Сервер, когда по собственной инициативе
передает местоположение объекта (например, сразу после поступления
навигационной посылки с бортового оборудования в связной шлюз Сервера).
При этом он передает XML документ, практически, совпадающий с
документом GetCoordResponce, за исключением самого названия структуры
внутри Envelop.Body, которая, в данном случае, носит название PutCoord.
Список подчиненных структур, параметров, их обязательность и смысл
полностью совпадают с документом GetCoordResponce.
В ответ на данный запрос Клиент передает статусное ответное сообщение
PutCoordResponce
или
сообщение
об
ошибке,
указывая
Envelope.Body.Fault.Reason.Text соответствующую причину ошибки, которая
привела к невозможности принятия команды для отправки на объект.
Формат ответа в случае успешного приёма координатной посылки:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:PutCoordResponce>
<ObjectID>ObjectNumber</ObjectID>
</ws:PutCoordResponce>
</soapenv:Body>
</soapenv:Envelope>
Если Клиент подтвердил получение координаты, то Сервер уничтожает ее
из своего временного хранилища для данного Клиента.
Формат сообщений сервиса приема сообщений, поступивших от объекта
Данным сервисом пользуется Сервер, когда по собственной инициативе
передает
поступившее
от
объекта
текстовое
сообщение.
При
этом
инициируется документ PutMessage.
Формат ответа в случае успешного приёма сообщения:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:PutMessage>
<ObjectID>ObjectNumber</ObjectID>
<MessageText>MessageFromObject</MessageText>
<Time>KMLTimeStamp</Time>
</ws:PutMessage>
</soapenv:Body>
</soapenv:Envelope>
Параметр
задает идентификатор объекта, с которого
ObjectID
поступило сообщение. Параметр MessageText определяет непосредственно
переданный текст. Параметр Time определяет момент времени, когда была
инициирована отправка сообщения с бортового оборудования. Подчиняется
правилам
представления
и
дешифрации.
Все
параметры
являются
обязательными.
В ответ на данный запрос Клиент передает статусное ответное
сообщение PutMessageResponce или сообщение об ошибке, указывая
Envelope.Body.Fault.Reason.Text соответствующую причину ошибки, которая
привела к невозможности принятия команды для отправки на объект.
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:PutMessageResponce>
<ObjectID>ObjectNumber</ObjectID>
</ws:PutMessageResponce>
</soapenv:Body>
</soapenv:Envelope>
Если клиент подтвердил получение сообщения, то Сервер уничтожает его
из своего временного хранилища для данного Клиента.
Формат
сообщений
сервиса
приема
подтверждений
на
ранее
переданные на объект команды
Данным сервисом пользуется Сервер, когда по собственной инициативе
передает
поступившее
от
объекта
подтверждение
выполнения
ранее
переданной на объект команды (или ошибку выполнения команды). При этом
инициируется документ PutComAnswer.
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:PutComAnswer>
<ObjectID>ObjectNumber</ObjectID>
<CommandID>CommandIdentity</CommandID>
<Time>KMLTimeStamp</Time>
<AnswerOk>Ok_or_Not</AnswerOk>
<AnswerString>CommandAnswerString</AnswerString>
</ws:PutComAnswer>
</soapenv:Body>
</soapenv:Envelope>
Параметр ObjectID задает идентификатор объекта, подтверждение
команды с которого поступило на Сервер. Параметр CommandID указывает
идентификатор команды, который был указан в момент инициирования
команды Клиентом и подтверждение или ошибка на которую поступило с
объекта.
Параметр
Time
определяет
момент
времени,
когда
была
инициирована отправка подтверждения выполнения команды с бортового
оборудования. Подчиняется правилам представления и дешифрации. Параметр
AnswerOk устанавливается в 1, если команда выполнена успешно, 0, если
возникла ошибка во время выполнения команды на абонентском оборудовании.
Все указанные параметры являются обязательными.
Необязательный параметр AnswerString, представляет строку ответа
абонентского оборудования в результате выполнения команды или ошибки. В
частности, если сутью команды являлся запрос некоторого конфигурационного
параметра бортового оборудования, то в содержимое параметра переносится
полностью текст ответа абонентского оборудования.
В ответ на данный запрос Клиент передает статусное ответное сообщение
или
PutComAnswerResponce
сообщение
об
ошибке,
указывая
Envelope.Body.Fault.Reason.Text соответствующую причину ошибки, которая
привела к невозможности принятия команды для отправки на объект.
Формат
ответа
в
случае
отправленную ранее команду:
успешного
приёма
подтверждения
на
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:PutComAnswerResponce>
<ObjectID>ObjectNumber</ObjectID>
<CommandID>CommandIdentity</CommandID>
</ws:PutComAnswerResponce>
</soapenv:Body>
</soapenv:Envelope>
Если клиент подтвердил получение подтверждения на отправленную
ранее команду, то Сервер уничтожает его из своего временного хранилища для
данного Клиента.
Формат сообщений сервиса приема подтверждений о прочтении и
варианта ответа на ранее переданное на объект сообщение
Данным сервисом пользуется Сервер, когда по собственной инициативе
передает поступившее от объекта
подтверждение о прочтении ранее
переданного сообщения (возможно, с выбранным вариантом ответа). При этом
инициируется документ PutMsgAnswer.
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:PutMsgAnswer>
<ObjectID>ObjectNumber</ObjectID>
<MessageID>MessageIdentity</MessageID>
<Time>KMLTimeStamp</Time>
<Answer>AnswerNum</Answer>
</ws:PutMsgAnswer>
</soapenv:Body>
</soapenv:Envelope>
Параметр ObjectID задает идентификатор объекта, подтверждение
прочтения сообщения с которого поступило на Сервер. Параметр MessageID
указывает идентификатор сообщения, который был указан в момент
инициирования сообщения Клиентом и подтверждение о прочтении на которое
поступило с объекта. Параметр Time определяет момент времени, когда
бортовым оборудованием был зафиксирован факт прочтения отправленного
ранее сообщения или был выбран вариант ответа на сообщение. Подчиняется
правилам представления и дешифрации. Все указанные параметры являются
обязательными.
Далее следует необязательный параметр Answer, который представляет
номер выбранного ответа, если вместе с исходным с сообщением передавались
варианты ответа. Если данный параметр отсутствует, то поступление XML
документа означает факт прочтения переданного ранее сообщения, в котором
не было указано вариантов ответа.
В ответ на данный запрос Клиент передает статусное ответное сообщение
PutMsgAnswerResponce
или
сообщение
об
ошибке,
указывая
Envelope.Body.Fault.Reason.Text соответствующую причину ошибки, которая
привела к невозможности принятия команды для отправки на объект.
Формат ответа в случае успешного приёма подтверждения о прочтении
или варианта ответа на отправленное ранее сообщение:
<?xml version="1.0" encoding="windows-1251"?>
<soapenv:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope">
<soapenv:Header/>
<soapenv:Body>
<ws:PutMsgAnswerResponce>
<ObjectID>ObjectNumber</ObjectID>
<MessageID>MessageIdentity</MessageID>
</ws:PutMsgAnswerResponce>
</soapenv:Body>
</soapenv:Envelope>
Если клиент подтвердил получение подтверждения о прочтении или
варианта ответа на сообщение, то Сервер уничтожает его из своего временного
хранилища для данного Клиента.
Статус документа
Версия документа 1.4.
Документ имеет статус спецификации.
В процессе жизненного цикла систем мониторинга объектов список
параметров, атрибутов и их значений может быть изменен и уточнен по
согласованию подписывающих сторон.
Приложение № 4
к договору о взаимодействии
и информационном обмене
в сфере навигационной деятельности
от ___________№ _____
Наименование
Адрес:
, телефон/факс
____________________________________
(регистрационный номер)
, E-mail-
В Управление государственного автодорожного
надзора по
____________________________________
(дата регистрации)
З А Я В Л Е Н И Е
Прошу Вас протестировать абонентский телематический терминал с целью контроля
работоспособности, полноты и достоверности передачи абонентским телематическим терминалом
мониторинговой информации и выдать свидетельство о подтверждении оснащения транспортного
средства
1. Сведения о владельце транспортного средства
Наименование юридического лица или фамилия,
имя, отчество индивидуального предпринимателя
ИНН / ОГРН
Адрес
Телефон (с указанием кода города)
Факс
Адрес электронной почты (E-mail)
2. Сведения о транспортном средстве
Государственный регистрационный знак
Идентификационный номер (VIN)
Марка, модель, категория транспортного средства
Год изготовления
Серия, номер, дата выдачи свидетельства о
регистрации транспортного средства
Серия, номер, дата выдачи паспорта транспортного
средства
Собственник транспортного средства
Основания владения транспортного средства, срок
действия документа подтверждающего основание
владения ТС
Характеристики транспортного средства по видам
перевозок
3. Сведения об абонентском телематическом терминале
Об операторе, обслуживающем телематический
терминал
О региональном навигационно-информационном
центре, в который предоставляется информация от
оператора обслуживающего абонентский
терминал
Марка, модель, фирма-изготовитель
Версия программного обеспечения
Рабочие частоты радиостанции, прочие
технические характеристики
Серийный номер (при наличии)
Универсальный идентификационный номер (UIN)
IP-адрес в системе диспетчерского управления и
мониторинга
Идентификационные данные (при наличии)
Приложение:
_____________________________________________________________________
__
(должность, Ф.И.О, подпись)
« » _________ 201__ г.
М.П.
Приложение № 5
к договору о взаимодействии
и информационном обмене
в сфере навигационной деятельности
от ___________№ _____
Свидетельство серия ___ № ______
подтверждения оснащения ТС абонентским телематическим терминалом
от « ___ » ___________ 201__ года
1. Выдано
Наименование юридического лица или
ФИО ИП
Адрес
Телефон/Факс/e-mail
Информация о ТС
М1
М2
М3
N1
N2
N3
Категория ТС по классификации КВТ ЕЭК ОООН
Гос. рег. знак
Марка и модель ТС
Идент. номер (VIN)
Категория ТС
Год выпуска ТС
Собственник ТС
ПТС
Свидетельство о рег. ТС
2. Данные об абонентском телематическом терминале:
Марка и модель абонентского терминала
Фирма изготовитель АТ
Версия ПО
Идентификационный номер абонентского
терминала (ID)
Номер телефона sim-карты в АТ
Наличие модуля ГЛОНАСС или ГЛОНАСС/GPS
Да
Нет
Наличие гарнитуры и модуля двусторонней
голосовой связи
Да
Нет
Соответствие протоколам передачи информации
определенным Приказом Минтранса № 285 от
31.07.2012 г.
Да
Нет
Соответствие требованиям к АТ, определенным
Приказом Минтранса № 285 от 31.07.2012 г.
Да
Нет
IP-адрес в системе диспетчерского управления и
мониторинга
Тестирование проведено
______________________________________________________________
______________________________
Генеральный директор ___________________________" _________________ /_____ ____________
____
Подпись
ФИО
МП
3. Информация о подключении абонентского терминала к региональному навигационноинформационному центру (заполняется УГАДН по субъекту РФ)
Доступен к отображению в системе
Да
Нет
Отображение в системе события о
нажатии тревожной кнопки
Да
Нет
Свидетельство выдано на срок до « _____» _____________ 20_____ года
Начальник _______________________
________________________________________
/__________________ __
_____________________
Подпись
ФИО
МП