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

Шесть полей адреса в форме — это шесть шансов ошибиться и шесть причин её бросить. Подсказки сводят всё к одному полю. Ниже — два способа подключения и что оказывается на вашей стороне после выбора адреса.

Зачем подсказки в форме адреса

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

Классическая форма просит регион, город, улицу, дом, квартиру и индекс по отдельности. Человек печатает всё это руками, ошибается в паре мест и уходит. С подсказками он набирает начало адреса, выбирает строку из списка — и на вашей стороне оказывается готовая строка вместе с разбором на части, индексом, кодами и координатами.

Способ первый: готовый виджет

Подключается к существующему полю: скрипт на страницу, атрибуты на поле, ключ. Дальше виджет сам рисует список, обрабатывает клавиатуру и подставляет выбранное. Цвета и размеры задаются CSS-переменными — список выглядит частью вашей формы, а не вставкой из чужого сервиса.

Способ второй: вызов из своего кода

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

Что приходит в ответе

ЧтоПримерЗачем
Готовая строкаг Москва, ул Тверская, д 7Показать человеку, положить в документ
Разбор на частирегион, город, улица, дом, квартираРазложить по полям базы, посчитать доставку
Индекс125009Печатные документы, почтовая отправка
КодыФИАС, КЛАДР, ОКАТО, ОКТМООтчётность и обмен с государственными системами
Координатыширота и долготаКарта, зоны доставки, ближайший пункт выдачи

Как проверить до внедрения

  • Получите ключ — регистрация без карты.
  • Возьмите десяток адресов из своей базы, обязательно с опечатками и сокращениями.
  • Посмотрите на три вещи: находится ли адрес, приходит ли индекс, попадает ли дом в нужный регион.
  • Прикиньте объём: 10 000 запросов в день входят в бесплатный лимит.

Частые вопросы про подсказки адресов

Подсказки работают с опечатками?
Да, неточный ввод — основной режим работы, а не крайний случай: пропущенные буквы, сокращения, другой порядок слов.
Можно ограничить подсказки одним городом?
Да, поиск сужается по региону или городу. Удобно, когда доставка работает не по всей стране.
Что делать с адресами, которые уже накоплены?
Привести к реестру пакетно — это стандартизация, отдельный метод и отдельная тарификация.
Нужно ли хранить строку адреса?
Лучше хранить код ФИАС и показывать строку. Почему — разобрано в статье про ФИАС и ГАР.
Сколько это стоит?
10 000 запросов в день бесплатно, дальше по тарифам.

Автозаполнение адреса и автозаполнение браузера — разные вещи

Браузер подставляет то, что человек когда-то вводил сам, — вместе с опечатками и старыми названиями улиц. Автозаполнение адреса от сервиса берёт данные из реестра ГАР/ФИАС, поэтому в базу попадает существующий адрес с индексом и кодами, а не «ул. Ленино, д 5» из чьей-то прошлой доставки.

Читайте также

← Все статьи