**''Документация по модулю GPS и принадлежащим к нему страницам перенесена в Confluence''**\\
[[http://abills.net.ua:8090/display/AB/GPS]]

==== GPS Tracker ====

**Возможности:**
  * Учёт местоположения сотрудника 
  * Отчёт по пройденному пути
  * [[abills:docs:manual:gps_tracker:route|Просмотр маршрута сотрудника за каждый день]]
  * [[abills:docs:manual:gps_tracker:last_location|Увидеть последнее местоположение сотрудника ( + заряд батареи ) ]]

=== Установка ===
Залить в базу дамп GPS.sql
  mysql --default-character-set=utf8 -D abills < /usr/abills/db/GPS.sql

Подключаем модуль 'GPS' **libexec/config.pl**
  @MODULES = (
              'GPS'
             );

Делаем линк в папку ''libexec''.
  cd /usr/abills/libexec
  chmod +x ../misc/gps_tracker/gps_server.pl
  ln -s ../misc/gps_tracker/gps_server.pl .
\\
Лучше всего прописать в **/etc/crontab** c частотой запуска 1 час. 
<code>
1 * * * * root /usr/abills/libexec/gps_server.pl PORT=8790 LOG_FILE=/tmp/gps_tracker.log -d
</code>

Программа работает в режиме демона (Server.pm).

\\
**Не забудьте открыть порт 8790**

**Проверка запущен ли сервер**
<code>
telnet localhost 8790
Trying ::1...
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
test

HTTP/1.1 200 OK
</code>

**HTTP/1.1 200 OK** - значит работает

=== Сервер ===
Внешняя программа ''/usr/abills/misc/gps_tracker/gps_server.pl'' Принимает даные от клиентов и складывает в таблицу `gps_tracker_locations`.\\
\\
ПАРАМЕТРЫ
^ PORT=8790   | Порт на котором принимать запросы от клиентов | 
^ DEBUG=1..7  | Режим дебага. 7 - показывать запросы к базе |
^ LOG_FILE=/path/to/file.log | Файл лога | 
^ -d          | Запускать в режиме демона|

=== Клиенты (трекеры) ===
=== Android ===
  * [[abills:docs:manual:gps_tracker:clients|Traccar клиент]]


=== Переменные config.pl ===
^ $conf{GPS_MISTAKE}='0.01'; | минимальное расстояние между координатами, которое учитывается при выводе отчёта, в километрах  |


=== Вебинтерфейс ===

  * [[abills:docs:manual:admin:gps:gps_tracked_admins|Мониторинг/GPS/Отслеживаемые администраторы]]\\

  * [[abills:docs:manual:admin:GPS:gps_unregistered_trackers|Мониторинг/GPS/Не зарегистрированные Трекеры]]\\

  * [[abills:docs:manual:admin:gps:gps_report|Отчёт\GPS]]


=== Maps ===
Логично, что модуль интегрируется с модулем ''Maps''. \\
\\
При подключении модуля в меню Слои появляется слой GPS, на котором отображаются последнее местоположение всех администраторов у которых есть координаты.\\
\\
При нажатии на маркер администратора, отображается информация о том, что это за администратор и время последнего обновления местоположения.\\
\\
При нажатии на кнопку "Маршрут" загрузятся последние 1440 точек маршрута администратора ( за сутки по точке каждые 5 минут ).