다음 엔드포인트 중 하나에 POST 요청을 실행하여 주소 유효성 검사 요청을 보냅니다.
- validateAddress (REST)
- ValidateAddress (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=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™)을 유지 관리합니다.
미국 및 푸에르토리코 지역의 경우 요청 본문에서 enableUspsCass
를 true
로 설정하여 CASS 처리를 사용 설정할 수 있습니다. CASS를 사용할 때 최상의 결과를 얻으려면 도로명, 번지수, 시/도, 우편번호가 포함된 주소를 입력하세요.
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
사용해 보기
API 탐색기를 사용하면 샘플 요청을 실행하여 API 및 API 옵션을 익힐 수 있습니다.
페이지 오른쪽에 있는 API 아이콘 을 선택합니다.
원하는 경우 표준 매개변수 표시를 펼치고
fields
매개변수를 필드 마스크로 설정합니다.원하는 경우 요청 본문을 수정합니다.
실행 버튼을 선택합니다. 대화상자에서 요청하는 데 사용할 계정을 선택합니다.
API 탐색기 패널에서 펼치기 아이콘 을 선택하여 API 탐색기 창을 펼칩니다.
-
Google Maps Platform은 United States Postal Service®의 비독점 라이선스 소유자입니다. 다음 상표는 United States Postal Service®에서 소유하고 있으며 승인을 받아 사용합니다. United States Postal Service®, CASS™, CASS Certified™. ↩