DroidFleet

Материал из ЛОКАРУС
Перейти к: навигация, поиск

Содержание

Назначение

Программа DroidFleet предназначена для смартфонов, планшетов и др. Функционал программы расчитан на использование руководящим и контролирующим составом на предприятиях с любым количеством транспорта, использующих элементы системы мониторинга транспорта LOCARUS (как минимум - сервер LOCARUS). Предусмотрено иерархическое разделение доступа к различным группам транспорта/персонала. DroidFleet работает с различными приборами для контроля транспорта и носимыми трекерами для контроля персонала.

Возможности

Отслеживание текущего местоположения и состояния транспорта

С сервера загружаются данные по приборам и отображаются на карте. На данный момент кроме положения на карте и направления отображается только скорость. Ее значение можно посмотреть в строке состояния (только если включено слежение) или информационном окне.

Открыть информационное окно можно:

  • Кликнуть на прибор в выдвигаемом меню.
  • Кликнуть на иконку прибора на карте.

Примечание: Эти действия могут переключить режим слежения.


У каждого прибора кроме текущего положения рисуется история его перемещения длительностью не более 10 минут.

Режим слежения за выбранным транспортом

В этом режиме:

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

Чтобы включить режим слежения можно:

  • Кликнуть на прибор в выдвигаемом меню.
  • Кликнуть на иконку прибора на карте.

Чтобы выключить режим слежения можно:

  • Кликнуть на выбранный прибор в выдвигаемом меню.
  • Кликнуть на иконку выбранного прибора на карте *.

Фон пункта этого меню говорит об активности режима слежения: красный - включен, синий - нет.

Об изменении текущего прибора и режима слежения будут показаны соответствующие всплывающие сообщения.

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

Отображение истории перемещений транспорта

Пример трека.

Позволяет отобразить историю перемещений выбранного транспорта за указанный промежуток времени.

Для этого нужно в главном окне выбрать пункт меню "Трек", выбрать граничные даты и нажать кнопку "ОК". Прогресс отображения трека отображается в строке состояния (в нижней части экрана), с указанием последней точки и процента готовности.

Во время отображения трека блокируются некоторые возможности программы, например открытие окна настроек. Если нужно остановить отображение трека, то нужно ОДИН раз нажать кнопку назад. После успешного завершения отображения трека или его остановке будет показано сообщение об этом.

Вместе с треком отображаются знаки остановок, кликнув на которые можно узнать дату и длительность остановки.

Также на треке через равные промежутки отображается направление движения в виде стрелок. Частота стрелок зависит от масштаба карты. (Чем больше масштаб тем больше стрелок).

Кликнув на трек, можно узнать дату и скорость в данной точке трека. (Примечание: окно с информацией о точке появляется не сразу, так как поиск наиболее близкой точки трека к нужной точке занимает некоторое время.)

Кликнув на стрелку можно узнать дату и скорость в данной точке трека.

Чтобы убрать окно с информацией нужно кликнуть по карте далеко от трека или удалить трек с помощью главного меню.

В режиме отображения трека камера перемещается к последней известной точке трека.

Отображение текущего местоположения пользователя

На главном окне присутствуют:

  • Иконка "мое местоположение".
  • Кнопка "Показать мое местоположение".

Нажатие на кнопку "Показать мое местоположение" перемещает камеру к моему местоположению, если оно известно, и отключает режим слежения, если включен.

Мое местоположение может определяется многими способами (wifi,GPS,AGPS). Используемые способы выбираются в настройках Android. Наиболее быстро работает определение местоположения по wifi. Наиболее длительным (особенно, если холодный старт) и наиболее точным является GPS.

Примечание: Иконка "Мое местоположение" не отображается, если оно не определено. Кнопка "показать мое местоположение" также не работает, если не было определено местоположение.

Назначение программных и пользовательских иконок для транспорта

Программа содержит набор стандартных иконок, которые можно использовать вместо стандартной иконки транспорта. Также программа позволяет использовать пользовательские иконки, если стандартных не достаточно. Для этого следует поместить иконки в формате png в папку /sdcard/DroidFleet/.

Изменение иконки выполняется в окне настроек приборов.

Быстрое переключение между приборами

Можно быстро переключаться между приборами используя:

  • Выдвигаемое меню.
  • Поиск по имени.
  • Иконки приборов на карте.

Возможность отсортировать список приборов

Используя кнопки сортировки выдвигаемого меню, можно отсортировать список приборов по имени или расстоянию от текущего местоположения.

Возможность найти прибор по имени в окне выбора приборов

Поиск прибора по имени.

Можно найти нужный прибор среди множества групп приборов в окне выбора. Поиск можно вести по любой части имени прибора.

Если прибор найден, то открывается группа приборов, содержащая его. Также список приборов прокручивается к найденному прибору.

Требования

