Перейти к содержимому
POST AI agent ready /v1/address/autocomplete

API автозаполнения адресов — бесплатные предложения адресов

Отправьте запрос частичного адреса и получите до 10 структурированных предложений адресов с указанием улицы, города, штата, страны и координат GPS. Предназначен для поиска по мере ввода адресных полей. Поддерживает языковые предпочтения для локализованных результатов.

Parameters

stringrequired

Partial address to autocomplete.

number

Max suggestions to return (1-10).

string

ISO 639-1 language code for results.

Code examples

curl -X POST https://api.botoi.com/v1/address/autocomplete \
  -H "Content-Type: application/json" \
  -d '{"query":"1600 Amphithea","limit":3,"lang":"en"}'

When to use this API

Создайте поля адреса для поиска по мере ввода

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

Уменьшите количество ошибок в форме при мобильной оплате

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

Поиск местоположения электропитания в картографических приложениях

Используйте автозаполнение, чтобы пользователи могли искать места по названию или адресу. Каждое предложение включает координаты, поэтому вы можете центрировать карту по выбранному результату без отдельного вызова геокодирования.

Frequently asked questions

Сколько предложений я могу запросить?
Установите параметр лимита в диапазоне от 1 до 10. Значение по умолчанию — 5. API возвращает не более количества найденных совпадающих результатов, которое может быть меньше лимита.
Какие языки поддерживаются?
Передайте любой языковой код ISO 639-1 (например, «de» для немецкого языка, «ja» для японского языка). Результаты возвращаются на запрошенном языке, если доступны переводы. В противном случае возвращается к местному языку.
Существует ли минимальная длина запроса?
Запрос должен содержать хотя бы один символ без пробелов. Более короткие запросы возвращают более широкие результаты. Чтобы получить лучшие предложения, отправьте не менее 3–4 символов.
Работает ли это для названий компаний или почтовых адресов?
Это работает для обоих. Геокодер сопоставляет уличные адреса, кварталы, города и названные места. Названия компаний могут совпадать или не совпадать в зависимости от покрытия картографической базы данных.
Каково время ответа?
Типичное время ответа составляет 100–300 мс в зависимости от нагрузки службы геокодирования. Для более плавного ввода текста настройте запросы на отклонение, которые будут запускаться через 150–200 мс после того, как пользователь перестанет печатать.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs