Address Validation API를 사용하여 대량의 주소 처리

목표

개발자는 고객 주소가 포함된 데이터 세트로 작업하는 경우가 많으며, 이 데이터 세트는 품질이 좋지 않을 수 있습니다. 올바른 주소를 입력해야 합니다. 고객 ID 확인부터 배송 등에 이르는 다양한 사용 사례를 지원합니다

주소 확인 API는 주소의 유효성을 검사하는 데 사용할 수 있는 Google Maps Platform입니다. 그러나 한 번에 하나의 주소를 처리합니다 이 문서에서는 API 테스트, 다양한 시나리오에 따른 대용량 주소 검증 일회성 및 반복 주소 검증까지 간편하게 사용할 수 있습니다

사용 사례

이제 대용량 주소 검증이 필요한 사용 사례를 살펴보겠습니다. 유용하죠.

테스트

주소 검증 API를 테스트하려는 경우가 많은 경우 수천 개의 있습니다. 쉼표로 구분된 값 파일에 주소가 있는 경우 주소의 품질을 검증할 수 있습니다.

주소 일회성 확인

Address Validation API에 온보딩하는 과정에서 데이터베이스와 대조합니다.

반복 주소 확인

다음과 같이 반복적으로 주소를 검증해야 하는 경우가 많습니다.

  • 캡처된 세부정보를 위해 주소의 유효성을 검사하는 작업이 예약되어 있을 수 있습니다. 고객 가입, 주문 세부정보, 배송 등 있습니다.
  • 여러 부서의 주소가 포함된 데이터 덤프를 받을 수 있습니다. 예를 들어 판매에서 마케팅으로 나눌 수 있습니다 새로운 부서에서 주소는 사용하기 전에 주소를 검증하는 경우가 많습니다.
  • 설문조사나 다양한 홍보 기간 및 그 이후에 주소를 수집할 수 있습니다. 할 수 있습니다. 주소가 다음과 같은지 확인하려고 합니다. 정답을 맞히는 것이 중요합니다.

기술 심층 정보

이 문서에서는 다음과 같이 가정합니다.

  • 고객의 주소로 Address Validation API를 호출하고 있습니다. 데이터베이스 (고객 세부정보가 포함된 데이터베이스)
  • 데이터베이스의 개별 주소에 대해 유효성 플래그를 캐시할 수 있습니다.
  • 유효성 플래그는 개별 고객이 로그인할 수 있습니다

프로덕션용 캐시

Address Validation API를 사용할 때는 API 호출의 응답을 반환합니다. Google의 약관은 서비스 한도 캐시할 수 있는 데이터, Address Validation API에서 캐시할 수 있는 모든 데이터 사용자 계정에 대해 캐시되어야 합니다. 즉, 데이터베이스에서 주소 메타데이터가 사용자의 이메일 주소 또는 다른 기본 ID가 있습니다.

대용량 주소 검증 사용 사례의 경우 데이터 캐싱은 Address Validation API 서비스별 약관, 기술 품질 보증을 이용할 수 있습니다 이 정보를 바탕으로 다음과 같은 작업을 할 수 있습니다. 사용자의 주소가 잘못된 것인지 여부를 판단할 수 있으며, 이 경우 다음에 상호 작용할 때 사용자에게 올바른 주소를 알려달라고 요청 애플리케이션입니다.

  • AddressComponent의 데이터 객체 <ph type="x-smartling-placeholder">
      </ph>
    • confirmationLevel
    • inferred
    • spellCorrected
    • replaced
    • unexpected

실제 주소에 대한 정보를 캐시하려는 경우 해당 데이터는 사용자의 동의가 있는 경우에만 캐시되어야 합니다. 이렇게 하면 사용자가 특정 서비스가 자신의 주소를 저장하는 이유를 알고 있고 몇 가지 사항이 있습니다.

사용자 동의의 예로는 전자상거래 주소와의 직접 상호작용이 있습니다. 양식을 작성해 주시기 바랍니다. 모든 파일을 캐시하고 패키지 발송을 위해 주소를 처리하는 경우

사용자의 동의가 있는 경우 formattedAddress 및 기타 주요 구성요소를 캐시할 수 있습니다. 삭제합니다. 하지만 헤드리스 시나리오에서는 사용자가 주소 유효성 검사가 백엔드에서 이루어지기 때문에 동의를 얻지 않아도 됩니다. 따라서 이 헤드리스 시나리오에서는 매우 제한된 정보를 캐시할 수 있습니다.

응답 이해

