주소 확인 요청 보내기

POST 요청을 전송하여 지정할 수 있습니다

• validateAddress (REST)
• ValidateAddress (gRPC)

를 통해 개인정보처리방침을 정의할 수 있습니다.

또한 요청은 JSON 요청 본문을 확인할 주소를 정의합니다. 다음 요청 본문에는 필드 1개가 포함되어 있습니다. 세 개의 하위 필드가 있습니다.

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"]
  },
}

실습

주소 요청 필드

요청 본문은 단일 필드로 구성됩니다.

• address: PostalAddress 유형의 필드. 에 addressLines에 항목이 하나 이상 있어야 합니다.

address 필드를 Address Validation API로 전송할 때는 addressLines 필드 1개 입력 그러나 가장 간단한 주소 요청은 다음 하위 필드를 포함해야 합니다.

• regionCode - 권장. 이 입력란은 선택사항이지만 생략할 경우 Address Validation API는 주소에서 지역을 추론합니다. 그러나 최적의 결과에 regionCode를 알고 있다면 포함하세요. 지원되는 리전 목록은 지원되는 리전을 참조하세요.
• addressLines - 필수 항목입니다. 하위 도메인을 설명하는 주소가 있는 배열 확인할 수 있습니다.

참조 가이드의 PostalAddress를 참조하세요.

USPS CASSTM 옵션

USPS® (USPS®)¹는 지원 및 인증을 위한 코딩 정확도 지원 시스템 (CASSTM) 주소 확인 제공업체에 대해 자세히 알아보기

미국 및 푸에르토리코 지역에 한해 요청 본문에서 enableUspsCass를 true로 설정합니다. 사용 시 최상의 결과를 얻으려면 CASS의 경우 도로 및 번지가 포함된 주소를 제공하세요. 시/도 및 우편번호:

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

사용해 보기

API 탐색기를 사용하면 샘플 요청을 수행하여 API 및 API 옵션에 익숙해지실 수 있습니다.

1. API 아이콘 을 선택합니다. 을 클릭합니다.

2. 필요한 경우 표준 매개변수 표시를 펼치고 fields 매개변수를 필드에 추가합니다. 마스크입니다.

3. 필요한 경우 요청 본문을 수정합니다.

4. 실행 버튼을 선택합니다. 대화상자에서 전체 목록을 제공합니다.

5. API 탐색기 패널에서 펼치기 아이콘을 선택합니다. : API 탐색기 창을 펼칩니다.