주소 확인 요청 보내기

다음 엔드포인트 중 하나에 POST 요청을 실행하여 주소 유효성 검사 요청을 보냅니다.

• validateAddress (REST)
• ValidateAddress (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 탐색기를 사용하면 API와 API 옵션을 숙지할 수 있도록 라이브 요청을 할 수 있습니다.

주소 요청 필드

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

• address: PostalAddress 유형의 필드로, addressLines에 항목이 하나 이상 포함되어야 합니다.

address 필드를 Address Validation API에 보낼 때는 addressLines 필드 하나만 제공하면 됩니다. 하지만 가장 간단한 주소 요청에는 다음 하위 필드가 포함되어야 합니다.

• regionCode - 권장 선택사항 필드이지만 생략하면 Address Validation API가 주소에서 지역을 추론합니다. 하지만 최상의 결과를 얻으려면 regionCode를 알고 있는 경우 포함하세요. 지원되는 리전 목록은 지원되는 리전을 참고하세요.
• addressLines - 필수 주소의 하위 구조를 설명하는 주소가 포함된 배열입니다.

참조 가이드에서 PostalAddress를 확인하세요.

USPS CASS™ 옵션

미국 우편 서비스 (USPS®)¹는 주소 유효성 검사 제공업체를 지원하고 인증하기 위해 우편번호 정확도 지원 시스템 (CASS™)을 유지합니다.

미국 및 푸에르토리코 지역의 경우 요청 본문에서 enableUspsCass을 true로 설정하여 CASS 처리를 사용 설정할 수 있습니다. CASS를 사용할 때 최상의 결과를 얻으려면 도로명 및 건물 번호와 함께 도시, 주, 우편번호가 포함된 주소를 입력하세요.

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

기능을 사용해 보세요.

API 탐색기를 사용하면 API 및 API 옵션에 익숙해질 수 있도록 샘플 요청을 할 수 있습니다.

1. 페이지 오른쪽에서 API 아이콘 api을 선택합니다.

2. 원하는 경우 요청 매개변수를 수정합니다.

3. 실행 버튼을 선택합니다. 대화상자에서 요청을 보낼 때 사용할 계정을 선택합니다.

4. API 탐색기 패널에서 전체 화면 아이콘 전체 화면을 선택하여 API 탐색기 창을 펼칩니다.