Address Validation API – Übersicht
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Entwickler im Europäischen Wirtschaftsraum (EWR)
Einführung
Die Address Validation API ist ein Dienst, der eine Adresse akzeptiert.
Es identifiziert Adresskomponenten und validiert sie. Außerdem wird die Adresse für den Postversand standardisiert und die genauesten Breiten-/Längengradkoordinaten für sie ermittelt.
Optional können Sie für Adressen in den USA und Puerto Rico das
Coding Accuracy Support System (CASS™) aktivieren.
Gründe für die Verwendung der Address Validation API
Mit der Address Validation API können Sie die Vorhersagbarkeit von Lieferungen verbessern und Lieferfehler reduzieren, was zu einer besseren Kundenzufriedenheit führt. Dazu müssen Sie ungültige Adressen erkennen und sich ein besseres Bild von den Adressmerkmalen machen.
Die Geocoding API ist möglicherweise besser für Ihre Anforderungen geeignet, wenn Sie die einzelnen Adresskomponenten nicht validieren müssen. Mit der Geocoding API werden Adressen in Breiten- und Längengradkoordinaten umgewandelt. Mit der Address Validation API werden Adressen auf Richtigkeit geprüft. Einen detaillierten Vergleich finden Sie im Architecture Center unter Building location validation capability using Google Maps Platform.
Funktionen der Address Validation API
inputDemo ausprobieren
Mit der Address Validation API können Sie ermitteln, ob eine Adresse einen realen Ort bezeichnet. Wenn die Adresse sich nicht auf einen realen Ort bezieht, kann die API möglicherweise falsche Komponenten identifizieren, die Sie Ihren Kunden zur Korrektur präsentieren können. Hier ist ein Beispielworkflow mit der API:
Kunde gibt eine Adresse ein: Das folgende Bild zeigt ein einfaches Formular, in dem ein Kunde eine Adresse eingeben kann, möglicherweise im Rahmen eines Bezahlvorgangs.
App sendet die Adresse an die API: Die Anwendung übergibt diese Adresse als Eingabe an die Address Validation API.
API validiert und standardisiert die Adresse: In der Antwort gibt die Address Validation API die vollständige Adresse zurück, die von der API ermittelt wurde, oder gibt an, wo Informationen fehlen.
Kunde bestätigt oder korrigiert die Adresse: Je nachdem, was die API zurückgibt, können Sie dem Kunden die folgenden Aufforderungen anzeigen:
A. Bestätigen Sie die empfohlene Adresse. B. Geben Sie fehlende Informationen an.
C. Korrigieren Sie die Adresse.
Funktionsweise der Address Validation API
Die Adressvalidierung akzeptiert eine POST-Anfrage mit der Adresse in Form eines JSON-Texts. Die Adresse wird in ihre einzelnen Komponenten unterteilt und dann wird Folgendes versucht:
- Korrekturen: Bietet Validierungsprüfungen auf Komponentenebene, einschließlich untergeordneter Räumlichkeiten, sofern verfügbar.
- Vervollständigen: Versucht, fehlende oder falsche Adresskomponenten abzuleiten.
- Formate: Bereinigt und standardisiert das Format für Adresskomponenten.
Ressourcen
In der folgenden Tabelle sind die über die Address Validation API verfügbaren Ressourcen sowie die zurückgegebenen Daten zusammengefasst. Weitere Informationen finden Sie in der Referenz zur Address Validation API.
| Datenressourcen |
Zurückgegebene Daten |
|
Adresskomponenten im JSON-Format
Weitere Informationen finden Sie unter Adresse bestätigen.
|
Vollständige, bestätigte Adresse (falls möglich)
Validierungsstatus der einzelnen Adresskomponenten.
So sehen Sie, ob eine Adresse verfügbar ist:
- Geocode
- Adressgenauigkeit
- Daten zu Postdiensten, sofern verfügbar.
Weitere Informationen finden Sie unter Validierungsantworten verstehen.
|
Address Validation API verwenden
| 1 |
Demo ausprobieren |
Demo ansehen
mit verschiedenen Adressformularen, sowohl korrekten als auch falschen.
Die Demo bietet eine nützliche Möglichkeit, sowohl die Rückgabewerte des Dienstes als auch die JSON-formatierte API-Antwort zu untersuchen. |
| 2 |
Abdeckung prüfen |
In den Details zur Abdeckung können Sie nachlesen, welche Länder und Regionen von der Address Validation API unterstützt werden. |
| 3 |
Einrichten |
Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung. |
| 4 |
Adressbestätigung anfordern |
Beginnen Sie mit einer einfachen Adresse. Für zusätzliche Genauigkeit können Sie dann CASS (nur für Adressen in den USA und Puerto Rico) aktivieren. Weitere Informationen finden Sie unter Adressbestätigung anfordern. |
| 5 |
Antwort verarbeiten |
Die Antwort der Address Validation API enthält zwei Eigenschaften, die Sie jeweils auf unterschiedliche Weise verwenden.
Weitere Informationen |
| 6 |
Genauigkeit der Validierung verbessern |
Sie können die Genauigkeit von Adressen verbessern, indem Sie Feedback zu Antworten der Address Validation API geben. Weitere Informationen finden Sie unter Aktualisierte Adressen verarbeiten. |
Verfügbare Clientbibliotheken
Eine Liste der verfügbaren Clientbibliotheken für die Address Validation API finden Sie unter Clientbibliotheken.
CASS™
Der United States Postal Service® (USPS®)1 unterstützt und zertifiziert Adressvalidierungsanbieter mit dem Programm Coding Accuracy Support System (CASS™). Ein CASS Certified™-Dienst wie die Address Validation API wurde auf seine Fähigkeit hin überprüft, fehlende Informationen in einer Adresse zu ergänzen, sie zu standardisieren und zu aktualisieren, um Ihnen die aktuellste und genaueste Adresse zu liefern.
CASS ist nicht standardmäßig aktiviert und wird nur für die Regionen „US“ und „PR“ unterstützt. Wenn Sie CASS aktivieren möchten, legen Sie enableUspsCass im Rahmen einer Validierungsanfrage auf true fest. Weitere Informationen finden Sie unter Adresse bestätigen.
Im Rahmen der Nutzung von USPS-Diensten prüft USPS Anfragen für künstlich erstellte Adressen. Wenn USPS eine eingegebene Adresse als künstlich erstellt identifiziert, muss Google die Validierung von Adressen für den Kunden einstellen und die Kontaktdaten des Kunden (Name und Adresse), die entsprechende eingegebene Adresse und aggregierte Nutzungsdaten an USPS melden. Durch die Verwendung der API stimmen Sie diesen dienstspezifischen Nutzungsbedingungen zu.
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 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)"]]
