Если геокодер нашёл одноимённую улицу в другом городе, сохраните обезличенный запрос и выбранного кандидата. Затем сравните населённый пункт, регион и номер дома в ответе с подтверждённым вводом. Первая координата в списке не является доказательством нужного адреса. Массовое повторное геокодирование пока только умножит неверные точки.

Для контрольного набора используйте публичные адреса: одноимённые улицы разных городов, адрес без дома и адрес с опечаткой. Не отправляйте частные клиентские адреса в общедоступный отчёт. Здесь разбирается выбор результата поиска по адресу, а не определение текущего города по местоположению телефона.

Полное совпадение не определяется красивой подписью

Документация Google Geocoding API v3 описывает partial_match как признак неполного совпадения исходного запроса и рекомендует использовать отдельные address_components вместо программного разбора formatted_address. Проверено 13 октября 2026 года. Отсутствие partial_match не отменяет вашу проверку области доставки и подтверждённого населённого пункта.

РезультатЧто он означает для формыСледующее действие
Несколько похожих кандидатовАдрес неоднозначенПоказать понятный выбор
Неполное совпадениеЧасть введённого не найдена точноЗапросить уточнение
Найденная улица без нужного домаТочка может описывать иной уровеньНе обещать точность до входа
Город расходится с подтверждённымКонтекст поиска потерян или не соблюдёнОтклонить автоматическое закрепление

Сравнивайте компоненты по их типам, а не по фиксированному номеру в массиве. Поля и административная структура могут различаться у стран. В вашей модели явно определите, какое поле означает выбранный населённый пункт и как обрабатываются поселения без привычной пары «город — улица». Не подменяйте отсутствие компонента значением соседнего поля.

Контекст города передаётся и проверяется

Условный договор адресной формы:
input_revision: <версия ввода>
confirmed_locality: <публичный тестовый город>
address_text: <публичный адрес>
selected_candidate: <результат поиска>
match_quality: exact / partial / ambiguous
confirmation: required / accepted

В API Google можно ограничивать результаты компонентами страны и почтового индекса; locality и administrative_area влияют на поиск, но не являются жёстко обеспечиваемым ограничением. Это следует из документации v3, проверенной 13 октября 2026 года. Поэтому «передали город» не равно «получили нужный город»: результат всё равно проверяется по договору приложения. Для другого сервиса изучите именно его параметры.

Условный сценарий: пользователь ввёл улицу, затем изменил город, а медленный ответ первого запроса пришёл последним. Если форма принимает любой успешный ответ, она закрепляет точку старого города. Свяжите запрос с ревизией ввода; результат устаревшей ревизии не обновляет выбранный адрес. Уже подтверждённый вручную кандидат защищён от фоновой замены.

Подсказка адреса и подтверждение доставки — разные этапы. Пользователь должен увидеть найденный населённый пункт и дом перед закреплением. Ручная точка на карте тоже требует согласованного правила: она может обозначать вход, а текст — сам объект. Храните происхождение выбора, чтобы повторное сохранение не заменило вход центром улицы.

Исправление проверяется на неоднозначных адресах

  1. Найти одноимённую улицу в двух публичных городах.
  2. Подать адрес без номера дома.
  3. Изменить город во время ожидания ответа.
  4. Подтвердить кандидата вручную и дождаться позднего результата.
  5. Повторно открыть сохранённую форму и сравнить выбор.

Отдельно проверьте порядок координат на границе карты. Если кандидат содержит правильный город, но точка рисуется далеко, ошибка может быть уже после геокодирования. Не исправляйте её подбором другого кандидата. Диагностика различает неправильный выбор адреса и неправильную передачу найденной координаты.

Повреждённые записи отбирайте по доказанной версии импорта или формы. Сохраните прежний адрес и происхождение точки, покажите пробное изменение ответственному пользователю. Не переписывайте всю базу свежим ответом сервиса. Для разбора достаточно публичного примера, ревизий ввода и компонентов выбранного кандидата; успешный результат сохраняет подтверждённый город даже при неоднозначности и поздних ответах.

Проверенные источники