Не отправляйте форму по первой строке autocomplete. Пользователь вводит неоднозначный текст, сервис возвращает варианты, а приложение должно сохранить выбранный place ID и только затем получить структурированные детали. Номер квартиры или офиса оставьте отдельным редактируемым полем: подсказка часто его не содержит.

Для ввода в реальном времени используйте специализированный autocomplete, а не geocoding полного адреса на каждую клавишу. Google рекомендует Place Autocomplete для неполных и неоднозначных строк; geocoding лучше подходит для уже полного адреса.

Поле адреса имеет четыре состояния

СостояниеЧто хранитсяМожно продолжать
emptyНичегоНет
typingRaw input и request sequenceНет, подсказки ещё могут измениться
selectedplace ID, display text, providerДа после получения деталей
edited_after_selectНовый raw input, старый ID сброшенНет до нового выбора или ручной проверки
manual_confirmedRaw components и признак ручного вводаТолько если бизнес допускает

Главная ошибка — оставить старый place ID после того, как пользователь изменил текст. Любое редактирование выбранной строки возвращает поле в `typing`, иначе на экране будет один адрес, а доставка сохранит другой.

Запросы отменяют и нумеруют

let requestSequence = 0;
let selectedPlaceId = null;

async function onAddressInput(input) {
  selectedPlaceId = null;
  const sequence = ++requestSequence;
  const suggestions = await fetchSuggestions(input, {region: 'RU'});
  if (sequence !== requestSequence) return;
  renderSuggestions(suggestions);
}

async function onSuggestionSelected(item) {
  selectedPlaceId = item.placeId;
  const details = await fetchPlaceDetails(item.placeId);
  fillEditableAddressFields(details);
}

Добавьте debounce и AbortController, но sequence check всё равно полезен: старый ответ не должен перерисовать более свежие подсказки. Не вызывайте API для пустой строки и одного случайного символа, если UX это не требует.

Ограничение региона лучше угадывания

Если сервис работает только в нескольких странах, используйте явный country/region restriction. Location bias лишь повышает приоритет близких результатов и может оставить варианты снаружи; restriction исключает их. Язык ответа и страна — разные параметры.

  • Храните provider и place ID вместе: идентификаторы разных систем несовместимы.
  • Сохраняйте отображаемую строку и нормализованные компоненты отдельными полями.
  • Не считайте координаты доказательством возможности доставки.
  • Позвольте исправить квартиру, подъезд и комментарий без сброса улицы.
  • Не отправляйте в сторонний geocoder лишние персональные сведения.

Публичный Nominatim не является бесплатным autocomplete backend

Политика публичного `nominatim.openstreetmap.org` прямо запрещает client-side autocomplete и ограничивает нагрузку. Для production autocomplete используйте подходящего провайдера или собственный Nominatim, соблюдая лицензию, attribution, privacy и условия хранения результатов.

API key ограничьте по приложению и разрешённым API, а запросы при необходимости проксируйте через backend. Но proxy не должен превращаться в открытый endpoint для произвольного внешнего URL.

Приёмка проводится на неоднозначных вводах

Проверьте одинаковые названия улиц в двух городах, опечатку, дом без номера, новый адрес, кириллицу/латиницу, вставку полной строки и медленную сеть. После выбора измените один символ и убедитесь, что прежний place ID очищен.

Для логов достаточно длины запроса, provider status, latency, число подсказок и обезличенный request ID. Полный домашний адрес — персональные данные, его не нужно писать в telemetry для диагностики UI.

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