주소 확인 요청 보내기

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

또한 요청은 검증할 주소를 정의하는 요청에 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"]
  },
}

사용해 보기

주소 요청 필드

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

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

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

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

USPS CASS™ 옵션

United States Postal Service® (USPS®)1는 주소 유효성 검사 제공업체를 지원하고 인증하기 위해 Coding Accuracy Support System (CASS™)을 유지 관리합니다.

미국 및 푸에르토리코 지역의 경우 요청 본문에서 enableUspsCasstrue로 설정하여 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. 원하는 경우 표준 매개변수 표시를 펼치고 fields 매개변수필드 마스크로 설정합니다.

  3. 원하는 경우 요청 본문을 수정합니다.

  4. 실행 버튼을 선택합니다. 대화상자에서 요청하는 데 사용할 계정을 선택합니다.

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


  1. Google Maps Platform은 United States Postal Service®의 비독점 라이선스 소유자입니다. 다음 상표는 United States Postal Service®에서 소유하고 있으며 승인을 받아 사용합니다. United States Postal Service®, CASS™, CASS Certified™.