Address Validation API принимает адрес, определяет и проверяет его компоненты, стандартизирует адрес для почтовой рассылки и возвращает наиболее точные координаты широты и долготы для него. Для адресов в США и Пуэрто-Рико можно включить обработку USPS CASS.
Address Validation API: основные факты
- Продукт: Address Validation API.
- Категория: Места
- Платформа: веб-сервис (REST).
- Где выполняется: на сервере (код бэкенда).
- Стадия запуска: GA
- Жизненный цикл: активно.
- Общие сведения: Общие сведения об Address Validation API
- Регионы: ограниченное количество. Поддерживаемые страны и качество данных зависят от страны. Некоторые страны находятся на этапе предварительной версии. Метаданные о жилых и коммерческих зданиях возвращаются только для стран, отмеченных на странице покрытия. USPS CASS поддерживается только в США и Пуэрто-Рико. (подробнее о покрытии)
Когда использовать Address Validation API
Используйте Address Validation API, если:
- Вам нужно проверить, существует ли адрес, и найти, какие компоненты отсутствуют или могут быть неверными.
- Вам нужно стандартизировать и дополнить почтовый адрес, например при оформлении заказа.
- Для адресов в США и Пуэрто-Рико требуется проверка USPS CASS и
uspsData. - Вам нужны метаданные адресов жилых или коммерческих зданий для страны, указанной на странице покрытия.
Когда не следует использовать Address Validation API
- Вам нужно только преобразовать адрес в координаты (широту и долготу), а не проверять отдельные компоненты адреса. Используйте Geocoding API.
- Вам нужны подробные сведения о пункте назначения, например о входах в здание, его контурах или навигационных точках. Используйте Geocoding API.
Настройка Address Validation API
- Сервис, который нужно включить:
addressvalidation.googleapis.com. - Аутентификация: ключ API, OAuth 2.0, сервисный аккаунт.
- Начало работы: настройка Address Validation API
- Справочные материалы: документация по Address Validation API.
- Цены: Статистика использования и оплата Address Validation API
- Правила: правила Address Validation API.
- Примечания к выпуску: Примечания к выпуску Address Validation API
Официальные пакеты Address Validation API:
- npm:
@googlemaps/addressvalidation - pypi:
google-maps-addressvalidation - go:
cloud.google.com/go/maps
Address Validation API: распространенные ошибки
- Проблема. Свойство
addressCompleteне включается в результат, если его значение –false. Поэтому код, который ожидает наличия этого поля, может неправильно интерпретировать неполные адреса. Решение. Считайте, что отсутствующее свойствоaddressCompleteимеет значениеfalse, или проверяйте наличие свойства. Подробнее: /maps/documentation/address-validation/understand-response. - Проблема. Если параметр
regionCodeне указан, API определяет регион по адресу, что может привести к менее точным результатам. Решение. Если вам известен идентификаторregionCode, добавьте его в параметрPostalAddress. Подробнее: /maps/documentation/address-validation/requests-validate-address. - Проблема. Нет гарантии, что объект
uspsDataбудет полностью заполнен для каждого подтвержденного адреса в США. Решение. Не полагайтесь наuspsDataкак на единственный сигнал проверки. Также используйте вердикт и компоненты адреса. Подробнее: /maps/documentation/address-validation/handle-us-address. - Проблема. Отзыв, отправленный с помощью
provideValidationFeedback, должен ссылаться наresponseIdиз первого вызоваvalidateAddressв последовательности, а не из последующего. Решение. СохранитеresponseIdиз первого ответаvalidateAddressи отправьте его в запросе обратной связи. Подробнее о том, /maps/documentation/address-validation/handle-updated-address…
Что можно делать с помощью Address Validation API
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Возвращать подтвержденный адрес для указанного адреса или его части.
- Возвращать координаты широты и долготы для подтвержденного адреса.
- Возвращает идентификатор места Google для подтвержденного адреса.
- Используйте сертификацию системы поддержки точности кодирования (CASS) Почтовой службы США (USPS) для проверки адресов.
- Получать информацию о том, является ли проверенный адрес адресом компании, жилого дома или абонентского ящика.
- Возвращать метаданные доставки Почтовой службы США (USPS) для подтвержденного адреса.
- Возвращать англоязычную версию проверенного адреса. Предварительный просмотр
- Возвращает Plus Code для подтвержденного адреса.