Address Validation API 빠른 참조

Address Validation API는 주소를 수락하고, 구성요소를 식별하고 검증하며, 우편 주소를 표준화하고, 가장 잘 알려진 위도/경도 좌표를 반환합니다. 미국 및 푸에르토리코 주소의 경우 선택적으로 USPS CASS 처리를 사용 설정할 수 있습니다.

Address Validation API: 주요 사실

  • 제품: Address Validation API
  • 카테고리: 장소
  • 플랫폼: 웹 서비스(REST)
  • 실행 위치: 서버(백엔드 코드)
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: Address Validation API 개요
  • 신청 가능 지역: 제한적입니다. 지원되는 국가와 데이터 품질은 국가마다 다르며 일부 국가는 프리뷰 상태입니다. 주거용 및 상업용 메타데이터는 적용 범위 페이지에 표시된 국가에 대해서만 반환됩니다. USPS CASS는 미국 및 푸에르토리코에서만 지원됩니다. (보증 범위 세부정보)

Address Validation API: 사용 시기

다음과 같은 경우 Address Validation API를 사용하세요.

  • 주소가 실제 장소를 가리키는지 확인하고 누락되었거나 잘못되었을 수 있는 구성요소를 찾아야 합니다.
  • 결제 절차 중과 같이 우편 주소를 표준화하고 완성해야 합니다.
  • 미국 또는 푸에르토리코의 주소에는 USPS CASS 인증 검증 및 uspsData가 필요합니다.
  • 적용 범위 페이지에 나열된 국가의 거주지 또는 상업용 주소 메타데이터가 필요합니다.

다음과 같은 경우에는 Address Validation API를 사용하지 마세요.

  • 주소를 위도/경도로 변환하기만 하면 되며 개별 주소 구성요소를 검증할 필요는 없습니다. 대신 Geocoding API를 사용하세요.
  • 건물 입구, 건물 윤곽선, 탐색 지점과 같은 초정밀 목적지 세부정보가 필요합니다. 대신 Geocoding API를 사용하세요.

Address Validation API: 설정

공식 Address Validation API 패키지:

  • npm: @googlemaps/addressvalidation
  • pypi: google-maps-addressvalidation
  • go: cloud.google.com/go/maps

Address Validation API: 일반적인 실수

  • 문제: addressComplete 속성의 값이 false인 경우 결과에서 생략되므로 필드가 있을 것으로 예상하는 코드가 불완전한 주소를 잘못 읽을 수 있습니다. 수정: 누락된 addressComplete 속성을 false로 처리하거나 속성이 있는지 확인합니다. /maps/documentation/address-validation/understand-response을 참조하세요.
  • 문제: regionCode가 생략되면 API가 주소에서 지역을 추론하므로 결과가 더 약해질 수 있습니다. 해결 방법: regionCode를 알고 있는 경우 PostalAddress에 포함합니다. /maps/documentation/address-validation/requests-validate-address를 참고하세요.
  • 문제: 검증된 모든 미국 주소에 대해 uspsData 객체가 완전히 채워지지 않을 수 있습니다. 수정: uspsData를 유일한 검증 신호로 사용하지 말고 결과 및 주소 구성요소도 사용하세요. /maps/documentation/address-validation/handle-us-address를 참고하세요.
  • 문제: provideValidationFeedback를 사용하여 전송된 의견은 이후의 호출이 아닌 시퀀스의 첫 번째 validateAddress 호출에서 responseId를 참조해야 합니다. 해결 방법: 첫 번째 validateAddress 응답의 responseId를 저장하고 의견 요청에 전송합니다. /maps/documentation/address-validation/handle-updated-address를 참고하세요.

Address Validation API로 할 수 있는 작업

각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.