Отправка запроса на проверку адреса

Разработчики из Европейской экономической зоны (ЕЭЗ)

Отправьте запрос Address Validation, выполнив запрос POST к одной из следующих конечных точек:

В запросе также должно передаваться тело запроса JSON, определяющее адрес для проверки. Тело запроса ниже содержит одно поле и три подполя:

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

Вы также можете опустить locality и указать его как элемент в массиве addressLines:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

API Explorer позволяет отправлять запросы в реальном времени, чтобы вы могли ознакомиться с API и его возможностями.

Поля запроса адреса

Тело запроса состоит из одного поля:

  • address – поле типа PostalAddress, которое должно содержать хотя бы одну запись в addressLines.

При отправке поля address в Address Validation API нужно указать только одно поле: addressLines. Однако самый простой запрос адреса должен содержать следующие подполя:

  • regionCode – рекомендуется. Это необязательное поле, но если его не заполнить, Address Validation API определит регион по адресу. Однако для достижения наилучших результатов укажите regionCode, если вы его знаете. Ознакомьтесь со списком поддерживаемых регионов.
  • addressLines – обязательный параметр. Массив с адресами, описывающими нижнюю структуру адреса.
Подробную информацию вы найдете в разделе PostalAddress справочного руководства.

Опция USPS CASS™

Почтовая служба США (United States Postal Service®, USPS®)1 обеспечивает поддержку и сертификацию поставщиков услуг по проверке адресов с помощью системы поддержки точности кодирования (CASS™).

Только для США и Пуэрто-Рико: вы можете включить обработку CASS, задав для параметра enableUspsCass значение true в теле запроса. Чтобы получить наилучшие результаты при использовании CASS, укажите адрес, включающий улицу и номер дома, а также город, штат и почтовый индекс:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

Попробовать

API Explorer позволяет отправлять тестовые запросы, чтобы вы могли ознакомиться с API и его возможностями.

  1. Нажмите на значок API api в правой части страницы.

  2. При необходимости измените параметры запроса.

  3. Нажмите кнопку Execute (Выполнить). В диалоговом окне выберите аккаунт, который хотите использовать для отправки запроса.

  4. На панели API Explorer нажмите на значок полноэкранного режима fullscreen, чтобы развернуть окно API Explorer.

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