Введение
API проверки адресов — это сервис, который принимает адрес. Он идентифицирует компоненты адреса и проверяет их. Он также стандартизирует адрес для почтовой рассылки и находит для него наиболее подходящие известные координаты широты/долготы. При желании, для адресов в США и Пуэрто-Рико можно включить систему поддержки точности кодирования (CASS™) .Зачем использовать API проверки адресов?
С помощью API проверки адресов вы можете повысить предсказуемость доставки и уменьшить количество сбоев в доставке, тем самым улучшив качество обслуживания клиентов. Это достигается за счет выявления некорректных адресов и более точного определения характеристик адресов.
Другие соображения
API проверки адресов проверяет адреса на корректность . API геокодирования преобразует адреса в координаты широты и долготы. Подробное сравнение см. в разделе «Возможность проверки местоположения здания с использованием платформы Google Maps» в Центре архитектуры.
API геокодирования может лучше подойти для ваших нужд, если вам не требуется проверка отдельных компонентов адреса или если вам необходимы сверхточные локальные данные о местоположении, такие как входы в здания, контуры зданий и точки навигации.
В API геокодирования версии 4 представлен метод SearchDestinations , который возвращает координаты входов в здания, точек навигации и контуров зданий. Более подробную информацию см. в разделе «Поиск пунктов назначения» API геокодирования версии 4.
Что можно сделать с помощью 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®) ¹ поддерживает систему поддержки точности кодирования (CASS™) для поддержки и сертификации поставщиков услуг по проверке адресов. Сертифицированный CASS™ сервис, такой как API проверки адресов, подтвержден на предмет его способности заполнять недостающую информацию в адресе, стандартизировать ее и обновлять, чтобы предоставить вам наиболее актуальный и точный адрес.
Функция CASS по умолчанию отключена и поддерживается только для регионов «США» и «Пуэрто-Рико». Чтобы включить CASS, установите enableUspsCass в true в запросе на проверку. Для получения дополнительной информации см. раздел «Проверка адреса» .
В рамках использования нами услуг USPS, USPS рассматривает запросы на искусственно созданные адреса. Если USPS определяет введенный адрес как искусственно созданный, Google обязан прекратить проверку адресов клиента и сообщить USPS контактную информацию клиента (имя и адрес), соответствующий введенный адрес и сводные данные об использовании. Используя API, вы соглашаетесь с настоящими Условиями использования сервиса .
Что дальше?
- Попробуйте демоверсию : Перейти к демоверсии
- Проверка зон покрытия : перейдите к подробной информации о покрытии по странам и регионам.
- Попробуйте выполнить первый запрос на подтверждение адреса : перейдите в раздел «Отправить запрос на подтверждение адреса».
- Обработка большого объема адресов : перейдите в раздел «Использование API проверки адресов» для обработки большого объема адресов.
Платформа Google Maps является неисключительным лицензиатом Почтовой службы США®. Следующие товарные знаки принадлежат Почтовой службе США® и используются с разрешения: Почтовая служба США®, CASS™, CASS Certified™. ↩