Address Validation API – Übersicht

Adressüberprüfung – Ü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.
    Die vom Kunden eingegebene Adresse.

  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:
      Bitten Sie den Kunden, die von der API ermittelte Adresse zu bestätigen.

    • Bitte den Kunden, fehlende Informationen hinzuzufügen:
      Fordere den Kunden auf, fehlende Adressinformationen einzugeben.

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

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®)1 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


  1. Die Google Maps Platform ist ein nicht-exklusiver Lizenznehmer des United States Postal Service®. Die folgenden Marken sind Eigentum des United States Postal Service® und werden mit Genehmigung verwendet: United States Postal Service®, CASSTM, CASS CertifiedTM.