Address Validation API – Übersicht

Adressüberprüfung

Die Address Validation API ist ein Dienst, der eine Adresse akzeptiert. Es identifiziert Adresskomponenten und validiert sie. Außerdem vereinheitlicht sie die Adresse für den Postversand und ermittelt die bekanntesten Breiten- und Längengradkoordinaten 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 der Lieferungen verbessern, Zustellungsfehler reduzieren und so die Kundenzufriedenheit steigern. Sie tun dies, indem Sie ungültige Adressen abfangen und sich ein besseres Bewusstsein für Adresseigenschaften verschaffen.

Wenn Sie die einzelnen Adresskomponenten nicht validieren müssen, ist die Geocoding API möglicherweise besser für Ihre Anforderungen geeignet. Die Geocoding API wandelt Adressen in Breiten- und Längengrade um, während die Address Validation API Adressen auf Richtigkeit überprüft. Einen detaillierten Vergleich finden Sie im Architekturcenter unter Standortvalidierungsfunktion mit der Google Maps Platform 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 präsentieren können. Hier ist ein Beispiel-Workflow mit der API:

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

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

  3. API validiert und standardisiert die Adresse: In ihrer Antwort gibt die Address Validation API die vollständige Adresse zurück, die von der API ermittelt wurde, oder gibt 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 zur Verfügung stellen:

    • Präsentiere dem Kunden eine empfohlene Adresse zur Bestätigung:
      Bitte den Kunden, die von der API ermittelte Adresse zu bestätigen.

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

    • Nutzer auffordern, die Adresse zu korrigieren, wenn die API die eingegebene Adresse 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. Sie trennt die Adresse 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 Räumlichkeiten, sofern verfügbar.
  • Abgeschlossen: Versuche, fehlende oder falsche Adresskomponenten abzuleiten.
  • Gut formatiert: Hiermit wird das Format für Adresskomponenten bereinigt und standardisiert.

In dieser Demo sehen Sie die Address Validation API in Aktion.

Ressourcen

In der folgenden Tabelle werden 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 der einzelnen Adresskomponenten.

Wo für eine Adresse verfügbar:

  • Geocodieren
  • Adressgenauigkeit
  • Postdienstdaten, sofern verfügbar.

Siehe Validierungsantwort verstehen.

Address Validation API verwenden

1 Demo ansehen Sehen Sie sich die Demo an, in der Sie verschiedene richtige und falsche Adressformulare ansehen. Die Demo bietet eine nützliche Möglichkeit, sowohl die Rückgabewerte des Dienstes als auch die API-Antwort im JSON-Format kennenzulernen.
2 Abdeckung prüfen In den Details zur Abdeckung sehen Sie, 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 beantragen 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 Validierungsgenauigkeit verbessern Sie können dazu beitragen, die Adressgenauigkeit zu verbessern, indem Sie Feedback zu Antworten der Address Validation API geben. Weitere Informationen

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 betreibt das Coding Accuracy Support System (CASSTM), um Anbieter von Adressüberprüfungen zu unterstützen und zu zertifizieren. Ein 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. Legen Sie zum Aktivieren von CASS enableUspsCass im Rahmen einer Validierungsanfrage auf true fest. Weitere Informationen finden Sie unter Adresse bestätigen.

Im Rahmen der Nutzung von USPS-Diensten wertet USPS Anfragen nach künstlich erstellten Adressen aus. Wenn USPS eine Eingabeadresse als künstlich erstellt erkennt, muss Google die Validierung von Adressen für den Kunden beenden und die Kontaktdaten des Kunden (Name und Adresse), die relevante Eingabeadresse und aggregierte 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.