Документація/Налаштування пристроїв

Адміністратору

GPS

Дозволи Android, розклад GPS-трекінгу, надсилання координат і перевірка роботи на пристрої.

GPS-трекінг записує маршрут Android-пристрою та надсилає координати до сервісу gps.palmorder.com. Адміністратор задає розклад, інтервали й обліковий запис GPS-сервісу, а користувач надає дозвіл Android на місцезнаходження.

Налаштування GPS-трекінгу доступні для пристрою з чинною ліцензією FULL. Логін і пароль GPS-сервісу вводяться окремо в налаштуваннях GPS.

Перед налаштуванням

  • Пристрій спаровано з PalmOrder Server і він отримав ліцензію FULL.
  • Для перегляду треків є обліковий запис GPS-сервісу. Дані доступу можна уточнити в підтримки PalmOrder.
  • На Android-пристрої ввімкнено визначення місцезнаходження.
  • Для надсилання координат доступний інтернет.

GPS-сервіс ідентифікує пристрій за syncName, який він отримав під час парування. Якщо змінюєте syncName, перевірте відповідність пристрою в обліковому записі GPS-сервісу.

Дозволи й точність Android

  1. Відкрийте PalmOrder та перейдіть до Налаштування → GPS-трекінг.
  2. Увімкніть Увімкнути GPS-трекінг і збережіть налаштування.
  3. Ознайомтеся з поясненням про запис і передавання місцезнаходження та надайте дозвіл Android на геолокацію під час використання застосунку.
  4. Якщо Android пропонує вибір точності, увімкніть Точне місцезнаходження. Для запису треку потрібен дозвіл на точну геолокацію.
  5. Якщо PalmOrder просить увімкнути режим Висока точність, перейдіть до налаштувань місцезнаходження й увімкніть відповідний режим або підвищення точності.

Дозволи застосунку можна перевірити в Налаштування Android → Застосунки → PalmOrder → Дозволи → Місцезнаходження. Назви пунктів залежать від версії Android та виробника. Довідка Android про дозволи.

Запускайте трекінг, коли PalmOrder відкритий на екрані. Надалі запис працює через сервіс місцезнаходження зі службовим сповіщенням і може продовжуватися після згортання застосунку.

Параметри GPS-трекінгу

У PalmOrder відкрийте Налаштування → GPS-трекінг.

ПараметрПризначення
Увімкнути GPS-трекінгДозволяє запис маршруту за заданим розкладом.
Блокувати застосунок, коли режим «Висока точність» вимкненоВимагає відповідного режиму місцезнаходження під час роботи за розкладом GPS.
Інтервал збереження координат (с)Період запиту координат для треку. Початкове значення — 30 секунд.
Увімкнення, ВимкненняПочаток і кінець роботи за часом пристрою.
Логін, ПарольДані облікового запису GPS-сервісу.
Інтервал надсилання координат (с)Період спроб надсилання накопичених координат. Початкове значення — 60 секунд.
Період перевірки роботи сервісу (хв.)Період запланованих спроб повторного запуску GPS-сервісу. Початкове значення — 60 хвилин.
Використовувати час з Інтернету замість часу GPS/мережіВибір джерела часу для записуваних точок.
Надіслати трекРучне надсилання накопичених координат з показом результату.
Видалити трекВидалення локального файла накопичених координат після підтвердження. Разом із ним буде втрачено ще не надіслані точки.

Інтервали збереження та надсилання вимірюються в секундах, а перевірки сервісу — у хвилинах. Фактична частота отримання координат залежить також від місцезнаходження, руху, якості сигналу та обмежень Android.

Розклад

Для роботи вдень задайте, наприклад, Увімкнення — 08:00, Вимкнення — 18:00.

Якщо початок і кінець однакові, трекінг працює без обмеження за часом. Інтервал через північ теж підтримується, наприклад 22:00–06:00.

Зміни розкладу застосовуються після збереження налаштувань. Увімкнений трекінг поза робочим інтервалом очікує початку наступного інтервалу.

Надсилання й перегляд треку

Застосунок накопичує координати на пристрої та періодично надсилає їх до GPS-сервісу. Для автоматичного надсилання заповніть логін і пароль та задайте додатний інтервал надсилання. Значення 0 вимикає періодичне надсилання.

