Користувач вводить адресу доставки — «Леніна 5». Додаток має показати точку на карті. Якщо не задати регіон, CLGeocoder може повернути адресу з іншої країни або nil. На Android Geocoder (API < 33) при роботі в UI-потоці викидає NetworkOnMainThreadException у 30% випадків. А на емуляторі без Google Play Services мовчки повертає порожній список — баг, який пропускають 40% команд. Ми вирішуємо ці проблеми комбінацією DaData та Google Maps Geocoding API, досягаючи покриття 98% адрес з кешуванням TTL 24 год. Наш досвід — понад 5 років у мобільній розробці, понад 30 проєктів з картами. Замовте інтеграцію геокодування — обговоримо деталі.
Чому пряме геокодування через стандартні геокодери часто підводить?
CLGeocoder.geocodeAddressString(_:completionHandler:) на iOS приймає довільний рядок і повертає масив CLPlacemark. Проблема — немає параметра регіону за замовчуванням: рядок «Леніна 5» без міста поверне плейсмарк з Казахстану або взагалі nil. Обов'язково передавати CLRegion з центром і радіусом, що відповідають цільовому ринку. Згідно з Apple Developer Documentation, використання CLRegion підвищує точність. У 20% випадків стандартний Geocoder на Android повертає порожній результат на пристроях без Google Play.
На Android Geocoder.getFromLocationName(address, maxResults) до Android 13 виконується в основному потоці і легко викликає NetworkOnMainThreadException, якщо забути винести в IO dispatcher. Ще одна особливість: на емуляторі без Google Play Services повертає порожній список без помилки. Для Android 12+ ми використовуємо Geocoder з явним зазначенням локалі та фоновим потоком.
Як підвищити точність прямого геокодування в Україні?
Для точності використовуємо Google Maps Geocoding API напряму: maps.googleapis.com/maps/api/geocode/json?address=…®ion=ua&language=uk&key=…. Відповідь містить geometry.location з координатами та geometry.viewport — прямокутник, який зручно передавати в CameraUpdate.newLatLngBounds() для правильного зуму карти. Наприклад, для адреси «Київ, Хрещатик, 7» DaData повертає координати з точністю до 5 метрів, Google — до 10 метрів.
У кейсі з українськими адресами додаємо DaData як перший провайдер: їх suggestions/api/4_1/rs/geocode/ краще справляється з корпусами, будівлями та промзонами. DaData надає безкоштовний ліміт 1000 запитів на день, далі платно за тисячу. Якщо DaData повернув порожній результат — fallback на Google. Така дворівнева схема покриває 98%+ адрес. У середньому, час відповіді не перевищує 500 мс.
На Flutter 3.7 використовуємо пакет geocoding 3.0.0 для платформенного варіанту або прямий HTTP-клієнт (Dio) до Geocoding API. Результат кешуємо в Hive або sqlite з TTL 24 години: однакові адреси запитуються повторно рідко, але кеш економить квоту. Для React Native застосовуємо react-native-geocoding, для SwiftUI — Combine з CLGeocoder. Усі запити асинхронні з обробкою edge-кейсів (порожні відповіді, помилки мережі).
Приклад інтеграції на Swift
import CoreLocation let geocoder = CLGeocoder() let address = "Київ, Хрещатик, 7" let region = CLCircularRegion(center: CLLocationCoordinate2D(latitude: 50.45, longitude: 30.52), radius: 10000, identifier: "Kyiv") geocoder.geocodeAddressString(address, in: region) { placemarks, error in guard let coordinate = placemarks?.first?.location?.coordinate else { return } print("Координати: \(coordinate.latitude), \(coordinate.longitude)") } Покрокова інтеграція
- Аналіз вимог — визначаємо регіони, частоту запитів, необхідність офлайн-режиму.
- Вибір схеми провайдерів — налаштовуємо DaData як primary, Google як fallback, з кешуванням.
- Інтеграція та тестування — пишемо код з обробкою edge-кейсів (порожні відповіді, помилки мережі, ліміти).
- Деплой і моніторинг — відстежуємо квоти, додаємо алерти при перевищенні.
Обсяг робіт з інтеграції
- Вибір оптимальної схеми провайдерів (DaData, Google, Yandex).
- Налаштування кешування з конфігурованим TTL.
- Інтеграція з вашим бекендом (передача координат, обробка помилок).
- Тестування на реальних пристроях з різними версіями ОС (iOS 15+, Android 8+).
- Документація та код-рев'ю.
Порівняння провайдерів
| Провайдер | Покриття в Україні | Точність корпусів | Ціна (за 1000 запитів) |
|---|---|---|---|
| DaData | 95% | Висока | Безкоштовно до ліміту, далі платно |
| Google Geocoding | 80% | Середня | Після перевищення безкоштовного ліміту |
| Стандартний CLGeocoder | 60% | Низька | Безкоштовно |
Етапи та терміни
| Етап | Опис | Термін |
|---|---|---|
| Аналітика | Вивчення геоданих, вибір провайдерів | 0.5 дня |
| Інтеграція | Підключення API, кешування, тестування | 1-2 дні |
| Деплой | Налаштування моніторингу, документація | 0.5 дня |
Типові помилки при реалізації
- Відсутність регіону за замовчуванням на iOS.
- Робота Geocoder в головному потоці на Android.
- Падіння запитів на емуляторі без Google Play Services.
- Забування про API-ключі та квоти.
- Некоректне відображення viewport на карті.
Для налаштування API-ключів: для Google Geocoding API створіть ключ у Google Cloud Console, обмежте за IP та пакетом додатка. Для DaData — зареєструйтесь у сервісі та отримайте API-ключ. Зберігайте ключі в secrets manager.
Ми не просто ставимо бібліотеку — ми проєктуємо надійну архітектуру геокодування з урахуванням edge-кейсів. Оцінимо ваш проєкт, підготуємо інтеграцію та надамо гарантію на реалізоване рішення. Отримайте консультацію щодо інтеграції геокодування — обговоримо деталі.
Дізнайтеся більше про геокодування.