Address Validation API 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
소개
Address Validation API는 주소를 허용하는 서비스입니다.
주소 구성요소를 식별하고 유효성을 검사합니다. 또한 우편 주소를 표준화하고 가장 잘 알려진 위도/경도 좌표를 찾습니다.
원하는 경우 미국 및 푸에르토리코의 주소에 대해
우편 주소 정확도 지원 시스템 (CASS™)을 사용 설정할 수 있습니다.
Address Validation API를 사용해야 하는 이유
Address Validation API를 사용하면 배송 예측 가능성을 개선하고 배송 실패를 줄여 고객 경험을 개선할 수 있습니다. 악성 주소를 포착하고 주소 특성을 더 잘 파악하여 이를 수행합니다.
개별 주소 구성요소를 검증할 필요가 없는 경우 Geocoding API가 요구사항에 더 적합할 수 있습니다. Geocoding API는 주소를 위도 및 경도 좌표로 변환합니다. Address Validation API는 주소의 정확성을 검증합니다. 자세한 비교는 아키텍처 센터의 Google Maps Platform을 사용하여 위치 검증 기능 빌드를 참고하세요.
Address Validation API로 할 수 있는 작업
input데모 사용해 보기
Address Validation API를 사용하면 주소가 실제 장소를 가리키는지 확인할 수 있습니다. 주소가 실제 장소를 참조하지 않는 경우 API는 고객에게 표시하여 수정할 수 있는 잘못된 구성요소를 식별할 수 있습니다. 다음은 API를 사용하는 샘플 워크플로입니다.
고객이 주소를 입력함 – 다음 이미지는 고객이 주소를 입력할 수 있는 기본 양식을 보여줍니다. 이 양식은 결제 흐름의 일부일 수 있습니다.
앱이 API에 주소를 전송 – 애플리케이션이 이 주소를 Address Validation API의 입력으로 전달합니다.
API가 주소를 검증하고 표준화함 – Address Validation API는 응답에서 API가 결정한 전체 주소를 반환하거나 정보가 누락된 위치를 나타냅니다.
고객이 주소를 확인하거나 수정함 - API에서 반환하는 내용에 따라 고객에게 다음 프롬프트를 제공할 수 있습니다.
A. 추천 주소를 확인합니다. B. 누락된 정보를 제공합니다.
C. 주소를 수정합니다.
Address Validation API의 작동 방식
주소 유효성 검사는 JSON 본문 형식의 주소가 포함된 POST 요청을 허용합니다. 주소를 개별 구성요소로 분리한 후 다음을 시도합니다.
- 수정: 가능한 경우 하위 구역을 포함한 구성요소 수준 검증 검사를 제공합니다.
- 완료: 누락되거나 잘못된 주소 구성요소를 추론하려고 시도합니다.
- 형식: 주소 구성요소의 형식을 정리하고 표준화합니다.
리소스
다음 표에는 주소 유효성 검사 API를 통해 사용할 수 있는 리소스와 반환되는 데이터가 요약되어 있습니다. 자세한 내용은 주소 유효성 검사 API 참조를 참고하세요.
| 데이터 리소스 |
반환된 데이터 |
|
JSON 형식의 주소 구성요소입니다.
주소 확인을 참고하세요.
|
완전하고 검증된 주소 (가능한 경우)
각 주소 구성요소의 유효성 검사 상태입니다.
주소에 사용할 수 있는 경우:
- 지오코드
- 주소 정확도
- 우편 서비스 데이터(제공되는 경우)
유효성 검사 응답 이해하기를 참고하세요.
|
Address Validation API 사용 방법
| 1 |
데모 사용해 보기 |
올바른 주소 형식과 잘못된 주소 형식을 다양하게 사용하여 데모를 살펴봅니다.
데모는 서비스의 반환 값과 JSON 형식 API 응답을 모두 살펴볼 수 있는 유용한 방법을 제공합니다. |
| 2 |
보장 범위 확인하기 |
적용 범위 세부정보를 검토하여 Address Validation API가 지원하는 국가 및 지역을 확인하세요. |
| 3 |
설정하기 |
Google Cloud 프로젝트 설정하기부터 시작하여 이어지는 안내를 완료합니다. |
| 4 |
주소 확인 요청 |
기본 주소로 시작한 다음 정확도를 높이기 위해 CASS를 사용 설정할 수 있습니다 (미국 및 푸에르토리코 주소만 해당). 주소 확인 요청을 참고하세요. |
| 5 |
응답 처리 |
Address Validation API 응답은 두 가지 속성을 제공하며, 각 속성은 서로 다른 방식으로 사용됩니다.
기본 응답 이해하기를 참고하세요. |
| 6 |
검증 정확도 개선 |
Address Validation API 응답에 대한 의견을 제공하여 주소 정확성을 개선할 수 있습니다. 업데이트된 주소 처리를 참고하세요. |
사용 가능한 클라이언트 라이브러리
Address Validation API에 사용할 수 있는 클라이언트 라이브러리 목록은 클라이언트 라이브러리를 참고하세요.
CASS™ 정보
미국 우편 서비스 (USPS®)1는 주소 확인 제공업체를 지원하고 인증하기 위해 코딩 정확도 지원 시스템 (CASS™)을 유지합니다. Address Validation API와 같은 CASS Certified™ 서비스는 주소에서 누락된 정보를 채우고, 표준화하고, 업데이트하여 가장 최신이고 정확한 주소를 제공하는 기능이 확인되었습니다.
CASS는 기본적으로 사용 설정되지 않으며 'US' 및 'PR' 지역에서만 지원됩니다. CASS를 사용 설정하려면 유효성 검사 요청의 일부로 enableUspsCass를 true로 설정하세요. 자세한 내용은 주소 유효성 검사를 참고하세요.
USPS 서비스를 사용하는 과정에서 USPS는 인위적으로 생성된 주소에 대한 요청을 평가합니다. USPS에서 입력된 주소가 인위적으로 생성된 것으로 식별하는 경우 Google은 고객의 주소 확인을 중단해야 하며 고객의 연락처 정보 (이름 및 주소), 관련 입력 주소, 집계된 사용량 데이터를 USPS에 보고해야 합니다. API를 사용하면 이 서비스별 약관에 동의하는 것으로 간주됩니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eThe Address Validation API validates, standardizes, and geocodes addresses, improving delivery predictability and customer experience.\u003c/p\u003e\n"],["\u003cp\u003eIt identifies address components, validates them for correctness, and provides suggestions for corrections, unlike the Geocoding API, which only converts addresses to coordinates.\u003c/p\u003e\n"],["\u003cp\u003eAddresses are processed by correcting, completing, and formatting components, with CASS™ support for US and Puerto Rico addresses for enhanced accuracy (requires enabling).\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access resources like a demo, coverage details, setup instructions, validation requests, response understanding, and client libraries to utilize the API effectively.\u003c/p\u003e\n"],["\u003cp\u003eUSPS evaluates requests for artificially created addresses, and Google is obligated to stop validation and report relevant information to USPS in such cases.\u003c/p\u003e\n"]]],["The Address Validation API validates and standardizes addresses, identifying components and correcting errors. It can infer missing information, and determine if an address is a real place. The API accepts an address, validates it, and returns a complete address or flags missing information. Users can confirm, correct, or provide missing details. For US and Puerto Rico addresses, CASS can be enabled for enhanced accuracy. The Geocoding API may be preferred if address component validation is not needed.\n"],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\nIntroduction The Address Validation API is a service that accepts an address. It identifies address components and validates them. It also standardizes the address for mailing and finds the best known latitude/longitude coordinates for it. Optionally, for addresses in the United States and Puerto Rico, you can enable the [Coding Accuracy Support System (CASS™)](https://developers.google.com/maps/documentation/address-validation/overview#about-cass).\n\nWhy use the Address Validation API\n\nWith the Address Validation API, you can improve delivery predictability and reduce\ndelivery failures, thereby providing improved customer experience. You do this\nby catching bad addresses and obtaining better awareness of address\ncharacteristics.\n\nThe Geocoding API might be a better match for your needs if you\ndon't need to validate the individual address components. The Geocoding API\n**converts** addresses into latitude and longitude coordinates. The\nAddress Validation API validates addresses for **correctness** . See\n[Building location validation capability using Google Maps Platform](https://developers.google.com/maps/architecture/geocoding-address-validation)\nin the Architecture Center for a detailed comparison.\n\nWhat you can do with the Address Validation API\n\n[inputTry the demo](/maps/documentation/address-validation/demo) [](/maps/documentation/address-validation/demo)\n\nWith the Address Validation API, you can determine if an address\nrefers to a real place. If the address does not refer to a real\nplace, the API can identify possibly wrong components that you can present to\nyour customers to correct. Here is a sample workflow using the API:\n\n1. **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\n flow.\n\n2. **App sends the address to the API** -- The application passes this address\n as the input to the Address Validation API.\n\n3. **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. **Customer confirms or corrects the address** -- Depending on\n what the API returns, you can provide the following prompts to the customer:\n **A.** Confirm the recommended address. **B.** Provide missing information.\n **C.** Fix the address.\n\nHow the Address Validation API works\n\nThe address validation accepts a POST request with the address in the form\nof a JSON body. It separates the address into its individual components, and\nthen attempts the following:\n\n- **Corrects**---Provides component-level validation 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\nResources\n\nThe following table summarizes the resources available through the\nAddress Validation API along with the data it returns. For specific details, see the\n[Address Validation API reference](./reference/rest).\n\n\u003cbr /\u003e\n\n| Data resources | Data returned |\n|-------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Address components in JSON format.** See [Validate an address](/maps/documentation/address-validation/requests-validate-address). | Complete, validated address (if possible). Validation status of each address component. Where available for an address: - Geocode - Address precision - Postal services data, where available. See [Understand the validation response](/maps/documentation/address-validation/understand-response). |\n\n\u003cbr /\u003e\n\nHow to use the Address Validation API\n\n|---|-----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Try the demo** | [Explore the demo](/maps/documentation/address-validation/demo) with a variety of address forms, both correct and incorrect. The demo provides a useful way to explore both the return values from the service, as well as the JSON formatted API response. |\n| 2 | **Check coverage** | Review [coverage details](/maps/documentation/address-validation/coverage) to see which countries and regions the Address Validation API supports. |\n| 3 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/address-validation/cloud-setup) and complete the instructions that follow. |\n| 4 | **Request an address validation** | Start with a basic address and then, for additional accuracy, you can enable CASS (for US and PR addresses only). See [Request an address validation.](/maps/documentation/address-validation/requests-validate-address) |\n| 5 | **Process a response** | The Address Validation API response provides two properties, each of which you use in different ways. See [Understand a basic response.](/maps/documentation/address-validation/understand-response) |\n| 6 | **Improve validation accuracy** | You can help improve address accuracy by providing feedback on Address Validation API responses. See [Handle updated addresses](/maps/documentation/address-validation/handle-updated-address). |\n\nAvailable client libraries\n\nFor a list of the available client libraries for Address Validation API,\nsee\n[Client libraries](/maps/documentation/address-validation/client_libraries).\n\nAbout CASS™\n\nThe United States Postal Service® (USPS®)^[1](#fn1)^ maintains the\n[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\n[Validate an address](/maps/documentation/address-validation/requests-validate-address#enable-cass).\n\nAs part of our use of USPS services, USPS evaluates requests for artificially\ncreated addresses. If USPS identifies an input address as being artificially\ncreated, Google is required to stop validating addresses for the customer and\nmust report the customer's contact information (name and address), the relevant\ninput address, and aggregated usage data to USPS. By using the API you consent\nto these\n[Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms).\n\nWhat's next\n\n- **Try the demo** : Go to [Demo](/maps/documentation/address-validation/demo)\n- **Review coverage areas** : Go to [Country and region coverage details](/maps/documentation/address-validation/coverage)\n- **Try your first validation request** : Go to [Send an address validation request](/maps/documentation/address-validation/requests-validate-address)\n- **Process addresses at high volume** : Go to [Use Address Validation API to process addresses at high volume](/maps/architecture/high-volume-address-validation)\n\n*** ** * ** ***\n\n1. Google Maps Platform is a non-exclusive Licensee of the United States\n Postal Service®. The following trademark(s) are owned by the United States\n Postal Service® and used with permission: United States Postal Service®,\n CASS™, CASS Certified™. [↩](#fnref1)"]]