За відсутності інтернету точки залишаються локально для подальшого надсилання. Для перевірки з'єднання скористайтеся дією Надіслати трек і прочитайте відповідь сервера.

Після надсилання відкрийте gps.palmorder.com, увійдіть у свій обліковий запис і перевірте трек потрібного пристрою за відповідний день. Вибирайте пристрій із його поточним syncName.

Якщо обмін документами працює, а координати не надходять, перевіряйте налаштування GPS-сервісу та дозвіл на місцезнаходження. Логін і пароль для GPS зберігаються в секції GPS-трекінгу.

Робота після згортання й перезапуску

Після ввімкнення трекінгу згорніть PalmOrder і перевірте появу нових точок. На пристрої має працювати сервіс місцезнаходження.

Android може обмежувати запуск GPS-сервісу, коли застосунок закритий, а виробник пристрою — додатково обмежувати його роботу для економії заряду. Якщо після перезавантаження або зупинки трекінг не відновився, відкрийте PalmOrder, перевірте дозвіл і збережіть увімкнені налаштування GPS у межах робочого часу.

Параметр перевірки сервісу задає спроби відновлення. Можливість такого запуску визначають також правила Android. Перевірте запис треку на конкретних моделях пристроїв, які використовуються в роботі.

Координати документів

Коли GPS-трекінг увімкнено, під час збереження документа застосунок може додати до треку точку з відомостями про документ. Координати також можуть записуватися в поля latitude і longitude документів, які їх підтримують.

Для координат документа перевіряється актуальність і точність отриманого місцезнаходження. Наявність маршруту на карті сама по собі не гарантує заповнення цих полів у кожному документі.

Поля та передавання документів в облікову систему описано на сторінках Схеми документів і Документи від пристрою.

Дистанційне налаштування

Розклад, інтервали та обліковий запис можна передати через секцію gps-tracking у preferences.xml. Файл готує інтегратор і розміщує в outbox пристрою.

<gps-tracking>
  <enabled>true</enabled>
  <required>false</required>
  <interval>30</interval>
  <on>08:00</on>
  <off>18:00</off>
  <send-interval>60</send-interval>
  <service-check-interval>60</service-check-interval>
</gps-tracking>

Розмістіть цей фрагмент усередині <preferences>. Приклад змінює розклад та інтервали, зберігаючи вже введені на пристрої логін і пароль. Дозвіл Android на місцезнаходження надається користувачем на пристрої.

Повний перелік параметрів і порядок завантаження описано на сторінці Дистанційні налаштування.

Перша перевірка

  1. Перевірте ліцензію FULL, поточний syncName, дозвіл на точне місцезнаходження та ввімкнену геолокацію Android.
  2. Задайте розклад, який охоплює поточний час, і заповніть логін та пароль GPS-сервісу.
  3. Увімкніть трекінг і збережіть налаштування, залишаючи PalmOrder відкритим.
  4. Перевірте запис під час переміщення, зокрема після згортання застосунку.
  5. Виконайте Надіслати трек і перевірте відповідь.
  6. Переконайтеся, що точки з'явилися в потрібного пристрою та за правильну дату в GPS-сервісі.

Якщо координати не з'являються

СимптомЩо перевірити
Немає розділу GPS-трекінгуЧинну ліцензію FULL на пристрої.
Трекінг увімкнено, а сервіс не працюєДозвіл на точне місцезнаходження, геолокацію Android, розклад і запуск із відкритого застосунку.
Точки є лише під час відкритого застосункуРоботу сервісу після згортання та обмеження батареї або фонової роботи на пристрої.
Немає точок у приміщенніЯкість визначення місцезнаходження. Повторіть перевірку на відкритому просторі.
Ручне надсилання повідомляє про відсутній файл трекуЧи почався запис координат і чи не було трек щойно надіслано або видалено.
Помилка під час надсиланняІнтернет, логін, пароль і точну відповідь GPS-сервісу.
Надсилання успішне, але на карті немає очікуваних точокОбліковий запис, пристрій за syncName, дату перегляду та час Android-пристрою.

Для підтримки підготуйте модель і версію Android, версію PalmOrder, syncName, час проблеми та відповідь на дію Надіслати трек. Пароль облікового запису в повідомлення підтримці не включайте.