Введение
API проверки адреса — это служба, которая принимает адрес. Она определяет компоненты адреса и проверяет их. Она также стандартизирует адрес для почтовой рассылки и находит для него наиболее известные координаты широты/долготы. При желании для адресов в США и Пуэрто-Рико можно включить систему поддержки точности кодирования (CASS™) .Зачем использовать API проверки адреса
С помощью API проверки адресов вы можете улучшить предсказуемость доставки и сократить количество сбоев доставки, тем самым обеспечивая улучшенный клиентский опыт. Вы делаете это, отлавливая плохие адреса и получая более точную информацию о характеристиках адресов.
Geocoding API может лучше соответствовать вашим потребностям, если вам не нужно проверять отдельные компоненты адреса. Geocoding API преобразует адреса в координаты широты и долготы. Address Validation API проверяет адреса на корректность . Подробное сравнение см. в разделе Building location validation capabilities using Google Maps Platform в Architecture Center.
Что можно сделать с помощью API проверки адресов
С помощью API проверки адреса вы можете определить, относится ли адрес к реальному месту. Если адрес не относится к реальному месту, API может определить потенциально неверные компоненты, которые вы можете предоставить своим клиентам для исправления. Вот пример рабочего процесса с использованием API:
Клиент вводит адрес . На следующем изображении показана базовая форма, позволяющая клиенту ввести адрес, возможно, в ходе оформления заказа.
Приложение отправляет адрес в API . Приложение передает этот адрес в качестве входных данных в API проверки адреса.
API проверяет и стандартизирует адрес . В своем ответе API проверки адреса возвращает полный адрес, определенный API, или указывает, где отсутствует информация.
Клиент подтверждает или исправляет адрес — в зависимости от того, что возвращает API, вы можете предоставить клиенту следующие подсказки: A. Подтвердить рекомендуемый адрес. B. Предоставить недостающую информацию. C. Исправить адрес.
Как работает API проверки адреса
Проверка адреса принимает запрос POST с адресом в виде тела JSON. Она разделяет адрес на отдельные компоненты, а затем пытается сделать следующее:
- Исправления — обеспечивает проверки на уровне компонентов, включая подсистемы, где это возможно.
- Завершает — пытается определить отсутствующие или неверные компоненты адреса.
- Форматы — очищает и стандартизирует формат компонентов адреса.
Ресурсы
В следующей таблице обобщены ресурсы, доступные через API проверки адресов, а также возвращаемые им данные. Для получения подробной информации см. Справочник API проверки адресов .
| Ресурсы данных | Данные возвращены |
|---|---|
Компоненты адреса в формате JSON. См. Проверка адреса . | Полный, подтвержденный адрес (если возможно). Статус проверки каждого компонента адреса. Если доступно по адресу:
См. раздел Понимание ответа проверки . |
Как использовать API проверки адреса
| 1 | Попробуйте демо-версию | Исследуйте демо с различными формами адресов, как правильными, так и неправильными. Демо предоставляет полезный способ изучить как возвращаемые значения от сервиса, так и ответ API в формате JSON. |
| 2 | Проверить покрытие | Ознакомьтесь с подробностями покрытия , чтобы узнать, какие страны и регионы поддерживает API проверки адресов. |
| 3 | Настройте | Начните с настройки проекта Google Cloud и следуйте приведенным ниже инструкциям. |
| 4 | Запросить проверку адреса | Начните с базового адреса, а затем, для дополнительной точности, вы можете включить CASS (только для адресов в США и Пуэрто-Рико). См. Запросить проверку адреса. |
| 5 | Обработать ответ | Ответ API проверки адреса предоставляет два свойства, каждое из которых используется по-разному. См. Понять базовый ответ. |
| 6 | Повышение точности проверки | Вы можете помочь улучшить точность адресов, предоставив отзыв об ответах API проверки адресов. См. Обработка обновленных адресов . |
Доступные клиентские библиотеки
Список доступных клиентских библиотек для API проверки адресов см. в разделе Клиентские библиотеки .
О CASS™
Почтовая служба США® (USPS®) 1 поддерживает систему поддержки точности кодирования (CASS™) для поддержки и сертификации поставщиков услуг проверки адресов. Служба CASS Certified™, такая как API проверки адресов, была подтверждена на предмет ее способности заполнять отсутствующую в адресе информацию, стандартизировать ее и обновлять, чтобы предоставить вам самый актуальный и точный адрес.
CASS не включен по умолчанию и поддерживается только для регионов "US" и "PR". Чтобы включить CASS, установите enableUspsCass на true как часть запроса на проверку. Для получения дополнительной информации см. Проверка адреса .
В рамках нашего использования услуг USPS, USPS оценивает запросы на искусственно созданные адреса. Если USPS определяет, что адрес ввода создан искусственно, Google обязан прекратить проверку адресов для клиента и должен сообщить контактную информацию клиента (имя и адрес), соответствующий адрес ввода и агрегированные данные об использовании в USPS. Используя API, вы соглашаетесь с этими Условиями использования сервиса .
Что дальше?
- Попробуйте демо : Перейти к демо
- Обзор зон покрытия : Перейти к сведениям о странах и регионах покрытия
- Попробуйте свой первый запрос на проверку : Перейти к разделу «Отправить запрос на проверку адреса»
- Обработка адресов в больших объемах : Перейти к использованию API проверки адресов для обработки адресов в больших объемах
Google Maps Platform является неисключительным лицензиатом United States Postal Service®. Следующие товарные знаки принадлежат United States Postal Service® и используются с разрешения: United States Postal Service®, CASS™, CASS Certified™. ↩