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

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

Если ваш платежный адрес находится в Европейской экономической зоне, то с 8 июля 2025 года к использованию вами Услуг будут применяться Условия обслуживания Google Maps Platform EEA . Функциональность зависит от региона. Узнать больше .

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

• validateAddress (REST)
• ValidateAddress (gRPC)

Примечание: в этой документации для примеров используется REST, но подход аналогичен gRPC .

Ваш запрос также должен передать тело запроса 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®) ¹ использует Систему поддержки точности кодирования (CASS™) для поддержки и сертификации поставщиков услуг проверки адресов.

Примечание: API проверки адресов подтверждено как CASS-Certified™ сервис. Это означает, что сервис подтвержден на предмет его способности заполнять недостающую информацию об адресе, стандартизировать ее и обновлять до самого актуального и точного адреса.

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

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

Примечание: если вам не требуется обработка CASS или если вы проверяете адреса за пределами регионов США и Пуэрто-Рико, Google не рекомендует включать эту функцию.

Попробуйте!

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

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

2. При желании можно изменить параметры запроса.

3. Нажмите кнопку «Выполнить» . В диалоговом окне выберите учетную запись, которую вы хотите использовать для выполнения запроса.

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

---

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