주소 확인 요청 보내기

다음 엔드포인트 중 하나에 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 필드를 Address Validation API로 전송할 때는 addressLines 필드 하나만 제공하면 됩니다. 그러나 가장 간단한 주소 요청에는 다음과 같은 하위 필드가 있어야 합니다.

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

USPS CASSTM 옵션

United States Postal Service® (USPS®)1Coding Accuracy Support System (CASSTM)을 유지하여 주소 검증 제공업체를 지원하고 인증합니다.

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

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

  1. Google Maps Platform은 United States Postal Service®의 비독점 라이선스 수혜자입니다. 다음 상표는 United States Postal Service®의 소유이며 미국 Postal Service®, CASSTM, CASS CertifiedTM의 허가를 받아 사용됩니다.