Vorteile der Address Validation API
Mit der Address Validation API können Sie die Vorhersehbarkeit der Zustellung verbessern und Zustellungsfehler reduzieren und so den Kundenservice verbessern. Dazu erfassen Sie fehlerhafte Adressen und lernen die Adresseigenschaften besser kennen.
Wenn Sie die einzelnen Adresskomponenten für Ihre Anfrage nicht überprüfen müssen, ist die Geocoding API möglicherweise die bessere Wahl. Die Geocoding API konvertiert Adressen in Breiten- und Längengrade, während die Address Validation API die Richtigkeit von Adressen überprüft. Weitere Informationen finden Sie unter Funktionsweise der Address Validation API sowie in der Geocoding API-Übersicht.
Zweck der Address Validation API
Mit der Address Validation API lässt sich feststellen, ob eine Adresse auf einen echten Ort verweist. Wenn sich die Adresse nicht auf einen realen Ort bezieht, kann die API potenziell falsche Komponenten identifizieren, die Sie Ihren Kunden zur Verfügung stellen können. Hier ein Beispiel-Workflow mit der API:
Der Kunde gibt eine Adresse ein. Das folgende Bild zeigt ein einfaches Formular, in dem ein Kunde seine Adresse eingeben kann, auch während des Bezahlvorgangs.
Die App sendet die Adresse an die API. Die Anwendung gibt diese Adresse als Eingabe an die Address Validation API weiter.
Die API validiert und standardisiert: Die Address Validation API gibt die vollständige Adresse zurück, wenn sie von der API ermittelt wird, oder gibt an, wo Informationen fehlen.
Der Kunde korrigiert oder bestätigt die empfohlene Adresse: Je nachdem, was die API zurückgibt, kannst du dem Kunden die folgenden Aufforderungen senden:
Geben Sie dem Kunden eine empfohlene Adresse, um Folgendes zu bestätigen:
Bitte den Kunden, fehlende Informationen hinzuzufügen:
Fordert den Nutzer auf, die Adresse zu korrigieren, wenn die API die Eingabeadresse aufgrund fehlender oder falscher Informationen nicht validieren kann:
Funktionsweise der Address Validation API
Bei der Adressvalidierung wird eine POST-Anfrage mit der Adresse in Form eines JSON-Textkörpers akzeptiert. Die Adresse wird in einzelne Komponenten aufgeteilt. Anschließend werden die folgenden Prüfungen und Korrekturen durchgeführt:
- Bietet Validierungsprüfungen auf Komponentenebene, einschließlich untergeordneter Komponenten, sofern verfügbar.
- Versuche, fehlende oder falsche Adresskomponenten abzuleiten.
- Bereinigt und standardisiert das Format für Adresskomponenten.
Testen Sie die Demo, um die Address Validation API in Aktion zu sehen.
Ressourcen
In der folgenden Tabelle werden 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 |
---|---|
Komponenten im JSON-Format adressieren Weitere Informationen finden Sie unter Adresse bestätigen. |
Geben Sie nach Möglichkeit die vollständige und bestätigte Adresse an. Validierungsstatus der einzelnen Adresskomponenten. Soweit verfügbar für eine Adresse:
Weitere Informationen finden Sie unter Erläuterung der Validierungsantwort. |
Verwendung der Address Validation API
1 | Demo ansehen | In der Demo findest du verschiedene Adressformulare – sowohl richtig als auch falsch. Die Demo bietet eine nützliche Möglichkeit, die Rückgabewerte des Dienstes sowie die API-Antwort im JSON-Format zu untersuchen. |
2 | Einfach einrichten | Beginnen Sie mit dem Einrichten Ihres Google Cloud-Projekts und folgen Sie der Anleitung. |
3 | Adresse bestätigen | Beginne mit einer einfachen Adresse und aktiviere dann, um die Genauigkeit zu erhöhen, CASS (nur für US- und PR-Adressen). Weitere Informationen finden Sie unter Adresse bestätigen. |
4 | Antwort verarbeiten | Die Antwort der Address Validation API bietet zwei Properties, die Sie jeweils auf unterschiedliche Weise verwenden. Weitere Informationen finden Sie unter Erläuterung der Validierungsantwort. |
5 | Validierungsgenauigkeit verbessern | Sie können uns dabei helfen, die Adressgenauigkeit zu verbessern, indem Sie uns Feedback zu den Adress Validation API-Antworten senden. Weitere Informationen |
Verfügbare Clientbibliotheken
Eine Liste der verfügbaren Clientbibliotheken für die Address Validation API finden Sie unter Clientbibliotheken.
CASSTM
Der United States Postal Service® (USPS®)1 verfügt über das Coding Accuracy Support System (CASSTM), um Anbieter von Adressbestätigungen zu unterstützen und zu zertifizieren. Ein CASS-zertifizierterTM Dienst, z. B. die Address Validation API, wurde bestätigt, weil er Informationen aus einer Adresse eintragen, standardisieren und aktualisieren kann, damit Sie die aktuelle und genaueste Adresse erhalten.
CASS ist standardmäßig nicht aktiviert und wird nur für die Regionen „US“ und „PR“ unterstützt. Setzen Sie enableUspsCass
als Teil einer Validierungsanfrage auf true
, um CASS zu aktivieren. Weitere Informationen finden Sie unter Adresse validieren.
Im Rahmen der Nutzung von USPS-Diensten wertet USPS Anfragen für künstlich erstellte Adressen aus. Wenn USPS erkennt, dass eine Eingabeadresse künstlich erstellt wurde, ist Google verpflichtet, die Validierung von Adressen für den Kunden zu beenden und die Kontaktdaten des Kunden (Name und Adresse), die entsprechende Eingabeadresse und aggregierte Nutzungsdaten an USPS zu melden. Durch die Verwendung der API stimmen Sie diesen dienstspezifischen Nutzungsbedingungen zu.
Nächste Schritte
- Häufig gestellte Fragen ansehen: Lesen Sie die häufig gestellten Fragen.
- Abdeckung ansehen: Lesen Sie dazu den Artikel Abdeckung für Länder und Regionen.
- Adressen mit hohem Volumen verarbeiten: Lesen Sie dazu den Artikel Adressenvalidierungs-API zum Verarbeiten von Adressen mit hohem Volumen verwenden.
-
Die Google Maps Platform ist ein nicht exklusiver Lizenznehmer des United States Post Service®. Die folgenden Marken sind Eigentum des United States Post Service® und werden mit Genehmigung verwendet: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