다음 엔드포인트 중 하나에 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=YOUR_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 옵션
미국 Postal Service® (USPS®)1는 주소 확인 제공업체를 지원 및 인증하는 코딩 정확성 지원 시스템 (CASSTM)을 운영합니다.
US 및 PR 지역에 한해 요청 본문에서 enableUspsCass
를 true
로 설정하여 CASS 처리를 사용 설정할 수 있습니다. CASS를 사용할 때 최상의 결과를 얻으려면 도로명, 구/군/시, 우편번호가 포함된 주소를 제공하세요.
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
-
Google Maps Platform은 United States Postal Service®의 비독점 라이선스 수혜자입니다. 다음 상표는 United States Postal Service®가 소유하며 United States Postal Service®, CASSTM, CASS CertifiedTM의 승인 하에 사용됩니다. ORDINAL