Address Validation API 개요

주소 확인 개요

Address Validation API는 주소를 수신하는 서비스입니다. 주소 구성 요소를 식별하고 확인합니다. 또한 우편을 위해 주소를 표준화하고 가장 잘 알려진 위도/경도 좌표를 찾습니다. 원하는 경우 미국과 푸에르토리코 내 주소의 경우 코딩 정확도 지원 시스템 (CASSTM)을 사용 설정할 수 있습니다.

Address Validation API를 사용해야 하는 이유

Address Validation API를 사용하면 전송 예측 가능성을 개선하고 전송 실패를 줄임으로써 개선된 고객 환경을 제공할 수 있습니다. 이는 잘못된 주소를 포착하고 주소 특성을 더 잘 인식하여 이를 수행합니다.

개별 주소 구성요소를 검증할 필요가 없는 경우에는 Geocoding API가 요구사항에 더 적합할 수 있습니다. Geocoding API는 주소를 위도/경도 좌표로 변환하는 반면 Address Validation API는 주소의 정확성을 검증합니다. 자세한 비교는 아키텍처 센터의 Google Maps Platform을 사용하여 위치 확인 기능 구축을 참고하세요.

Address Validation API로 할 수 있는 작업

Address Validation API를 사용하면 주소가 실제 장소를 참조하는지 확인할 수 있습니다. 주소가 실제 장소를 가리키지 않는 경우 API가 잘못된 구성요소를 식별하여 고객에게 수정하도록 제시할 수 있습니다. 다음은 API를 사용하는 샘플 워크플로입니다.

  1. 고객이 주소 입력 – 다음 이미지는 결제 과정의 일부로 고객이 주소를 입력할 수 있는 간단한 양식을 보여줍니다.
    고객이 입력한 주소입니다.

  2. 앱에서 API에 주소 전송 – 애플리케이션이 이 주소를 Address Validation API에 입력으로 전달합니다.

  3. API에서 주소 유효성 검사 및 표준화 – Address Validation API는 응답에서 API가 결정한 대로 전체 주소를 반환하거나 정보가 누락된 위치를 나타냅니다.

  4. 고객이 권장 주소를 수정하거나 확인 – API가 반환하는 항목에 따라 고객에게 다음과 같은 메시지를 제공할 수 있습니다.

    • 고객이 확인할 수 있도록 권장 주소를 제시합니다.
      고객에게 API에서 결정한 주소를 확인해 달라고 요청합니다.

    • 고객에게 누락된 정보를 추가하라는 메시지를 표시합니다.
      고객에게 누락된 주소 정보를 입력하라는 메시지를 표시합니다.

    • 정보가 누락되거나 올바르지 않아 API에서 입력 주소를 확인할 수 없는 경우 사용자에게 주소를 수정하라는 메시지를 표시합니다.
      고객에게 주소 정보를 수정하라는 메시지를 표시합니다.

Address Validation API 작동 방식

주소 유효성 검사는 JSON 본문 형식의 주소를 사용하여 POST 요청을 수락합니다. 주소를 개별 구성요소로 분리한 후 다음을 확인하고 수정합니다.

  • 정답 - 가능한 경우 하위 프레미스를 포함한 구성요소 수준의 유효성 검사를 제공합니다.
  • 완료: 누락되거나 잘못된 주소 구성요소를 추론하려고 합니다.
  • 올바른 형식: 주소 구성요소의 형식을 정리하고 표준화합니다.

데모를 사용하여 Address Validation API가 실제로 작동하는 모습을 확인하세요.

자료

다음 표에는 Address Validation API를 통해 사용할 수 있는 리소스와 이 API에서 반환하는 데이터가 요약되어 있습니다. 자세한 내용은 Address Validation API 참조를 참고하세요.

데이터 리소스 반환된 데이터

JSON 형식의 주소 구성요소.

주소 확인을 참조하세요.

확인된 완전한 주소 (가능한 경우)

각 주소 구성요소의 유효성 검사 상태입니다.

주소를 사용할 수 있는 경우:

  • 지오코드
  • 주소 정밀도
  • 가능한 경우 우편 서비스 데이터입니다.

유효성 검사 응답 이해하기를 참고하세요.

Address Validation API 사용 방법

1 데모 사용해 보기 정답과 틀린 주소 형식의 다양한 주소 형식이 포함된 데모를 살펴보세요. 데모에서는 서비스의 반환 값과 JSON 형식의 API 응답을 모두 살펴볼 수 있는 유용한 방법을 제공합니다.
2 범위 확인 Address Validation API가 지원하는 국가 및 지역을 확인하려면 범위 세부정보를 검토하세요.
3 설정 Google Cloud 프로젝트 설정부터 시작하여 다음 안내를 완료합니다.
4 주소 확인 요청하기 간단한 주소로 시작한 다음 정확도를 높이기 위해 CASS를 사용 설정할 수 있습니다 (미국 및 PR 주소만 해당). 주소 확인 요청하기를 참고하세요.
5 응답 처리하기 Address Validation API 응답은 두 가지 속성을 제공하며, 각 속성은 서로 다른 방식으로 사용됩니다. 기본 응답 이해하기를 참고하세요.
6 검증 정확성 개선 Address Validation API 응답에 대한 의견을 제공하여 주소 정확성을 개선할 수 있습니다. 업데이트된 주소 처리를 참고하세요.

사용 가능한 클라이언트 라이브러리

Address Validation API에 사용할 수 있는 클라이언트 라이브러리 목록은 클라이언트 라이브러리를 참조하세요.

CASSTM 정보

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

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

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

다음 단계


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