Для использования программы нужно:

  • Знать адрес сервера, порт, логин и пароль.
  • Устройство на безе Adroid 2.2 и выше.
  • Устройство должно поддерживать Google Play Services.
  • Желательно, последняя версия сервера (3.1.197 и выше).

Примечание: Если устройство не поддерживает Google Play Services, то может помочь перепрошивка.

Основные окна

Главное окно с картой

Главное окно программы.

Главное окно содержит:

  • Карта
  • Меню
  • Маркер "Мое местоположение"
  • Кнопка "Показать мое местоположение"
  • Элемент для масштабирования
  • Выдвигаемое меню
  • Строка состояния

Меню может содержать пункты:

  • Трек - Открывает диалог выбора дат для трека. Пункт активен, если есть приборы в списке и трек не отображается в данный момент.
  • Удалить трек - Удаляет трек с карты. Виден, если трек есть на карте.
  • Обновить карту - Получить свежие данные по всем приборам с сервера. Виден, если отключено автообновление.
  • Настройки - Открыть окно настроек. Активен, если трек не отображается в данный момент.
  • Поиск - Позволяет найти прибор по его имени. Предлагает варианты автозаполнения. Виден, если закрыто выдвигаемое меню.
  • О программе - Открыть окно "О программе". Активен, если трек не отображается в данный момент.

Строка состояния используется для:

  • Отображения прогресса загрузки трека ( Формат: <процент готовности> <время последней запрашиваемой точки>).
  • Отображения краткого состояния транспорта в режиме слежения (Формат: <Имя прибора> <Статус> : <Дата> : <Скорость>).

Статус прибора может принимать значения:

  • ОК. Есть новые данные.
  • Обновление. В данный момент идет запрос новых данных с сервера.
  • Нет новых данных. В данный момент на сервере нет новых данных.
  • Нет данных. Не удалось получить данные с сервера.
  • Доступ запрещен. Скорее всего программа пытается получить данные по защищенному прибору, не зная верный пароль.
  • Ошибка аутентификации. Используется неправильные логин/пароль.

Выдвигаемое меню

Выдвигаемое меню.

Выдвигаемое меню содержит список приборов и кнопки для сортировки. Открыть это меню можно двумя путями:

  • Кликнуть на иконку приложения
  • Жест "Swype" от левой границы экрана. (Провести пальцем по экрану от левой границы экрана до полного открытия меню. )

Выбранный прибор отображается в списке другим фоном. Синий - прибор выбран. Красный - прибор выбран для отслеживания.

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

Клик по этому же прибору переключает режим слежения (включает/выключает).

Выбор прибора перемещает камеру к выбранному прибору и открывает информационное окно.


Выдвигаемое меню содержит две кнопки:

  • Сортировка по имени прибора.
  • Сортировка по расстоянию от текущего положения на карте.

Сортировка по расстоянию использует текущее положение камеры на карте, а не текущее местоположение пользователя. После сортировки по расстоянию элементы меню приборов содержат расстояние от текущего положения (если было определено). Расстояние будет скрыто после закрытия выдвигаемого меню. Чтобы снова увидеть расстояние нужно нажать на кнопку сортировки по расстоянию.

Окно настроек программы

Окно настроек программы.

Окно содержит пункты:

Настройки соединения

  • Сервер - url или ip адрес сервера
  • Порт
  • Логин
  • Пароль

Тип карты

На данный момент программа использует карты:

  • Обычная карта Google.
  • Снимки со спутника Google.
  • Гибридный вариант Google.
  • Карта OpenStreet.

Запретить спящий режим

Выбор данной опции запрещает устройству переходить в спящий режим на окне с картой.

Автообновление

Позволяет отключить автообновление или выбрать его частоту.

Выбор приборов

Если есть подключение к интернету, то открывает окно выбора приборов, иначе сообщает о необходимости включить интернет.

Настройки приборов

Открывает окно настроек приборов. Данный пункт активен только если список выбранных приборов не пуст.

Окно настроек приборов

Окно содержит древовидный список с настройками приборов. На данный момент множество настроек приборов содержит:

  • Иконка прибора. Отображает текущую иконку прибора и позволяет открыть окно выбора иконки по клику.
  • Пароль. По клику появляется окно для редактирования пароля. (В целях безопасности пароль не показывается на этом окне.)

Примечание: Поле пароля появляется только у защищенных устройств. Это определяется в момент получения прибора с сервера. Если вы уверены, что устройство защищено паролем, но поля нет, то обновите список приборов. Сделать это можно, открыв окно "Выбрать приборы". После появления списка приборов окно можно закрыть. Данные должны обновиться.

Окно выбора приборов

Окно выбора приборов.

Окно выбора приборов содержит древовидный список приборов. Наполнение списка зависит от учетной записи.

Выбрать прибор можно кликнув по нему. Если прибор выбран, то справа от имени прибора будет галочка. Если нет - крестик. Если прибор в черном списке, то его выбрать нельзя и отображается это надписью "blacklist" справа от имени прибора.

