주소 확인 요청 보내기

POST 요청을 전송하여 지정할 수 있습니다

또한 요청은 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®)1는 지원 및 인증을 위한 코딩 정확도 지원 시스템 (CASSTM) 주소 확인 제공업체에 대해 자세히 알아보기

미국 및 푸에르토리코 지역에 한해 요청 본문에서 enableUspsCasstrue로 설정합니다. 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®, CASSTM, CASS CertifiedTM.