Обзор API проверки адреса

Address Validation Overview

API проверки адреса — это служба, которая принимает адрес. Он идентифицирует компоненты адреса и проверяет их. Он также стандартизирует адрес для рассылки и находит для него наиболее известные координаты широты и долготы. При желании для адресов в США и Пуэрто-Рико можно включить систему поддержки точности кодирования (CASS™) .

Зачем использовать API проверки адреса

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

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

Что вы можете сделать с помощью API проверки адреса

С помощью API проверки адреса вы можете определить, относится ли адрес к реальному месту. Если адрес не относится к реальному месту, API может определить возможно неправильные компоненты, которые вы можете предоставить своим клиентам для исправления. Вот пример рабочего процесса с использованием API:

  1. Клиент вводит адрес . На следующем изображении показана простая форма, которая позволяет клиенту ввести адрес, возможно, в рамках процесса оформления заказа.
    Адрес, введенный клиентом.

  2. Приложение отправляет адрес в API . Приложение передает этот адрес в качестве входных данных для API проверки адреса.

  3. API проверяет и стандартизирует адрес . В своем ответе API проверки адреса возвращает полный адрес, определенный API, или указывает, где информация отсутствует.

  4. Клиент исправляет или подтверждает рекомендованный адрес . В зависимости от того, что возвращает 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, вы соглашаетесь с настоящими Условиями обслуживания .

Что дальше


  1. Платформа Google Maps является неисключительным лицензиатом Почтовой службы США®. Следующие товарные знаки принадлежат Почтовой службе США® и используются с разрешения: United States Postal Service®, CASS™, CASS Certified™.