Us gps: различия между версиями

Версия от 18:07, 28 февраля 2015

US_GPS - это модуль, который может принимать информацию от GPS-трекеров и программ мониторинга с целью фиксирования позиции персонала и автотранспорта. Информация о позиции этих объектов и их маршрутах может помогать в более быстром решении аварийных ситуаций, т.к. эти объекты выводятся на карту покрытия и можно оперативно понимать какого сотрудника, что рядом находится следует отправить на решение проблем.

ВАЖНО: На данный момент модуль поддерживает следующие треккеры:

Traccar Client (Android/iOS-устройства. Приложение). https://www.traccar.org/client/
GT-06
GT-02
GPS/TK-102/103/104

Для добавления иных моделей треккеров - свяжитесь с нами.

Таким образом - можно установить клиент на смартфон/планшет сотрудника, оснащенный GPS-модулем, либо настроить аппаратные GPS-треккеры на передачу информации на свой сервер и начать получать данные.

Общие данные

Язык модуля: Perl

Текущая версия: см. на странице: Модули

Статус модуля: Платный

Необходимые модули Perl:

DBI
Time::Local
FindBin
IO::Socket

Информацию по установке модуля и общую информацию для всех модулей см. на странице: Модули

Настройка модуля осуществляется в файле us_config.tmp

Параметры

$zuserver - адрес сервера с UserSide
$zuuser - имя пользователя для доступа к базе UserSide
$zupass - пароль для доступа к базе UserSide
$zubase - имя базы данных UserSide
$ps_logpath - путь к логам модуля
$zsilence - не выводить уведомления о работе модуля в консоль
$zport - порт, на котором слушаем сообщения от GPS-устройств

Запуск модуля

Настройка - Модули - us_gps - Включаем работу модуля

Запускаем для теста модуль вручную и убедимся, что ошибок не возникает

perl us_gps.pl

Модуль требуется прописать в системный cron с частотой запуска - раз в 4 часа.

* /4 * * * perl us_gps.pl &> /dev/null

При повторном запуске модуль уничтожит свою предыдущую копию. Периодический перезапуск обеспечивает более высокую стабильность работы, т.к. закрывает все "зависшие" соединения и буфера.

Настройка GPS-треккеров и приложений

По-умолчанию модуль слушает порт 5005. А IP-адресом выступает адрес сервера, где запущен модуль. Используйте эти параметры в настройке GPS-устройств/приложений.

Логика работы

Модуль работает многопоточно, параллельно поддерживая связь либо принимая пакеты от множества устройств

Требуется указать правильные IMEI всем контролируемым объектам (см.ниже). Если на модуль будет поступать информация от незарегистрированных устройств, то он будет её отбрасывать

Частота фиксации информации зависит исключительно от того, как часто устройство присылает её. Все записи будут зафиксированы.

Информация фиксируется по времени, которое присылает устройство. При этом время конвертируется в локальное время (из UTC). Некоторые устройства могут присылать информацию за тот период, когда у них не было связи с сервером. Эту старую информацию модуль тоже зафиксирует

Обратите внимание, что GPS-устройства не всегда имеют точные данные о своём местоположении. Это зависит от уровня сигнала GPS-приемника, времени работы и пр. Таким образом объект, который находится на одном месте и постоянно передаёт свои координаты - казалось бы должен выводится на карте в одной точке, но на самом деле получится замысловатая картина.

Использование

В карточке сотрудника или карточке автотранспорта есть поле для ввода IMEI GPS-устройства

После того, как модуль включен - на карте покрытия будет доступен новый слой

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

Имеется возможность просмотра позиций и маршрутов за более ранний период.

@@ Строка 10: / Строка 10: @@
 Для добавления иных моделей треккеров - свяжитесь с нами.
+Таким образом - можно установить клиент на смартфон/планшет сотрудника, оснащенный GPS-модулем, либо настроить аппаратные GPS-треккеры на передачу информации на свой сервер и начать получать данные.
@@ Строка 39: / Строка 41: @@
   $zsilence - не выводить уведомления о работе модуля в консоль
   $zport - порт, на котором слушаем сообщения от GPS-устройств
- $zlost_count - не опрашивать неактивные устройства N-циклов запуска ''(в случае определения их неактивности)''. По-умолчанию: 5
 == Запуск модуля ==
@@ Строка 50: / Строка 51: @@
 [[Файл:2015_02_28_19_02_37_2.PNG|thumb|800px|center]]
-Опрос параметров выполняется в многопоточном режиме. По 500 параметров на поток.
 Модуль требуется прописать в системный cron с частотой запуска - раз в 4 часа.
@@ Строка 59: / Строка 58: @@
 При повторном запуске модуль уничтожит свою предыдущую копию. Периодический перезапуск обеспечивает более высокую стабильность работы, т.к. закрывает все "зависшие" соединения и буфера.
+== Настройка GPS-треккеров и приложений ==
+По-умолчанию модуль слушает порт 5005. А IP-адресом выступает адрес сервера, где запущен модуль. Используйте эти параметры в настройке GPS-устройств/приложений.
 == Логика работы ==