Приборы группируются по клиентам. Каждая группа справа от названия имеет статус в формате <выбрано приборов>/<всего приборов>. Приборы для данной учетной запись находятся в отдельной группе.

Очистить список приборов можно с помощью пункта меню "Очистить список".

С помощью длительного нажатия по группе приборов можно:

  • Выбрать все (не в черном списке) приборы в группе, если на момент нажатия выбраны не все.
  • Отменить выбор всех приборов в группе, если выбраны все.

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

Примечание: Получение приборов относительно долгий процесс. Выполняется от 10с.

Окно выбора иконки

Окно выбора программной иконки.

Окно позволяет заменить стандартную иконку прибора на одну из списка или выбрать свою.

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

Чтобы выбрать свою иконку, нужно кликнуть по пункту "<Выбрать свою>". После чего, откроется диалог выбора пользовательской иконки.

Окно выбора пользовательской иконки

Окно выбора пользовательской иконки.

Окно позволяет заменить стандартную иконку прибора на свою. Своя иконка должна быть в формате png и лежать в любой папке, корнем которой будет /sdcard/DroidFleet/. Например, /sdcard/DroidFleet/Icons/icon.png или sdcard/DroidFleet/Icons/Icons1/icon.png являются правильными путями.

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

Чтобы выбрать иконку, нужно найти ее в диалоге и кликнуть по ней. Элемент списка с выбранной иконкой будет иметь другой цвет фона и галочку справа. После чего нужно нажать кнопку назад для подтверждения.

Окно "О программе"

Окно содержит пункты:

  • Программа. Отображает версию программы и позволяет открыть страницу приложения в Google Play.
  • Сайт компании. Отображает сайт компании и позволяет открыть его.
  • Помощь. Отображает ссылку на эту страницу и позволяет открыть её.
  • Отправить письмо разработчику. Позволяет отправить email разработчику приложения.

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

Диалог выбора дат для трека

Диалог выбора дат.

Диалог позволяет выбрать граничные даты для трека. После выбора дат следует нажать кнопку "ОК" для начала отрисовки трека.

Если начальная дата больше конечной то кнопка "ОК" отключается.

Примечание: поведение и внешний диалогов выбора даты и времени зависят от версии Android.

Сообщения об ошибках

Ошибка аутентификации

Сообщение вида "<имя прибора>.Ошибка аутентификации." появляется при неудачной попытке получения информации по прибору. Проверьте правильность логин/пароль.

Если логин/пароль верны (например, удачно открывается окно "Выбрать приборы"), то возможно, что прибор защищен паролем. В этом случае введите пароль для устройства на окне настроек приборов.

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

Если ошибка не пропадает, то откройте окно "Выбрать приборы", снимите галку с проблемного прибора, закройте это окно. После этого снова откройте окно "Выбрать приборы" и выберите этот прибор.

Если ошибка не пропадает, то откройте окно "Выбрать приборы", в меню выберите пункт "Очистить список" и выберите приборы заново.

Если ошибка все еще не пропадает, то удалите файл настроек /sdcard/DroidFleet.settings.ini. Это удалит все настройки программы вместе со списком приборов. При следующем запуске программы нужно ввести данные и выбрать приборы.

Если и это не помогло, то пишите на форум DroidFleet.

Прибор не найден на сервере, поэтому удален

Сообщение вида "Прибор <имя прибора> не найден на сервере, поэтому удален" может появится, если на сервере удалить прибор. Также сообщение может появится, если файл настроек будет изменен или поврежден.

Прибор находится в черном списке, поэтому скрыт

Прибор не будет удален из списка и при следующем запуске программы он снова будет в списке.

Чтобы удалить такой прибор из списка нужно в окне "Выбрать приборы" выбрать пункт меню "Очистить список".

Подключение к интернету не обнаружено

Просто включите интернет на устройстве.

Ошибка подключения. Проверьте настройки...

Если вы ввели верный логин/пароль, но видите это сообщение, то попробуйте повторить операцию. Плохое интернет соединение может приводить к ошибкам.

Если не помогает, то пишите на форум DroidFleet.

Ошибка на стадии <...>. Причина: <...>

Сообщение показывается при неудачном получении списка приборов.

Проверьте в браузере доступность и работоспособность сервера, набрав http://<адрес>:<порт>. Если все работает, то браузер должен что-то отобразить и запросить логин/пароль (если в браузере нет Cookie для этого сайта). Если ничего нет, то что-то не работает.

Если в браузере сервер доступен и работоспособен а в программе нет, то пишите на форум.

Примечание: Когда выводится это сообщение об ошибке, автоматически пишется подробный лог в файл /sdcard/DroidFleet/DroidFleetLog.log. В случае ошибки программы (в браузере все работает) желательно отправить лог на почту evgeniy@locarus.ru. Это ускорит исправление ошибки.

Личные инструменты
Пространства имён
Варианты
Действия
Навигация
Инструменты