주소 확인 요청 보내기

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

• validateAddress (REST)
• ValidateAddress (gRPC)

참고: 이 문서에서는 예시로 REST를 사용하지만 접근 방식은 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=YOUR_API_KEY"

locality를 생략하고 addressLines 배열의 요소로 지정할 수도 있습니다.

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

주소 요청 입력란

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

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

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

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

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

USPS CASSTM 옵션

미국 Postal Service® (USPS®)¹는 주소 확인 제공업체를 지원 및 인증하는 코딩 정확성 지원 시스템 (CASSTM)을 운영합니다.

참고: Address Validation API는 CASS 인증TM 서비스로 확인되었습니다. 즉, 누락된 주소 정보를 입력하고 표준화한 후 정확한 최신 주소로 업데이트할 수 있는지 서비스가 확인됩니다.

US 및 PR 지역에 한해 요청 본문에서 enableUspsCass를 true로 설정하여 CASS 처리를 사용 설정할 수 있습니다. CASS를 사용할 때 최상의 결과를 얻으려면 도로명, 구/군/시, 우편번호가 포함된 주소를 제공하세요.

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

참고: CASS 처리가 필요하지 않거나 미국 및 PR 지역 외 주소의 유효성을 검사하는 경우 이 기능을 사용 설정하지 않는 것이 좋습니다.

---

1. Google Maps Platform은 United States Postal Service®의 비독점 라이선스 수혜자입니다. 다음 상표는 United States Postal Service®가 소유하며 United States Postal Service®, CASSTM, CASS CertifiedTM의 승인 하에 사용됩니다. ORDINAL