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