Address Validation API를 사용하는 이유
Address Validation API를 사용하면 전송 예측 가능성을 개선하고 전송 실패를 줄여 고객 환경을 개선할 수 있습니다. 이렇게 하려면 잘못된 주소를 포착하고 주소 특성에 대한 인식을 개선해야 합니다.
요청에 대해 개별 주소 구성요소를 확인할 필요가 없다면 Geocoding API가 더 적합할 수 있습니다. Geocoding API는 주소를 위도/경도 좌표로 변환하는 반면 Address Validation API는 주소가 올바른지 확인합니다. 자세한 내용은 아래 Address Validation API의 작동 방식과 Geocoding API 개요를 참고하세요.
Address Validation API로 할 수 있는 작업
Address Validation API를 사용하면 주소가 실제 장소를 참조하는지 확인할 수 있습니다. 주소가 실제 장소를 참조하지 않는 경우 API는 고객에게 수정할 수 있는 잘못된 구성요소를 식별할 수 있습니다. 다음은 API를 사용하는 샘플 워크플로입니다.
고객이 주소를 입력함 – 다음 이미지는 고객이 결제 과정의 일부로 주소를 입력할 수 있는 간단한 양식을 보여줍니다.
앱이 API에 주소를 전송함 – 애플리케이션이 이 주소를 Address Validation API에 입력으로 전달합니다.
API가 주소 유효성 검사 및 표준화 - 이 응답에 포함된 Address Validation API는 API에서 결정한 대로 전체 주소를 반환하거나 정보가 누락된 위치를 표시합니다.
고객이 추천 주소를 수정 또는 확인함 – API에서 반환하는 내용에 따라 고객에게 다음 메시지를 제공할 수 있습니다.
고객이 확인할 수 있도록 추천 주소를 제시하세요.
고객에게 누락된 정보를 추가하라는 메시지를 표시합니다.
누락되거나 잘못된 정보로 인해 API에서 입력 주소를 확인할 수 없는 경우 사용자에게 주소를 수정하라는 메시지를 표시합니다.
Address Validation API의 작동 방식
주소 확인은 주소가 포함된 JSON 형식의 POST 요청을 허용합니다. 주소를 개별 구성요소로 분리한 후 다음 검사 및 수정을 수행합니다.
- 가능한 경우 하위 온프레미스를 포함한 구성요소 수준의 유효성 검사를 제공합니다.
- 누락되거나 잘못된 주소 구성요소를 추론합니다.
- 주소 구성요소의 형식을 정리하고 표준화합니다.
Address Validation API의 실제 작동 모습을 보려면 데모를 사용해 보세요.
자료
다음 표에는 Address Validation API를 통해 사용할 수 있는 리소스와 리소스가 반환되는 데이터가 요약되어 있습니다. 자세한 내용은 Address Validation API 참조를 확인하세요.
| 데이터 리소스 | 반환된 데이터 |
|---|---|
|
JSON 형식의 주소 구성요소. 주소 확인을 참고하세요. |
주소를 확인하고 주소를 입력해 주세요 (가능한 경우). 각 주소 구성요소의 유효성 검사 상태입니다. 주소에 사용 가능한 국가:
유효성 검사 응답 이해하기를 참고하세요. |
Address Validation API 사용 방법
| 1 | 데모 사용해 보기 | 정확하거나 잘못된 다양한 주소 양식으로 데모를 살펴보세요. 데모에서는 서비스의 반환 값과 JSON 형식의 API 응답을 모두 살펴볼 수 있는 유용한 방법을 제공합니다. |
| 2 | 설정하기 | Google Cloud 프로젝트 설정부터 시작하여 안내를 따르세요. |
| 3 | 주소 확인 | 간단한 주소로 시작하고 추가 정확도를 위해 CASS를 사용 설정할 수 있습니다 (미국 및 PR 주소만 해당). 주소 확인을 참고하세요. |
| 4 | 응답 처리 | Address Validation API 응답은 두 가지 속성을 제공하며 각 속성은 다양한 방식으로 사용됩니다. 유효성 검사 응답 이해하기를 참고하세요. |
| 5 | 검증 정확성 개선 | Address Validation API 응답에 대한 의견을 보내 주시면 주소 정확성 개선에 도움이 됩니다. 주소 확인 의견 보내기를 참고하세요. |
사용 가능한 클라이언트 라이브러리
Address Validation API에 사용할 수 있는 클라이언트 라이브러리 목록은 클라이언트 라이브러리를 참조하세요.
CASSTM 정보
미국 우편 서비스® (USPS®)1는 주소 확인 제공업체를 지원하고 인증하기 위해 코딩 정확도 지원 시스템 (CASSTM)을 유지합니다. Address Validation API와 같은 CASS CertifiedTM 서비스는 주소에서 누락된 정보를 작성하고 표준화하고 업데이트하여 최신의 정확한 주소를 제공할 수 있는 기능이 확인되었습니다.
CASS는 기본적으로 사용 설정되지 않으며 'US' 및 'PR' 리전에서만 지원됩니다. CASS를 사용 설정하려면 유효성 검사 요청의 일부로 enableUspsCass를 true로 설정합니다. 자세한 내용은 주소 검증을 참고하세요.
USPS 서비스 사용의 일환으로 USPS는 인위적으로 생성된 주소에 대한 요청을 평가합니다. USPS에서 입력 주소가 인위적으로 생성된 것으로 식별되는 경우, Google은 고객 주소 확인을 중지하고, 고객의 연락처 정보 (이름 및 주소), 관련 입력 주소, 집계된 사용 데이터를 USPS에 보고해야 합니다. API를 사용하면 본 서비스별 약관에 동의하는 것으로 간주됩니다.
다음 단계
- FAQ 검토: FAQ로 이동
- 적용 범위 검토: 국가 및 지역 노출 범위 세부정보로 이동합니다.
- 대량으로 주소 처리: Address Validation API를 사용하여 대량의 주소 처리로 이동합니다.
-
Google Maps Platform은 US Postal Service®의 비배타적 라이선스 수혜자입니다. 이 상표는 United States Postal Service®에서 소유하고 있으며 미국 우체국®, CASSTM, CASS CertifiedTM로 허가되었습니다. 設