Зачем использовать API проверки адресов
С помощью API проверки адресов вы можете повысить предсказуемость доставки и сократить количество сбоев доставки, тем самым улучшив качество обслуживания клиентов. Вы делаете это, перехватывая плохие адреса и получая более полное представление о характеристиках адресов.
Если вам не нужно проверять отдельные компоненты адреса для вашего запроса, API геокодирования может лучше соответствовать вашим потребностям. API геокодирования преобразует адреса в координаты широты/долготы, тогда как API проверки адресов проверяет правильность адресов. Дополнительные сведения см. в разделе «Как работает API проверки адресов» ниже, а также в обзоре API геокодирования .
Что вы можете сделать с API проверки адресов
С API проверки адресов вы можете определить, относится ли адрес к реальному месту. Если адрес не относится к реальному месту, API может определить, возможно, неправильные компоненты, которые вы можете предоставить своим клиентам для исправления. Вот пример рабочего процесса с использованием API:
Покупатель вводит адрес . На следующем изображении показана простая форма, которая позволяет покупателю ввести адрес, возможно, как часть процесса оформления заказа.
Приложение отправляет адрес в API . Приложение передает этот адрес в качестве входных данных в API проверки адреса.
API проверяет и стандартизирует адрес . В своем ответе API проверки адресов возвращает полный адрес, определенный API, или указывает, где информация отсутствует.
Клиент исправляет или подтверждает рекомендуемый адрес . В зависимости от того, что возвращает API, вы можете предоставить клиенту следующие подсказки:
Предоставьте клиенту рекомендуемый адрес для подтверждения:
Предложите клиенту добавить недостающую информацию:
Предложите пользователю исправить адрес, если API не может проверить введенный адрес из-за отсутствия или неверной информации:
Как работает API проверки адресов
Проверка адреса принимает запрос POST с адресом в виде тела JSON. Он разделяет адрес на отдельные компоненты, а затем выполняет следующие проверки и исправления:
- Обеспечивает проверки на уровне компонентов, включая подпомещения, если они доступны.
- Попытки определить отсутствующие или неправильные компоненты адреса.
- Очищает и стандартизирует формат компонентов адреса.
Попробуйте демоверсию , чтобы увидеть API проверки адресов в действии.
Ресурсы
В следующей таблице приведены ресурсы, доступные через API проверки адресов, а также данные, которые он возвращает. Дополнительные сведения см. в справочнике по API проверки адресов .
| Ресурсы данных | Данные возвращены |
|---|---|
Компоненты адреса в формате JSON. См . Проверка адреса . | Полный подтвержденный адрес (если возможно). Статус проверки каждого компонента адреса. Где доступно для адреса:
|
Как использовать API проверки адресов
| 1 | Попробуйте демо | Исследуйте демонстрацию с различными формами адресов, как правильными, так и неправильными. Демонстрация предоставляет полезный способ изучить как возвращаемые значения службы, так и ответ API в формате JSON. |
| 2 | Настройтесь. | Начните с настройки проекта Google Cloud и выполните следующие инструкции. |
| 3 | Подтвердить адрес | Начните с простого адреса, а затем, для большей точности, вы можете включить CASS (только для адресов США и PR). См . Проверка адреса. |
| 4 | Обработать ответ | Ответ API проверки адресов предоставляет два свойства, каждое из которых вы будете использовать по-разному. См . Понимание ответа проверки. |
| 5 | Повышение точности проверки | Вы можете помочь нам повысить точность адресов, отправив отзыв об ответах API проверки адресов. См. Предоставление отзыва о проверке адреса . |
Доступные клиентские библиотеки
Список доступных клиентских библиотек для API проверки адресов см. в разделе Клиентские библиотеки .
О CASS™
Почтовая служба США® (USPS®) 1 поддерживает Систему поддержки точности кодирования (CASS™) для поддержки и сертификации поставщиков проверки адресов. Служба CASS Certified™, такая как Address Validation API, была подтверждена за ее способность заполнять информацию, отсутствующую в адресе, стандартизировать ее и обновлять, чтобы предоставить вам самый актуальный и самый точный адрес.
CASS не включен по умолчанию и поддерживается только для регионов «US» и «PR». Чтобы включить CASS, установите для параметра enableUspsCass значение true как часть запроса на проверку. Дополнительные сведения см. в разделе Проверка адреса .
В рамках использования нами услуг USPS USPS оценивает запросы на искусственно созданные адреса. Если USPS идентифицирует входной адрес как искусственно созданный, Google обязан прекратить проверку адресов для клиента и должен сообщить контактную информацию клиента (имя и адрес), соответствующий входной адрес и агрегированные данные об использовании в USPS. Используя API, вы соглашаетесь с настоящими Условиями обслуживания .
Что дальше
- Просмотрите часто задаваемые вопросы : Перейти к часто задаваемым вопросам
- Проверьте зоны покрытия : перейдите к сведениям о покрытии по странам и регионам.
- Обработка адресов с большим объемом : перейдите к разделу Использование API проверки адресов для обработки адресов с большим объемом.
Платформа Google Maps является неэксклюзивным лицензиатом Почтовой службы США®. Следующие товарные знаки принадлежат Почтовой службе США® и используются с разрешения: Почтовая служба США®, CASS™, CASS Certified™. ↩