Интеграция "Планар-Зенит" с "МТС Поиск"

Система мониторинга Планар-Зенит теперь позволяет отображать данные о местоположении абонентов сети МТС, зарегистрированных в сервисе  МТС поиск.

МТС поиск -  это сервис определения местоположения пользователей от МТС. Кроме определения местоположения пользователя сервис предоставляет различные связанные услуги. Например: "Сотрудники" (Контроль перемещений сотрудников) , "Транспорт" (Мониторинг транспорта), "Координатор" (Управление разъездными сотрудниками, задачи, отметки, статусы) и др.

Как это работает?

Сервис "МТС поиск" предоставляет специальный программный интерфейс для выдачи сведений о своих абонентах. Используя этот интерфейс, специальная служба системы Планар-Зенит периодически запрашивает у МТС необходимую информацию о местоположении мобильных  устройств. Далее эта информация передается серверу Планар-Зенит, под видом данных от абонентских терминалов Планар-Зенит. То-есть, каждый абонент сервиса "МТС поиск" виден в системе Планар-Зенит как один подвижный объект.

Что потребуется сделать, чтобы увидеть абонентов МТС на карте Планар-Зенит?

1) Зарегистрироваться в системе "МТС Поиск" и  добавить абонентов, которых  будем отображать;

2) Подготовить сервер Планар-Зенит к приему данных;

3) Установить сервис интеграции с "МТС Поиском";

4)  Настроить сервис;

5) Добавить абонентов "МТС Поиск"в Планар-Зенит;

1) Регистрация в системе "МТС Поиск"

1) Необходимо зарегистрироваться в системе "МТС Поиск".

Для этого надо пройти по ссылке https://www.mpoisk.ru/signup/Registration/CustomerInfo.

Регистрируется тот человек, который будет администрировать список объектов, управлять тарифом и т.п.

Указываем название компании и регион с часовым поясом.

Указываем имя пользователя, почту и телефон (естественно, все реальное), задаем пароль. Ставим галку, читаем условия использования услуги. Затем нажимаем кнопку Готово 

и бесплатная тестовая регистрация завершена.

Для коммерческого использования услуги (а она нам понадобится) следуем инструкции на экране регистрации. Теперь мы имеем аккаунт для входа на сервис МТС поиск.

2) Теперь нам потребуется добавить абонентов, какие должны отображаться в системе Планар-Зенит, в список абонентов МТС Поиск. Для этого входим в веб интерфейс МТС поиска, используя ранее полученный аккаунт и добавляем нужных абонентов. После того, как абонент добавлен, на его телефон приходит сообщение, чтобы получить его согласие на сообщение сведений о его местоположении в МТС поиск.

Каждому абоненту необходимо задать период автоматического запроса местоположения.

Чем короче период запроса, тем точнее будет вырисовываться трек перемещений в Планар-Зенит, и тем быстрее будет показываться актуальное местоположение абонента.

Но тут следует знать, что каждый запрос в системе МТС поиск стоит денег. Чем короче интервал определения местоположений, тем больше денег придется заплатить. Поэтому, предпочтителен безлимитный тариф, при котором в месяц на каждого абонента тратится одинаковая сумма (350-470 рублей), и число запросов не влияет на итоговую сумму.

Подготовка сервера Планар-Зенит

Прием данных от сервиса связи с "МТС поиском" происходит по протоколу Planar GG (протокол UNP, порт 8085). Это тип приемника номер 5 (см. панель управления сервером Планар-Зенит)

Чтобы прием данных от сервиса мтс работал, нужно включить приемник 5, если он еще не включен. Перезапустите сервер для восприятия новых настроек, и проверьте доступность порта, который выбрали для связи. Если порт доступен, сервер готов к приему данных.

Установка сервиса интеграции

Теперь установим сервис, который будет забирать данные о местоположении абонентов "МТС Поиск", и передавать их в Планар-Зенит. Сервис может быть установлен вручную и автоматически (одновременно с установкой сервера Планар-Зенит). Если надо установить сервис интеграции на компьютер, где уже работает сервер Планар-Зенит, то используем установку вручную. Если ставим на пустой компьютер, где Планар-Зенит  еще не установлен, пользуемся программой установки сервера. Надо только убедиться, что при установке выбран соответствующий компонент (сервис МТС Поиск, присутствует только в актуальных версиях программы установки).

Ручная установка сервиса интеграции

Распакуйте архив MTS_Poisk.zip в папку, где будут находится файлы сервиса. Рекомендуется использовать путь {pf}\ZenitEye\MTS_Poisk. Зайдите в папку и найдите там файл Install.bat. Правой кнопкой мыши щелкните на нем, и выберите пункт меню Выполнить от имени администратора. Или любым другим способом запустите файл Install.bat от имени администратора. Если все в порядке, появится сообщение, что сервис установлен. Теперь сервис зарегистрирован в операционной системе и может быть запущен\остановлен через оснастку Службы.