-* Каждый запуск модуль проверяет состояние SNMP-параметров у контролируемых устройств. Если значение параметра выходит за пределы допустимого, то считается, что произошла тревога. Тревожных параметров на устройстве может быть несколько. По каждому устройству, где был найден тревожный параметр или наоборот - параметр пришёл в норму - формируется электронное письмо и/или SMS для выбранного ''(на уровне каждого устройства)'' круга получателей
+* Модуль работает многопоточно, параллельно поддерживая связь либо принимая пакеты от множества устройств
-* По каждому устройству формируется отдельное письмо/сообщение, в котором будут все параметры, состояние ''(тревога/норма)'' которых изменилось. В письме информация будет представлена развёрнуто, в SMS - компактно
-* Следующее сообщение будет прислано только в случае, если изменился вновь какой-то параметр
-* Если в процессе опроса будет выяснено, что опрашиваемое устройство неактивно ''(в процессе подключения к устройству произошла ошибка, либо возникла ошибка при съёме параметра)'', то это будет отмечено модулем и в следующие несколько циклов запуска ''(по-умолчанию: 5)'' это устройство опрашиваться не будет, чтобы не создавать задержек в опросе прочих параметров.
-* Для устройств, с которых удалось получить параметры - будет обновлена дата последней активности.
-* Если указан ошибочный параметр ''(OID)'', то при опросе устройства - на этом параметре опрос данного устройства будет прекращен.
-В случае, если модуль перестал запускаться - на главной странице для операторов, имеющих доступ в настройку системы, будет выводиться соответствующее сообщение
-[[Файл:22.PNG|thumb|800px|center]]
-Если модуль выявит нарушение параметров, то кроме уведомления средствами связи, будет выведено также информационное сообщение на главной странице
-[[Файл:23.PNG|thumb|800px|center]]
-== Общая настройка ==
-[[Файл:2014_12_03_22_39_56.png|thumb|800px|center]]
-Для начала требуется указать список контролируемых параметров и события, при которых считать, что значения этих параметров вышли из нормы.
-[[Файл:2014_12_03_22_56_49.png|thumb|800px|center]]
-Параметры можно компоновать в профили опроса
-[[Файл:24.PNG|thumb|800px|center]]
-[[Файл:2014_12_03_22_43_04.png|thumb|800px|center]]
-Для всех параметров, которые опрашиваются на данный момент, можно посмотреть текущее состояние и наличие тревог
+* Требуется указать правильные IMEI всем контролируемым объектам ''(см.ниже)''. Если на модуль будет поступать информация от незарегистрированных устройств, то он будет её отбрасывать
-[[Файл:2014_12_03_22_39_02.png|thumb|800px|center]]
+* Частота фиксации информации зависит исключительно от того, как часто устройство присылает её. Все записи будут зафиксированы.
-Ведётся лог опроса параметров ''(не все значения, а только их изменения)'', который хранится в базе системы
+* Информация фиксируется по времени, которое присылает устройство. При этом время конвертируется в локальное время ''(из UTC)''. Некоторые устройства могут присылать информацию за тот период, когда у них не было связи с сервером. Эту старую информацию модуль тоже зафиксирует
-[[Файл:2014_12_03_22_44_33.png|thumb|800px|center]]
+* Обратите внимание, что GPS-устройства не всегда имеют точные данные о своём местоположении. Это зависит от уровня сигнала GPS-приемника, времени работы и пр. Таким образом объект, который находится на одном месте и постоянно передаёт свои координаты - казалось бы должен выводится на карте в одной точке, но на самом деле получится замысловатая картина.
-Имеется также и текущий список опрашиваемых устройств
+[[Файл:2015_02_28_19_02_37_3.PNG|border|center]]
-[[Файл:29.PNG|thumb|800px|center]]
+== Использование ==
-== Настройка в карточке устройства ==
+В карточке [[Персонал|сотрудника]] или карточке [[Автотранспорт|автотранспорта]] есть поле для ввода IMEI GPS-устройства
-При редактировании карточки [[Оборудование|оборудования]] доступен блок, в котором можно выбрать профиль опроса для данного устройства, указать какие-то отдельные параметры для опроса, что не входят в выбранный профиль и указать получателей сообщений о тревоге
+[[Файл:2015_02_28_19_59_32.png|thumb|800px|center]]
-[[Файл:28.PNG|thumb|800px|center]]
+После того, как модуль включен - на карте покрытия будет доступен новый слой
-В режиме просмотра блок модуля также выводится и из него есть возможность просмотреть текущее состояние параметров и лог изменения их состояния
+[[Файл:2015_02_28_19_59_32_2.PNG|border|center]]
-[[Файл:25.PNG|thumb|800px|center]]
+При его включении - на карте будут отображены маркеры с текущим расположением всех контролируемых объектов, по которым '''сегодня были получены данные''' о позиции. При нажатии на маркер - отобразится маршрут перемещений объекта за сегодня. Точки на маршруте показывают время передачи показаний.
-[[Файл:26.PNG|thumb|800px|center]]
+Имеется возможность просмотра позиций и маршрутов за более ранний период.
-[[Файл:27.PNG|thumb|800px|center]]
+[[Файл:2015_02_28_19_59_32_3.PNG|border|center]]