Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)
Wprowadzenie
Address Validation API to usługa, która akceptuje adres.
Identyfikuje komponenty adresu i je weryfikuje. Standaryzuje też adres na potrzeby wysyłki pocztą i określa dla niego najlepsze znane współrzędne określające szerokość i długość geograficzną.
Opcjonalnie w przypadku adresów w Stanach Zjednoczonych i Portoryko możesz włączyć system CASS™.
Dlaczego warto korzystać z interfejsu Address Validation API
Dzięki interfejsowi Address Validation API możesz zwiększyć przewidywalność dostaw i zmniejszyć liczbę nieudanych dostaw, co poprawi komfort klientów. Możesz to zrobić, wychwytując nieprawidłowe adresy i uzyskując lepszą wiedzę o ich cechach.
Jeśli nie musisz weryfikować poszczególnych komponentów adresu, lepszym rozwiązaniem może być interfejs Geocoding API. Interfejs Geocoding API konwertuje adresy na współrzędne geograficzne. Interfejs Address Validation API sprawdza poprawność adresów. Szczegółowe porównanie znajdziesz w artykule Tworzenie funkcji weryfikacji lokalizacji budynku za pomocą platformy Map Google w Centrum architektury.
Za pomocą interfejsu Address Validation API możesz sprawdzić, czy adres odnosi się do rzeczywistego miejsca. Jeśli adres nie odnosi się do rzeczywistego miejsca, interfejs API może zidentyfikować prawdopodobnie nieprawidłowe komponenty, które możesz przedstawić klientom do poprawienia. Oto przykładowy proces korzystania z interfejsu API:
Klient wpisuje adres – na poniższym obrazie widać prosty formularz, który umożliwia klientowi wpisanie adresu, prawdopodobnie w ramach procesu płatności.
Aplikacja wysyła adres do interfejsu API – aplikacja przekazuje ten adres jako dane wejściowe do interfejsu Address Validation API.
Interfejs API weryfikuje i standaryzuje adres – w odpowiedzi interfejs Address Validation API zwraca pełny adres określony przez interfejs API lub wskazuje, gdzie brakuje informacji.
Klient potwierdza lub poprawia adres – w zależności od tego, co zwraca interfejs API, możesz wyświetlić klientowi te komunikaty:A. Potwierdź rekomendowany adres. B. Podaj brakujące informacje.
C. Popraw adres.
Jak działa Address Validation API
Weryfikacja adresu akceptuje żądanie POST z adresem w formie treści JSON. Dzieli adres na poszczególne komponenty, a następnie próbuje wykonać te czynności:
Poprawia – zapewnia weryfikację na poziomie komponentów, w tym w przypadku dostępności podlokalizacji.
Uzupełnia – próbuje wywnioskować brakujące lub nieprawidłowe elementy adresu.
Formaty – oczyszcza i standaryzuje format komponentów adresu.
Zasoby
W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w interfejsie Address Validation API wraz z danymi, które zwraca. Szczegółowe informacje znajdziesz w dokumentacji interfejsu Address Validation API.
Wypróbuj wersję demonstracyjną z różnymi formami adresów, zarówno poprawnymi, jak i niepoprawnymi.
Wersja demonstracyjna to przydatny sposób na zapoznanie się zarówno z wartościami zwracanymi przez usługę, jak i z odpowiedzią interfejsu API w formacie JSON.
2
Sprawdź zasięg
Sprawdź szczegóły zasięgu, aby dowiedzieć się, które kraje i regiony są obsługiwane przez interfejs Address Validation API.
Zacznij od podstawowego adresu, a potem, aby zwiększyć dokładność, możesz włączyć CASS (tylko w przypadku adresów w Stanach Zjednoczonych i Portoryko). Zobacz Prośba o weryfikację adresu.
5
Przetwarzanie odpowiedzi
Odpowiedź interfejsu Address Validation API zawiera 2 właściwości, z których każda jest używana w inny sposób.
Zobacz Omówienie podstawowej odpowiedzi.
6
Zwiększanie dokładności weryfikacji
Możesz pomóc zwiększyć dokładność adresów, przesyłając opinie o odpowiedziach interfejsu Address Validation API. Zobacz Obsługa zaktualizowanych adresów.
Dostępne biblioteki klienta
Listę dostępnych bibliotek klienta interfejsu Address Validation API znajdziesz w sekcji Biblioteki klienta.
Informacje o CASS™
United States Postal Service® (USPS®)1 prowadzi Coding Accuracy Support System (CASS™), który wspiera i certyfikuje dostawców usług weryfikacji adresów. Usługa z certyfikatem CASS Certified™, taka jak Address Validation API, została potwierdzona pod kątem możliwości uzupełniania informacji, których brakuje w adresie, standaryzowania go i aktualizowania, aby zapewnić Ci najbardziej aktualny i dokładny adres.
CASS nie jest domyślnie włączony i jest obsługiwany tylko w regionach „US” i „PR”. Aby włączyć CASS, ustaw wartość enableUspsCass na true w ramach żądania weryfikacji. Więcej informacji znajdziesz w artykule Weryfikowanie adresu.
W ramach korzystania z usług USPS firma ta ocenia prośby dotyczące adresów utworzonych sztucznie. Jeśli USPS uzna, że adres wejściowy został utworzony sztucznie, Google musi zaprzestać weryfikacji adresów dla klienta i przekazać USPS informacje kontaktowe klienta (imię i nazwisko oraz adres), odpowiedni adres wejściowy i zagregowane dane o użytkowaniu. Korzystając z interfejsu API, wyrażasz zgodę na te Warunki korzystania z konkretnych usług.
Google Maps Platform jest niewyłącznym licencjobiorcą United States Postal Service®. Poniższe znaki towarowe są własnością United States Postal Service® i są używane za zgodą tej firmy: United States Postal Service®, CASS™, CASS Certified™. ↩
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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)"]]
