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

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

Отправьте строку адреса в произвольной форме и получите обратно структурированные компоненты (номер дома, дорога, город, штат, почтовый индекс, страна), координаты GPS, показатель достоверности и отформатированный адрес. Использует геокодирование для проверки существования адреса и его возможности анализа. Возвращает 404, если совпадение не найдено.

Parameters

stringrequired

Freeform address to validate.

Code examples

curl -X POST https://api.botoi.com/v1/address/validate \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

Подтвердите адрес доставки при оформлении заказа

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

Стандартизировать форматы адресов в разных системах.

Нормализуйте адреса из импорта CRM, загрузки CSV и отправки форм в единый структурированный формат. Обеспечивает наличие в вашей базе данных чистых, геокодированных адресных записей для аналитики и логистики.

Предварительное заполнение полей формы путем ввода частичного адреса

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

Frequently asked questions

Насколько точна проверка адреса?
Конечная точка использует данные геокодирования OpenStreetMap. Он силен для известных адресов в Северной Америке и Европе. Сельские или недавно построенные адреса могут иметь более низкие оценки достоверности или не возвращать никаких результатов.
Что означает показатель уверенности?
Показатель достоверности (от 0 до 1) отражает, насколько хорошо входные данные соответствуют результату геокодирования. Оценка выше 0,7 указывает на сильное совпадение. Оценка ниже 0,4 предполагает, что адрес может быть неоднозначным или частично совпадать.
Подтверждает ли это, что адрес существует как настоящий почтовый адрес?
Нет. Эта конечная точка геокодирует адрес и возвращает структурированные данные. Это подтверждает, что местоположение распознается картографическими базами данных, а не то, что почта может быть доставлена ​​туда. Для проверки доставки USPS вам понадобится API почтовой службы.
Могу ли я проверить международные адреса?
Да. Служба геокодирования охватывает адреса по всему миру. Поле Country_code в ответе сообщает вам, в какую страну разрешен адрес.
Что произойдет, если адрес окажется слишком расплывчатым?
Расплывчатые входные данные, такие как «Главная улица», могут возвращать результат с низкой достоверностью или соответствовать неправильному местоположению. Для получения лучших результатов укажите город, штат или страну.

Get your API key

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