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