주소 확인 요청 보내기

유럽 경제 지역 (EEA) 개발자

다음 엔드포인트 중 하나에 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"]
  },
}

API 탐색기를 사용하면 실시간 요청을 수행하여 API 및 API 옵션을 숙지할 수 있습니다.

주소 요청 필드

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

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

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

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

USPS CASS™ 옵션

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

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