Довідка: Додавання координат клієнтів з Google Maps
Огляд
Функціонал дозволяє додавати GPS-координати клієнтів, скопійовані з Google Maps. Координати зберігаються локально в базі даних та синхронізуються з сервером для використання іншими користувачами.
🔍 Як потрапити до функції
Спосіб 1: З екрана створення замовлення
-
Відкрийте екран "Створення замовлення"
-
Натисніть на поле "Клієнт" (відкриється список клієнтів)
-
Знайдіть та виберіть потрібного клієнта зі списку
-
На картці клієнта натисніть на кнопку карти (іконка карти)
-
У відкритому діалозі виберіть "Вставити координати"
Ланцюжок навігації:
Створення замовлення → Вибір клієнта → Кнопка карти → Вставити координати
Спосіб 2: Зі списку клієнтів
-
Відкрийте екран "Клієнти"
-
Знайдіть потрібного клієнта в списку
-
На картці клієнта натисніть на кнопку карти (іконка карти)
-
У відкритому діалозі виберіть "Вставити координати"
Візуальне розташування:
-
Кнопка карти знаходиться справа на картці клієнта
-
Іконка карти може бути різних кольорів:
-
Жовта — у клієнта є GPS-координати
-
Червона — у клієнта є тільки адреса
-
Сіра — у клієнта немає ні координат, ні адреси
📋 Діалог введення координат
Структура діалогу
Діалог складається з кількох елементів:
-
Заголовок — "Координати клієнта" з індикатором джерела даних
-
Інформація про клієнта — ім'я клієнта
-
Інформація про менеджера — хто додав координати (якщо є)
-
Інформація про фото — посилання на фото клієнта (якщо є)
-
Поле введення координат — текстове поле для введення
-
Інструкції — як отримати координати з Google Maps
-
Кнопки дій — "Скасувати" та "Зберегти"
Індикатор джерела даних
У заголовку діалогу відображається джерело поточних координат:
-
"SQL сервер" (зелений) — координати завантажені з сервера
-
"локальна БД" (синій) — координати з локальної бази даних
📍 Як отримати координати з Google Maps
Крок 1: Відкрийте Google Maps
-
Відкрийте Google Maps у браузері або додатку
-
Знайдіть потрібну адресу клієнта
-
Натисніть на точку на карті (або на адресу в пошуку)
Крок 2: Скопіюйте координати
У браузері (веб-версія):
-
Натисніть правою кнопкою миші на точку на карті
-
Виберіть першу цифру в з'явившомуся меню (це координати)
-
Координати скопіюються в буфер обміну
У мобільному додатку:
-
Натисніть та утримуйте точку на карті
-
У з'явившомуся меню знайдіть координати
-
Натисніть на координати для копіювання
Формат координат:
-
Приклад:
49.9973616, 36.2716074 -
Два числа через кому (широта, довгота)
-
Можуть бути з пробілом або без
Крок 3: Вставте координати в додаток
-
Відкрийте діалог "Вставити координати" (див. розділ "Як потрапити до функції")
-
Натисніть на іконку вставки (📋) справа в полі введення
-
Координати автоматично вставляться в поле
-
Або введіть координати вручну
✏️ Введення координат
Підтримувані формати
Додаток підтримує різні формати координат:
- Стандартний формат:
-
49.9973616, 36.2716074 -
49.9973616,36.2716074(без пробілу)
- З роздільниками:
-
49.9973616; 36.2716074(крапка з комою) -
49.9973616 36.2716074(пробіл)
- З додатковими символами:
-
(49.9973616, 36.2716074)(у дужках) -
lat: 49.9973616, lng: 36.2716074(з префіксами) -
49.9973616° N, 36.2716074° E(з градусами)
- Європейський формат:
49,9973616, 36,2716074(кома як десятковий роздільник)
- З переносами рядків:
-
Координати можуть бути на різних рядках
-
Додаток автоматично обробить переноси
Вставка з буфера обміну
-
Скопіюйте координати з Google Maps
-
У діалозі натисніть на іконку вставки (📋)
-
Координати автоматично очистяться від зайвих символів і вставляться
Особливості:
-
Автоматична очистка переносів рядків
-
Видалення зайвих пробілів
-
Підтримка різних форматів
Ручне введення
-
Введіть координати в поле введення
-
Використовуйте формат:
широта, довгота -
Приклад:
49.9973616, 36.2716074
💾 Збереження координат
Процес збереження
-
Перевірка формату — додаток перевіряє коректність координат
-
Збереження в локальну БД — координати зберігаються локально
-
Відправка на сервер — координати синхронізуються з сервером
-
Оновлення інтерфейсу — картка клієнта оновлюється
Індикатори процесу
Під час збереження:
-
Показується індикатор завантаження
-
Після успішного збереження — тактильний зворотний зв'язок
-
З'являється сповіщення про успіх
Результат збереження
Після успішного збереження:
-
Іконка карти на картці клієнта стає жовтою (GPS-координати)
-
З'являється мітка "GPS" біля адреси
-
Координати доступні для всіх користувачів додатку
🔄 Синхронізація координат
Автоматична синхронізація
Координати автоматично синхронізуються:
-
При збереженні нових координат
-
При оновленні списку клієнтів
-
При синхронізації з сервером
Ручна синхронізація
-
Відкрийте екран "Клієнти"
-
Натисніть на іконку карти в заголовку (іконка синхронізації)
-
Дочекайтеся завершення синхронізації
Що відбувається:
-
Завантажуються координати всіх клієнтів з сервера
-
Оновлюються координати в локальній базі даних
-
Оновлюються іконки на картках клієнтів
📊 Індикатори на картці клієнта
Іконка карти
Іконка карти справа на картці клієнта показує статус геоданих:
-
Жовта іконка (жовтий фон) — у клієнта є GPS-координати
-
Червона іконка (червоний фон) — у клієнта є тільки адреса
-
Сіра іконка (сірий фон) — немає ні координат, ні адреси
Мітки біля адреси
-
"GPS" (жовта мітка) — у клієнта є GPS-координати
-
"Адреса" (червона мітка) — у клієнта є тільки адреса
🗺️ Додаткові дії з картами
Відкриття в Google Maps
-
Натисніть на кнопку карти на картці клієнта
-
У діалозі виберіть "Відкрити в браузері"
-
Google Maps відкриється з координатами або адресою клієнта
Пріоритет відкриття:
-
GPS-координати (якщо є)
-
Адреса (якщо координат немає)
Копіювання адреси
-
Натисніть на кнопку карти на картці клієнта
-
У діалозі виберіть "Копіювати адресу"
-
Адреса скопіюється в буфер обміну
❓ Часті запитання
П: Як отримати координати з Google Maps?
В: Відкрийте Google Maps, знайдіть адресу, натисніть правою кнопкою миші на точку на карті, виберіть першу цифру (координати). Координати скопіюються в буфер обміну.
П: Який формат координат потрібен?
В: Додаток підтримує різні формати: 49.9973616, 36.2716074 або 49.9973616,36.2716074. Можна використовувати пробіли, крапки з комою, дужки та інші символи.
П: Чи можна вставити координати з буфера обміну?
В: Так, натисніть на іконку вставки (📋) справа в полі введення координат. Координати автоматично очистяться та вставляться.
П: Що робити, якщо координати не розпізнаються?
В: Переконайтеся, що координати в правильному форматі (широта, довгота). Спробуйте видалити зайві символи або використати формат 49.9973616, 36.2716074.
П: Чи зберігаються координати на сервері?
В: Так, координати зберігаються локально та автоматично синхронізуються з сервером для використання іншими користувачами.
П: Як дізнатися, чи є у клієнта координати?
В: Подивіться на іконку карти на картці клієнта: жовта іконка означає наявність GPS-координат, червона — тільки адреса, сіра — немає даних.
П: Чи можна редагувати існуючі координати?
В: Так, відкрийте діалог "Вставити координати" для клієнта, і ви побачите поточні координати, які можна змінити.
П: Що означає мітка "GPS" біля адреси?
В: Мітка "GPS" означає, що у клієнта є точні GPS-координати, а не тільки адреса.
П: Як синхронізувати координати з сервера?
В: Натисніть на іконку карти в заголовку екрана "Клієнти" для синхронізації всіх координат з сервера.
П: Хто бачить додані координати?
В: Всі користувачі додатку, оскільки координати синхронізуються з сервером.
💡 Корисні поради
-
Використовуйте копіювання з Google Maps — найточніший спосіб отримати координати
-
Перевіряйте формат — переконайтеся, що координати в форматі
широта, довгота -
Використовуйте вставку — іконка вставки автоматично очистить координати від зайвих символів
-
Перевіряйте результат — після збереження іконка карти має стати жовтою
-
Синхронізуйте регулярно — використовуйте синхронізацію для отримання актуальних координат
🔐 Безпека та обмеження
Доступність даних
-
Потрібне підключення — для синхронізації з сервером потрібен інтернет
-
Залежність від сервера — координати зберігаються на сервері
-
Права доступу — координати доступні всім користувачам додатку
Обмеження
-
Тільки перегляд та редагування — не можна видалити координати, тільки змінити
-
Формат координат — координати мають бути в діапазоні: широта від -90 до 90, довгота від -180 до 180
-
Один клієнт за раз — координати додаються для одного клієнта
⌨️ Гарячі клавіші та жести
-
Тап по кнопці карти — відкрити діалог дій з картами
-
Тап по "Вставити координати" — відкрити діалог введення координат
-
Тап по іконці вставки — вставити координати з буфера обміну
-
Тап по "Зберегти" — зберегти координати
Версія документа: 1.0
Останнє оновлення: 2025