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

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

Отправьте запрос на проверку адреса, отправив запрос 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 в API проверки адресов вам достаточно указать только одно поле: addressLines . Однако простейший запрос адреса должен содержать следующие подполя:

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

опция USPS CASS™

Почтовая служба США® (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. Нажмите кнопку «Выполнить» . В диалоговом окне выберите учётную запись, которую вы хотите использовать для отправки запроса.

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

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