주소 확인 요청 보내기

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

• validateAddress (REST)
• ValidateAddress (gRPC)

또한 요청은 검증할 주소를 정의하는 요청에 JSON 요청 본문을 전달해야 합니다. 다음 요청 본문에는 필드 1개와 하위 필드 3개가 포함되어 있습니다.

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: addressLines에 항목이 하나 이상 포함되어야 하는 PostalAddress 유형의 필드입니다.

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

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

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

USPS CASS™ 옵션

United States Postal Service® (USPS®)¹는 주소 유효성 검사 제공업체를 지원하고 인증하기 위해 Coding Accuracy Support System (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 탐색기 패널에서 전체 화면 아이콘 fullscreen을 선택하여 API 탐색기 창을 펼칩니다.