주소 확인 요청 보내기

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 탐색기 창을 펼칩니다.