Настройка сервиса интеграции

Настройка сервиса производится через файл conf.json. Файл имеет следующий формат:

{
    "MtsLogin": "Логин от МТС поиск",
    "MtsPassword": "Пароль от МТС поиск",
    "TcpAddress": "IP адрес\порт сервера Планар-Зенит",
    "Proxy": "Настройки прокси-сервера",
    "UpdateInterval": Период обновления в секундах
}

Откройте файл любым текстовым редактором. И укажите в нем свои настройки:

"MtsLogin"  - здесь мы указываем адрес почты, который вводили для регистрации в системе МТС поиск (см. картинку с поздравлением об успешной регистрации). Обратите внимание, что имя параметра и его значение указываются в кавычках. Имя параметра и его значение отделены друг от друга  двоеточием. Например, если наш логин ivanov@fakemail.ru, то строка в файле настройки будет иметь вид: "MtsLogin": "ivanov@fakemail.ru"

"MtsPassword" - здесь мы указываем пароль для входа в МТС поиск.

"TcpAddress" - Указывается IP и порт сервера Планар-Зенит. Если сервер и сервис интеграции мтс находятся на одном компьютере, можно указать адрес 127.0.0.1. Номер порта надо взять из настроек приемника №5 сервера Планар-Зенит. Адрес и порт при указании настроек должны быть разделены двоеточием, вся настройка должна быть в кавычках.

Пример настройки для порта 1085 и случая когда сервис интеграции находится с сервером Планар-Зенит на одном компьютере: "TcpAddress": "127.0.0.1:1085"

"Proxy"  - если на компьютере используется прокси сервер, потребуется указать его параметры. Если прокси нет, в качестве настройки указываем пустую строку ("Proxy": "").

Если прокси без авторизации, настройка указывается в виде: "http://Адрес:Порт"

Если прокси с авторизацией, настройка указывается в виде: "http://имя:пароль@Адрес:Порт"

 

"UpdateInterval" - Периодичность  обращений  к службе "МТС поиск". Указывается время в секундах. Период обращений должен быть согласован с периодом определения местоположения в системе "МТС Поиск".  Так как местоположение абонента узнается с определенной периодичностью, нет смысла запрашивать эти данные чаще, чем они обновляются. И наоборот, если запрашивать новые сведения реже, чем они появляются, будут теряться часть точек. Допустим, МТС поиск определяет местоположения абонентов с периодом 20 минут. Тогда сервис интеграции должен запрашивать  новые сведения с периодом не более 19 минут. Тогда указываем настройку "UpdateInterval": 1140.

Обратите внимание, числа в настройках указываются без кавычек. 

Новые значения настроек воспринимаются сервисом при запуске.

Добавление абонентов в систему Планар-Зенит

Чтобы добавить в Планар-Зенит абонентов сервиса МТС поиск, нужно знать их  идентификаторы. Идентификатор абонента - это уникальное число, под которым абонент фигурирует в системе "МТС Поиск" (и в "Планар-Зенит").  Надо узнать идентификатор каждого объекта, который был добавлен в "МТС Поиск" и создать в системе Планар-Зенит соответствующий подвижный объект. Однако, когда объект добавляется в МТС Поиск, его идентификатор нигде там не отображается. Доступно только наименование абонента. Сервис mts_poisk.exe сам узнает у "МТС Поиск" список зарегистрированных абонентов и сохраняет их в  виде файла subscribers.txt. Файл лежит в папке с сервисом mts_poisk.exe

Пример содержимого файла:

1471373 Объект 1

1471374 Объект 2

1471375 Объект 3

1471376 Объект 4

Нам потребуется первая колонка в этой таблице, это и есть идентификаторы. Вторая колонка - это наименования (которые видны в системе МТС Поиск). Наименования могут не отображаться, если используется тариф "Эконом", в этом случае появляется проблема, как понять, какому объекту соответствует каждый конкретный идентификатор. Решить эту проблему можно, добавляя в МТС поиск абонентов по одному.  Новый идентификатор, который появится в файле subscribers.txt и будет тот, который только что добавили.

Как только идентификатор объекта становится известным, нужно добавить его в Планар-Зенит. Для этого запустите программу администрирования Планар-Зенит. Создайте новое подразделение под объекты, или откройте уже имеющееся. 

 

 

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

 

 

Когда все объекты добавлены, на этом настройку связки Планар-Зенит-МТС Поиск можно считать завершенной. Заходите в клиентскую программу Планар-Зенит, и там увидите абонентов МТС Поиск.