Просмотр кода страницы Us gps

'''ВНИМАНИЕ: Данный модуль является устаревшим и более не продаётся. Рекомендуется перейти на модуль [[usm_gps 2|usm_gps]]'''


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


'''Мы не позиционируем этот модуль как систему мониторинга транспортом и потому не стоит ожидать от модуля подобный функционал. Его основная задача - отобразить текущее местонахождение сотрудника или автомобиля, а не контролировать пробег, расход бензина и т.п.'''


'''ВАЖНО:'''
На данный момент модуль поддерживает следующие треккеры:
* Traccar Client (Android/iOS-устройства. Приложение). https://www.traccar.org/client/
* GT-06
* GT-02
* GPS/TK-102/103/104
* Автофон Маяк 5
* OKO-NAVI
* h02
Для добавления иных моделей треккеров - свяжитесь с нами.


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


== Общие данные ==

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

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

'''Статус модуля:''' [http://userside.ua/price.php Платный]

Необходимые модули Perl:
 DBI
 Time::Local
 FindBin
 IO::Socket

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

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

== Параметры ==
 $usUrl    - URL к ERP "UserSide"
 $usApiKey - API-ключ ERP "UserSide" ''(Указывается в файле "userside3/main/config/config.php")''
 $ps_logpath - путь к логам модуля
 $zsilence - не выводить уведомления о работе модуля в консоль
 $zport - порт, на котором слушаем сообщения от GPS-устройств

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

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

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

 perl us_gps.pl

[[Файл:2015_02_28_19_02_37_2.PNG|thumb|800px|center]]

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

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

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

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

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

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

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

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

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

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

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

[[Файл:2015_02_28_19_02_37_3.PNG|border|center]]

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

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

[[Файл:2015_02_28_19_59_32.png|thumb|800px|center]]

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

[[Файл:2015_02_28_19_59_32_2.PNG|border|center]]

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

[[Файл:2015_02_28_19_59_32_4.PNG|thumb|800px|center]]

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

[[Файл:2015_02_28_19_59_32_3.PNG|border|center]]


== Установка модуля usm_gps (для Traccar) ==

Работа приложения Traccar с конца 2014 года идёт по новому протоколу "osmand". Для его работы требуется настроить модуль usm_gps

Это потребует изменений в настройке веб-сервера, где установлен userside

1. Выделите отдельный каталог в web-каталоге с userside. Абсолютно произвольный. Также создайте отдельный каталог для логов модуля. Не забудьте указать для него права на запись.

2. Перенесите туда файлы из архива модуля (usm_gps). Пример файла конфигурации "usm_gps.conf.php-example" переименуйте в "usm_gps.conf.php". В нём выполните настройку параметров. Перечень возможных параметров указан ниже.

3. Настройте веб-сервер:

3.1. В файле apache/conf/httpd.conf:

 - добавьте строку 
 
 Listen 5055
 
 - раскомментируйте строку
  
 Include conf/extra/httpd-vhosts.conf
 
3.2. В файле apache/conf/extra/httpd-vhosts.conf добавьте блок (настроив под себя)

 <VirtualHost *:5055>
    DocumentRoot "/usr/local/.../usm_gps"
    ServerName gps
    ServerAlias gps
    ErrorLog "logs/gps-error.log"
    CustomLog "logs/gps-access.log" common
    Options Indexes FollowSymLinks
    DirectoryIndex usm_gps.php
 </VirtualHost>

4. Перезапустите веб-сервер

5. Попробуйте открыть в адресной строке адрес своего веб-сервера:порт

 http://127.0.0.1:5055

Должны создаться логи работы модуля.

Если не создался лог usm_gps.log - то запустите вручную один раз модуль в консоли сервера

 php usm_gps.php

6. Прописываем в приложении Traccar - обращение к нужному IP-адресу и нужному порту (5055)

== Параметры usm_gps.conf.php ==

 $usersideUrl - URL к ERP UserSide
 $usersideApiKey - UserSide [[API]]-key ''(userside/main/config/config.php)''
 $logPath - путь к каталогу для логов
 $isSilence - флаг - выводить ли сообщения в консоль