Maps JavaScript API에서 Address Validation을 사용하는 이유는 무엇인가요?
Address Validation 라이브러리는 주소를 입력으로 받아 주소 구성요소를 식별하고 유효성을 검사합니다. 또한 우편 주소를 표준화하고 가장 잘 알려진 위도/경도 좌표를 찾습니다. 원하는 경우 미국 및 푸에르토리코의 주소에
코딩 정확성 지원 시스템 (CASS™)을 사용 설정할 수 있습니다.
Address Validation API를 사용하면 전송 예측 가능성을 개선하고 전송 실패를 줄여 고객 경험을 개선할 수 있습니다.
이렇게 하려면 잘못된 주소를 포착하고 주소 특성을 더 잘 인식해야 합니다.
Maps JavaScript API의 주소 검증으로 할 수 있는 작업
Maps JavaScript API의 Address Validation을 사용하면 주소가 실제 장소를 나타내는지 확인할 수 있습니다. 주소가 실제 장소를 참조하지 않는 경우 API는 잘못되었을 수 있는 구성요소를 식별할 수 있으며, 개발자는 이를 고객에게 제공하여 수정할 수 있습니다. 다음은 샘플 워크플로입니다.
고객이 주소를 입력함 — 다음 이미지는 고객이 결제 흐름의 일부로 주소를 입력할 수 있는 기본 양식을 보여줍니다.
앱이 API에 주소를 전송: 애플리케이션은 fetchAddressValidation 메서드를 사용하여 이 주소를 전달합니다.
API가 주소를 검증하고 표준화합니다. Address Validation API는 응답에서 API에서 결정한 전체 주소를 반환하거나 정보가 누락된 위치를 나타냅니다.
고객이 주소를 확인하거나 수정함: API가 반환하는 내용에 따라 고객에게 다음 메시지를 제공할 수 있습니다.
추천 주소를 확인합니다.
누락된 정보를 제공합니다.
주소를 수정합니다.
Maps JavaScript API의 주소 확인 작동 방식
fetchAddressValidation를 호출하면 API는 다음을 시도합니다.
수정: 가능한 경우 하위 전제를 포함하여 구성요소 수준 유효성 검사를 제공합니다.
Completes: 누락되거나 잘못된 주소 구성요소를 추론하려고 시도합니다.
형식: 주소 구성요소의 형식을 정리하고 표준화합니다.
CASS™ 정보
United States Postal Service® (USPS®)1는 주소 유효성 검사 제공업체를 지원하고 인증하기 위해
Coding Accuracy Support System (CASS™)을 유지 관리합니다. Address Validation API와 같은 CASS Certified™ 서비스는 주소에서 누락된 정보를 입력하고, 표준화하고, 업데이트하여 가장 최신의 정확한 주소를 제공하는 기능이 확인되었습니다.
CASS는 기본적으로 사용 설정되지 않으며 'US' 및 'PR' 지역에서만 지원됩니다. CASS를 사용 설정하려면 유효성 검사 요청의 일부로 `enableUspsCass` 를 `true` 로 설정합니다. 자세한 내용은 주소 유효성 검사를 참고하세요.
Google은 USPS 서비스를 사용하는 과정에서 인위적으로 생성된 주소에 대한 요청을 평가합니다. USPS에서 입력 주소가 인위적으로 생성된 것으로 확인되면 Google은 고객의 주소 유효성 검사를 중지하고 고객의 연락처 정보 (이름 및 주소), 관련 입력 주소, 집계된 사용량 데이터를 USPS에 보고해야 합니다. API를 사용하면 이
서비스별 약관에 동의하는 것으로 간주됩니다.
Google Maps Platform은 United States Postal Service®의 비독점 라이선스 소유자입니다. 다음 상표는 United States Postal Service®에서 소유하고 있으며 허가받은 후 사용합니다. United States Postal Service®, CASS™, CASS Certified™.
↩
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[],[],null,["**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n| This product or feature is in Preview (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google\n| Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage\n| descriptions](/maps/launch-stages).\n\nWhy use Address Validation in Maps JavaScript API? \n\nThe Address Validation library takes an address as input to identify and validate address\ncomponents. It also standardizes the address for mailing and finds the best known\nlatitude/longitude coordinates for it. Optionally, for addresses in the United States and\nPuerto Rico, you can enable the\n[Coding Accuracy Support System (CASS™)](https://developers.google.com/maps/documentation/address-validation/overview#about-cass).\n\nWith Address Validation API, you can improve delivery\npredictability and reduce delivery failures, thereby providing improved customer experience.\nYou do this by catching bad addresses and obtaining better awareness of address\ncharacteristics.\n| The Geocoding API might be a better match for your needs if you don't need to validate the individual address components. The Geocoding API **converts** addresses into latitude and longitude coordinates. The Address Validation API validates addresses for **correctness** . See [Building location validation capability using Google Maps Platform](https://developers.google.com/maps/architecture/geocoding-address-validation) in the Architecture Center for a detailed comparison.\n\nWhat you can do with Address Validation in Maps JavaScript API\n\nWith Address Validation in Maps JavaScript API, you can determine if an address refers to a\nreal place. If the address does not refer to a real place, the API can identify possibly wrong\ncomponents that you can present to your customers to correct. Here is a sample workflow:\n\n1.\n **Customer enters an address** --- The following image shows a basic form\n that allows a customer to enter an address, possibly as part of a checkout flow.\n\n2.\n **App sends the address to the API** --- The application passes this\n address using the `fetchAddressValidation` method.\n\n3.\n **API validates and standardizes the address** --- In its response, the\n Address Validation API returns the complete address as determined by the API, or\n indicates where information is missing.\n\n4.\n **Customer confirms or corrects the address** --- Depending on what the\n API returns, you can provide the following prompts to the customer:\n\n 1. Confirm the recommended address.\n 2. Provide missing information.\n 3. Fix the address.\n\nHow Address Validation in Maps JavaScript API works\n\nWhen a call to `fetchAddressValidation` is made the API attempts the following:\n\n- **Corrects** --- Provides component-level vaidation checks, including sub-premises where available.\n- **Completes** --- Attempts to infer missing or incorrect address components.\n- **Formats** --- Cleans up and standardizes the format for address components.\n\nAbout CASS™\n\nThe United States Postal Service® (USPS®)^[1](#fn1)^\nmaintains the [Coding Accuracy Support System (CASS™)](https://postalpro.usps.com/certifications/cass)\nto support and certify address validation providers. A CASS Certified™ service,\nsuch as the Address Validation API, has been confirmed for its\nability to fill in information missing from an address, standardize it, and\nupdate it to give you the most current and most accurate address.\n\nCASS is not enabled by default and is only supported for the \"US\" and \"PR\"\nregions. To enable CASS, set \\`enableUspsCass\\` to \\`true\\` as part of a validation\nrequest. For more information, see [Validate an address](/maps/documentation/javascript/address-validation/TBD).\n\nAs part of our use of USPS services, USPS evaluates requests for artificially created\naddresses. If USPS identifies an input address as being artificially created, Google is\nrequired to stop validating addresses for the customer and must report the customer's\ncontact information (name and address), the relevant input address, and aggregated usage\ndata to USPS. By using the API you consent to these\n[Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms).\n\nNext steps\n\n- [Get started with Address Validation in Maps JavaScript API](/maps/documentation/javascript/address-validation/start)\n\n*** ** * ** ***\n\n1. Google Maps Platform is a non-exclusive Licensee of the United States Postal Service®. The following trademark(s) are owned by the United States Postal Service® and used with permission: United States Postal Service®, CASS™, CASS Certified™. [↩](#fnref1)"]]