Address Validation API 응답에 다음 마커가 포함되어 있는 경우 입력된 주소의 품질에 대해 확신할 수 있습니다.

  • 결과의 addressComplete 마커 객체가 true임
  • 결과의 validationGranularity 객체가 PREMISE 또는 SUB_PREMISE임
  • AddressComponent가 다음과 같이 표시됩니다. <ph type="x-smartling-placeholder">
      </ph>
    • Inferred(주의: inferred=true: addressComplete=true)
    • spellCorrected
    • replaced
    • unexpected 및
  • confirmationLevel: AddressComponent 다음 값으로 설정됨CONFIRMED또는UNCONFIRMED_BUT_PLAUSIBLE

API 응답에 위의 마커가 포함되어 있지 않으면 입력 주소가 품질이 낮았을 가능성이 높으며, 데이터베이스에 플래그를 캐시하여 있습니다. 캐시된 플래그는 전체 주소의 품질이 좋지 않음을 나타내지만 '맞춤법 수정됨'과 같은 보다 자세한 플래그는 특정 유형의 해결할 수 있습니다. 다음에 표시된 주소와의 고객 상호작용 시 품질이 좋지 않을 경우 기존 있습니다. Address Validation API는 수정된 주소를 반환하여 표시할 수 있습니다. 고객이 형식이 지정된 주소를 수락하면 응답에서 다음을 캐시할 수 있습니다.

  • formattedAddress
  • postalAddress
  • addressComponent componentNames또는
  • UspsData standardizedAddress

헤드리스 주소 유효성 검사 구현

위의 논의를 바탕으로 한 추천입니다.

  • Address의 응답의 일부를 캐시해야 할 때가 많습니다. 비즈니스용 Validation API입니다.
  • 하지만 서비스 Google Maps Platform에서는 캐시할 수 있는 데이터가 제한됩니다.

다음 섹션에서는 정책을 준수하는 방법에 관한 두 가지 단계 프로세스를 하고 대량 주소 확인을 구현합니다.

1단계:

첫 번째 단계에서는 대량의 주소를 구현하는 방법을 살펴봅니다. 유효성 검사 스크립트를 만듭니다. 이 과정을 통해 Address Validation API 응답의 특정 필드를 서비스 규정 준수 방식

다이어그램 A: 다음 다이어그램은 데이터 파이프라인을 개선하는 방법을 보여줍니다. 높은 볼륨 주소 검증 로직과 함께 사용하는 것이 좋습니다

alt_text

서비스 약관에 따라 addressComponent:

  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

따라서 구현의 이 단계에서 위에서 언급한 항목을 캐시합니다. 필드를 확인합니다.

자세한 내용은 실제 데이터 구성을 따르는 것이 좋습니다.

2단계:

1단계에서 입력 데이터 세트의 일부 주소가 품질이 높지 않아야 합니다. 다음 단계에서는 이러한 신고된 주소를 사용자에게 제시하고, 저장된 URL 체크박스에 대해 있습니다.

다이어그램 B: 이 다이어그램은 사용자의 엔드 투 엔드 통합 방식을 보여줍니다. 동의 흐름은 다음과 같습니다.

alt_text

  1. 사용자가 로그인하면 먼저 유효성 검사 플래그를 캐시했는지 확인합니다. 확인할 수 있습니다
  2. 플래그가 있는 경우 사용자에게 오류를 수정하고 수정할 수 있는 UI를 주소를 업데이트해야 합니다.
  3. 업데이트되거나 캐시된 사용자에게 올바른 주소를 제시하여 확인합니다.
  4. 주소의 품질이 좋으면 Address Validation API가 formattedAddress
  5. 수정이 완료되면 사용자에게 해당 주소를 제시할 수 있습니다. 알리거나, 정정 내용이 없으면 조용히 수락합니다.
  6. 사용자가 수락하면 데이터베이스에서 formattedAddress를 캐시할 수 있습니다.

결론

대용량 주소 검증은 자주 접하게 될 일반적인 사용 사례입니다 애플리케이션을 실행할 수 있습니다 이 문서에서는 몇 가지 시나리오와 Google 지도에 맞게 이러한 솔루션을 구현하는 방법에 대한 디자인 패턴 플랫폼 서비스 약관

추가적으로 대용량 주소의 참조 구현을 작성했습니다. GitHub의 오픈소스 라이브러리로서의 검증. 확인하여 시작하기 빠르게 구축할 수 있습니다 다음 도움말도 확인해 보세요. 다양한 시나리오에서 라이브러리를 사용하는 방법에 관한 설계 패턴을 알아봅니다.

다음 단계

신뢰할 수 있는 주소로 결제, 배송, 운영 개선 백서 주소로 결제, 배송, 운영 개선 확인 웹 세미나.

추가 추천 자료:

참여자

이 도움말은 Google에서 관리합니다. 처음에 작성한 작성자는 다음과 같습니다.
수석 저자:

헨릭 밸브 | 솔루션 엔지니어
토마스 앵글레렛 | 솔루션 엔지니어
사탁 강굴리 | 솔루션 엔지니어