Не отправляйте форму по первой строке autocomplete. Пользователь вводит неоднозначный текст, сервис возвращает варианты, а приложение должно сохранить выбранный place ID и только затем получить структурированные детали. Номер квартиры или офиса оставьте отдельным редактируемым полем: подсказка часто его не содержит.
Для ввода в реальном времени используйте специализированный autocomplete, а не geocoding полного адреса на каждую клавишу. Google рекомендует Place Autocomplete для неполных и неоднозначных строк; geocoding лучше подходит для уже полного адреса.
Поле адреса имеет четыре состояния
| Состояние | Что хранится | Можно продолжать |
|---|---|---|
| empty | Ничего | Нет |
| typing | Raw input и request sequence | Нет, подсказки ещё могут измениться |
| selected | place ID, display text, provider | Да после получения деталей |
| edited_after_select | Новый raw input, старый ID сброшен | Нет до нового выбора или ручной проверки |
| manual_confirmed | Raw 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.