주소 확인 API 개요

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Address Validation API는 주소를 수락하고 주소 구성요소를 식별 및 검증하는 서비스입니다. 또한 우편 주소를 표준화하고 여기에 가장 적합한 위도/경도 위치를 찾습니다. 주소가 실제 장소를 가리키는지 이해하는 데 도움이 될 수 있습니다. 주소가 실제 장소를 참조하지 않는 경우 잘못된 구성요소를 식별하여 사용자가 수정할 수 있게 합니다.

Address Validation API는 주소 처리 시 도움이 되는 다음과 같은 여러 기능을 제공합니다.

  • 주소를 개별 구성요소로 분리한 다음 하위 프레미스 (사용 가능한 경우)를 비롯한 구성요소 수준 검증 검사를 제공합니다.

  • 누락되었거나 잘못된 주소 구성요소를 정리, 표준화, 추론합니다.

  • 지오코드, 주소 정밀도, 우편 서비스 데이터를 비롯한 추가 정보로 주소를 추가합니다.

  • API에서 결정한 대로 전체 주소를 포함하는 단일 문자열을 반환합니다.

Address Validation API의 실제 동작을 확인하려면 데모를 사용해 보세요.

워크플로에 Address Validation API 추가

Address Validation API의 가장 일반적인 사용 사례 중 하나는 고객이 올바른 주소를 제공하도록 하여 고객 경험을 향상시키는 것입니다. 주소 유효성 검사를 통해 잘못된 주소를 포착하여 전송 실패를 줄이고 주소 특성을 더 잘 파악하여 전송 예측 가능성을 개선할 수 있습니다.

다음 이미지는 고객이 결제 과정의 일부로 주소를 입력할 수 있게 해주는 간단한 양식을 보여줍니다. 이 주소를 Address Validation API에 대한 입력으로 전달합니다.

고객이 입력한 주소입니다.

이에 대한 응답으로 Address Validation API는 API에서 결정한 전체 주소를 반환합니다. 고객에게 전체 주소를 권장 주소로 표시하세요.

API에 의해 결정되는 주소입니다.

Address Validation API에서 누락된 정보를 감지하면 사용자에게 정보를 추가하라는 메시지를 표시합니다.

고객에게 누락된 주소 정보를 입력하라는 메시지가 표시된 양식

누락되거나 잘못된 정보로 인해 API가 입력 주소의 유효성을 검사할 수 없는 경우 사용자에게 주소를 수정하라는 메시지를 표시합니다.

고객에게 주소 정보를 수정하도록 요청하는 양식입니다.

Address Validation API와 Geocoding API의 차이점

Geocoding API와 Address Validation API 모두 '이 사용자 입력에 가장 적합한 위치는 어디인가요?'라는 질문에 답하고자 합니다. Geocoding API와 달리 Address Validation API는 다음 작업도 시도합니다.

  • '이 사용자 입력이 실제 주소를 나타내나요?'라는 질문에 답변합니다.
  • 입력 주소와 일부만 사용 가능한 데이터와 일치하더라도 이를 파악합니다.
  • 다양한 구성요소의 유효성 관련 의견 제공
  • 주소가 완전한지 확인하고 누락된 필수 구성요소를 신고하세요.
  • 우편 발송을 위해 반송 주소의 형식을 지정합니다.

예를 들어 '123 Fake St, Mountain View, CA'와 같은 주소가 주어진 경우, Geocoding API는 단순히 Mountain View, CA 도시의 지오코드를 반환하고 '123 Fake St'를 무시합니다. '123 Fake St'는 마운틴 뷰에 이러한 거리 (또는 이와 유사한 거리)가 없기 때문입니다.

반면 Address Validation API는 '123'이 번지이고 'Fake St'가 도로임을 식별하고 이러한 구성요소가 포함된 결과를 반환하여 확인되지 않은 것으로 표시하여 주소를 지오코딩하지 못하는 이유를 알려줍니다.

CASSTM 정보

미국 우편 서비스® (USPS®)1코딩 정확도 지원 시스템 (CASSTM)을 유지하여 주소 확인 제공업체를 지원하고 인증합니다. Address Validation API와 같은 CASS CertifiedTM 서비스는 주소에서 누락된 정보를 입력하고, 표준화하고, 가장 정확한 최신 주소를 제공하도록 업데이트할 수 있는 기능으로 확인되었습니다.

CASS는 기본적으로 사용 설정되지 않으며 'US' 및 'PR' 리전에서만 지원됩니다. CASS를 사용 설정하려면 유효성 검사 요청의 일부로 enableUspsCasstrue로 설정합니다. 자세한 내용은 주소 확인을 참고하세요.

USPS 서비스 사용의 일환으로 USPS는 인공적으로 생성된 주소에 대한 요청을 평가합니다. USPS에서 입력 주소가 인위적으로 생성된 것으로 식별하면 Google은 고객의 주소 확인을 중지하고 고객의 연락처 정보 (이름 및 주소), 관련 입력 주소, 집계된 사용 데이터를 USPS에 보고해야 합니다. API를 사용하면 본 서비스별 약관에 동의하는 것으로 간주됩니다.

다음 단계


  1. Google Maps Platform은 미국 우편 서비스®의 비배타적 라이선스 수혜자입니다. 이 상표는 미국 우편 서비스® 소유이며 미국 우정 서비스 , CASSTM, CASS 인증TM을 따릅니다.