Address Validation API – Übersicht

Die Address Validation API ist ein Dienst, der eine Adresse akzeptiert. Er identifiziert Adresskomponenten und validiert sie. Außerdem standardisiert die Adresse für den Versand und ermittelt die bekanntesten Breiten- und Längengrade dafür. Für Adressen in den USA und Puerto Rico können Sie optional das Coding Accuracy Support System (CASSTM) aktivieren.

Vorteile der Address Validation API

Mit der Address Validation API können Sie die Vorhersehbarkeit von Übermittlungen verbessern, Zustellungsfehler reduzieren und so die Kundenerfahrung verbessern. Dies geschieht, indem Sie schlechte Adressen erkennen und sich ein besseres Bewusstsein für Adressmerkmale verschaffen.

Die Geocoding API ist möglicherweise besser für Ihre Anforderungen geeignet, wenn Sie die einzelnen Adresskomponenten nicht validieren müssen. Die Geocoding API wandelt Adressen in Breiten- und Längengrade um, während die Address Validation API Adressen auf Richtigkeit validiert. Einen ausführlichen Vergleich finden Sie im Architekturcenter unter Mit der Google Maps Platform eine Funktion zur Standortvalidierung erstellen.

Möglichkeiten mit der Address Validation API

Mit der Address Validation API können Sie feststellen, ob sich eine Adresse auf einen realen Ort bezieht. Wenn sich die Adresse nicht auf einen realen Ort bezieht, kann die API möglicherweise falsche Komponenten identifizieren, die Sie Ihren Kunden zur Korrektur anzeigen können. Hier ein Beispiel-Workflow mit der API:

1. Kunde gibt eine Adresse ein: Die folgende Abbildung zeigt ein einfaches Formular, in dem ein Kunde eine Adresse eingeben kann, möglicherweise während des Bezahlvorgangs.
   

2. Die Anwendung sendet die Adresse an die API. Die Anwendung übergibt diese Adresse als Eingabe an die Address Validation API.

3. Die API validiert und standardisiert die Adresse: In ihrer Antwort gibt die Address Validation API die von der API ermittelte vollständige Adresse zurück oder zeigt an, wo Informationen fehlen.

4. Der Kunde korrigiert oder bestätigt die empfohlene Adresse – Abhängig davon, was die API zurückgibt, kannst du dem Kunden die folgenden Aufforderungen senden:

   • Nenne dem Kunden eine empfohlene Adresse zur Bestätigung:
     

   • Bitte den Kunden, fehlende Informationen hinzuzufügen:
     

   • Bitten Sie den Nutzer, die Adresse zu korrigieren, wenn die API die Eingabeadresse aufgrund fehlender oder falscher Informationen nicht validieren kann:
     

Funktionsweise der Address Validation API

Die Adressvalidierung akzeptiert eine POST-Anfrage mit der Adresse in Form eines JSON-Textkörpers. Die Adresse trennt sie in ihre einzelnen Komponenten und führt dann die folgenden Prüfungen und Korrekturen durch:

• Richtig: Stellt Validierungsprüfungen auf Komponentenebene bereit, einschließlich untergeordneter Bereitstellungen, sofern verfügbar.
• Abgeschlossen: Versuche, fehlende oder falsche Adresskomponenten abzuleiten.
• Gut formatiert: Bereinigung und Standardisierung des Formats für Adresskomponenten.

Sehen Sie sich die Demo an, um die Address Validation API in Aktion zu sehen.

Ressourcen

In der folgenden Tabelle sind die über die Address Validation API verfügbaren Ressourcen und die zurückgegebenen Daten zusammengefasst. Weitere Informationen finden Sie in der Referenz zur Address Validation API.

Datenressourcen	Zurückgegebene Daten
Adresskomponenten im JSON-Format adressieren. Weitere Informationen finden Sie unter Adresse bestätigen.	Vollständige, bestätigte Adresse (falls möglich) Validierungsstatus jeder Adresskomponente. Wenn für eine Adresse verfügbar: Geocodieren Adressgenauigkeit Postdienstdaten, sofern verfügbar. Siehe Validierungsantwort verstehen.

Address Validation API verwenden

1	Demo ausprobieren	Sehen Sie sich die Demo an, in der verschiedene richtige und falsche Adressformulare vorgestellt werden. 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 finden Sie Informationen dazu, welche Länder und Regionen von der Address Validation API unterstützt werden.
3	Jetzt einrichten	Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung.
4	Adressüberprüfung anfordern	Beginnen Sie mit einer einfachen Adresse und aktivieren Sie dann für zusätzliche Genauigkeit CASS (nur für US- und PR-Adressen). Weitere Informationen finden Sie unter Adressüberprüfung anfordern.
5	Antwort verarbeiten	Die Antwort der Address Validation API enthält zwei Eigenschaften, die Sie jeweils auf unterschiedliche Weise verwenden. Siehe Grundlegende Antwort verstehen.
6	Genauigkeit der Validierung verbessern	Sie können dazu beitragen, die Adressgenauigkeit zu verbessern, indem Sie Feedback zu Antworten der Address Validation API geben. Weitere Informationen finden Sie unter Feedback zur Adressüberprüfung geben.

Verfügbare Clientbibliotheken

Eine Liste der verfügbaren Clientbibliotheken für die Address Validation API finden Sie unter Clientbibliotheken.

Über CASSTM

Der United States Postal Service® (USPS®)¹ verwaltet das Coding Accuracy Support System (CASSTM), um Anbieter von Adressüberprüfungen zu unterstützen und zu zertifizieren. Für einen CASS CertifiedTM-Dienst wie die Address Validation API wurde bestätigt, dass er fehlende Informationen in einer Adresse ergänzen, standardisieren und aktualisieren kann, sodass Sie die aktuelle und genaueste Adresse erhalten.

CASS ist nicht standardmäßig aktiviert und wird nur für die Regionen „US“ und „PR“ unterstützt. Zum Aktivieren von CASS legen Sie als Teil einer Validierungsanfrage enableUspsCass auf true fest. Weitere Informationen finden Sie unter Adresse bestätigen.

Im Rahmen der Nutzung der USPS-Dienste wertet USPS Anträge auf künstlich erstellte Adressen aus. Wenn USPS eine Eingabeadresse als künstlich erstellt erkennt, muss Google die Validierung von Adressen für den Kunden einstellen und die Kontaktdaten des Kunden (Name und Adresse), die relevante Eingabeadresse und die zusammengefassten Nutzungsdaten an USPS melden. Durch die Verwendung der API stimmen Sie diesen dienstspezifischen Nutzungsbedingungen zu.

Nächste Schritte

• Häufig gestellte Fragen lesen: Rufen Sie die Seite FAQs auf.
• Abdeckung prüfen: Weitere Informationen finden Sie unter Abdeckung für Länder und Regionen.
• Adressen mit hohem Volumen verarbeiten: Lesen Sie den Hilfeartikel Address Validation API verwenden, um viele Adressen zu verarbeiten.