Реалізація зворотного геокодування (адреса за координатами) у мобільному додатку
Зворотне геокодування — це переведення пари (latitude, longitude) у читаємий поштовий адресу. Задача виглядає тривіальною рівно до того моменту, як додаток починає працювати за межами міста з хорошим покриттям карт, або коли координати прилітають з затримкою, а UI уже чекає строку.
Де частіше всього ломається «очевидне» рішення
На iOS стандартний шлях — CLGeocoder.reverseGeocodeLocation(_:completionHandler:). Проблема: один запит в секунду, жорсткий rate limit від Apple. Якщо потрібно показати адресу для 20 точок на карті одночасно — CLGeocoder перетворюється в чергу з затримками по 15-20 секунд, тому що кожен виклик блокує наступний до отримання відповіді.
На Android Geocoder.getFromLocation() до API 33 виконується синхронно і кидає IOException при відсутності мережі без якого-небудь fallback. З API 33 з'явився GeocodeListener, але пристрої на Android 12 і нижче його не підтримують — потрібно тримати два шляхи коду.
В обох випадках результат залежить від якості бази даних провайдера. Apple використовує TomTom і HERE, Google — власну базу. За межами крупних міст адреси можуть повертатися як "Unnamed Road" або взагалі тільки на рівні адміністративного району.
Як реалізуємо
Для більшості проектів ми використовуємо Google Maps Geocoding API замість платформенних рішень — однакові результати на iOS і Android, точніші адреси в СНГ та Східній Європі, передбачуваний формат відповіді.
На iOS SDK: GMSGeocoder.reverseGeocodeCoordinate(_:completionHandler:) з пакету GoogleMaps. Повертає GMSReverseGeocodeResponse з массивом GMSAddress — беремо перший, розбираємо thoroughfare, subThoroughfare, locality, administrativeArea, postalCode.
На Android: Retrofit-клієнт до maps.googleapis.com/maps/api/geocode/json?latlng=…&language=uk&key=…. Парсимо address_components за типами: street_number, route, locality, administrative_area_level_1. Для офлайн-сценаріїв додатково кешуємо останню відому адресу в Room з привязкою до координат (радіус совпадіння 50 метрів).
У Flutter — пакет geocoding для платформенного геокодера і google_maps_flutter + прямі http-запити до Geocoding API для точності. Важливо: geocoding на Android під капотом використовує той же Geocoder.getFromLocation(), тому його неможливо викликати з main isolate.
Формат адреси під конкретний рынок
Якщо додаток працює в Росії — додаємо параметр language=uk®ion=RU і сортуємо address_components вручну: місто → вулиця → дім. Google повертає компоненти в порядку «від крупного до дрібного», а Росія чекає «від дрібного до крупного» у строці відображення.
Для проектів з DaData — інтегруємо suggestions/api/4_1/rs/geolocate/address як другий провайдер: краще працює з нестандартними адресами всередину Росії, знає промзони і корпуси, які Google віддає як undefined.
Етапи роботи
Аудит вимог: онлайн-only або потрібен офлайн, одна адреса або batch, цільові рынки. Вибір провайдера і API-ключів. Реалізація сервісного шару з кешуванням. Тестування на граничних координатах: середина океану, сільська місцевість, промзони. Інтеграція в UI з правильним станом завантаження.
Строк реалізації: від одного дня для базового випадку (один провайдер, онлайн) до трьох днів з офлайн-кешем, мультипровайдером і поддержкою кількох рынків.