Реализация обратного геокодирования (адрес по координатам) в мобильном приложении
Обратное геокодирование — это перевод пары (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=ru&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=ru®ion=RU и сортируем address_components вручную: город → улица → дом. Google возвращает компоненты в порядке «от крупного к мелкому», а Россия ждёт «от мелкого к крупному» в строке отображения.
Для проектов с DaData — интегрируем suggestions/api/4_1/rs/geolocate/address как второй провайдер: лучше работает с нестандартными адресами внутри России, знает промзоны и корпуса, которые Google отдаёт как undefined.
Этапы работы
Аудит требований: онлайн-only или нужен офлайн, один адрес или batch, целевые рынки. Выбор провайдера и API-ключей. Реализация сервисного слоя с кэшированием. Тестирование на граничных координатах: середина океана, сельская местность, промзоны. Интеграция в UI с правильным состоянием загрузки.
Срок реализации: от одного дня для базового случая (один провайдер, онлайн) до трёх дней с офлайн-кэшем, мультипровайдером и поддержкой нескольких рынков.