Address Validation API

Die Address Validation API ist ein Dienst, der eine Adresse akzeptiert, die Adresskomponenten identifiziert und validiert. Außerdem wird die Postadresse standardisiert und der bekannteste Breiten- und Längengrad ermittelt. Es kann hilfreich sein zu verstehen, ob sich eine Adresse auf einen realen Ort bezieht. Wenn sich die Adresse nicht auf einen tatsächlichen Ort bezieht, können eventuell falsche Komponenten identifiziert werden, sodass Nutzer sie korrigieren können.

Die Address Validation API bietet viele Funktionen, mit denen Sie eine Adresse verarbeiten können, darunter:

  • Trennt die Adresse in die einzelnen Komponenten und führt dann Validierungsprüfungen auf Komponentenebene durch, einschließlich untergeordneter Komponenten (falls verfügbar).

  • Bereinigt, standardisiert und leitet fehlende oder falsche Adresskomponenten ab.

  • Die Adresse wird durch zusätzliche Informationen ergänzt, darunter Geocoding-, Adressgenauigkeits- und Postdienstdaten.

  • Gibt einen einzelnen String zurück, der die von der API ermittelte vollständige Adresse enthält.

Demo ansehen, um die Address Validation API in Aktion zu sehen.

Address Validation API in den Workflow einbinden

Einer der häufigsten Anwendungsfälle der Address Validation API ist die Gewährleistung einer korrekten Adresse für den Kunden. Die Adressvalidierung hilft, Fehler bei der Zustellung zu vermeiden, da fehlerhafte Adressen erkannt werden. Außerdem wird die Vorhersagbarkeit der Zustellung verbessert, weil die Adresseigenschaften besser erkannt werden.

Die folgende Abbildung zeigt ein einfaches Formular, mit dem ein Kunde während des Bezahlvorgangs eine Adresse eingeben kann. Übergeben Sie diese Adresse als Eingabe an die Address Validation API.

Die vom Kunden eingegebene Adresse.

Die Address Validation API gibt die vollständige Adresse zurück, die von der API festgelegt wurde. Präsentieren Sie dem Kunden die vollständige Adresse als empfohlene Adresse:

Die von der API ermittelte Adresse.

Wenn die Address Validation API fehlende Informationen erkennt, bitten Sie den Nutzer, sie hinzuzufügen:

Das Formular, in dem der Kunde zur Eingabe fehlender Adressinformationen aufgefordert wird.

Wenn die API die Eingabeadresse aufgrund fehlender oder falscher Informationen nicht validieren kann, bitten Sie den Nutzer, die Adresse zu korrigieren:

Das Formular, in dem der Kunde aufgefordert wird, die Adressinformationen zu korrigieren.

Unterschiede zwischen der Address Validation API und der Geocoding API

Sowohl die Geocoding API als auch die Address Validation API versuchen, die Frage „Was ist der beste Standort für diese Nutzereingabe?“ zu beantworten. Im Gegensatz zur Geocoding API versucht die Address Validation API auch Folgendes:

  • Beantworten Sie die Frage „Repräsentiert diese Nutzereingabe eine echte Adresse?“.
  • Eingabeadresse verstehen, auch wenn Teile davon nicht den verfügbaren Daten zugeordnet werden können
  • Feedback zur Gültigkeit verschiedener Komponenten geben
  • Prüfen Sie, ob die Adresse vollständig ist, und melden Sie alle erforderlichen Komponenten, die fehlen.
  • Formatieren Sie die zurückgegebene Adresse speziell für den Versand

Bei einer Adresse wie „123 Fake St, Mountain View, CA“ würde die Geocoding API einfach einen Geocode für die Stadt Mountain View, CA, zurückgeben und „123 Fake St“ ignorieren, da es in Mountain View keine entsprechende Straße (oder ähnlich benannte Straße) gibt.

Die Address Validation API kann dagegen erkennen, dass „123“ eine Hausnummer und „Fake St“ eine Straße ist. Sie gibt dann ein Ergebnis zurück, das diese Komponenten enthält, und markiert sie als nicht bestätigt. So erhalten Sie ein Signal dafür, dass die Adresse möglicherweise nicht geocodiert werden kann.

Über CASSTM

Der United States Postal Service® (USPS®)1 unterhält das Coding Accuracy Support System (CASSTM) zur Unterstützung und Zertifizierung von Anbietern für die Adressüberprüfung. Ein CASS CertifiedTM-Dienst wie die Address Validation API wurde bestätigt, weil er Informationen aus einer Adresse hinzufügen, standardisieren und aktualisieren kann, damit 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. Setzen Sie enableUspsCass als Teil einer Validierungsanfrage auf true, um CASS zu aktivieren. Weitere Informationen finden Sie unter Adresse bestätigen.

Als Teil unserer Nutzung von USPS-Diensten wertet USPS Anfragen für künstlich erstellte Adressen aus. Wenn USPS feststellt, dass eine Eingabeadresse künstlich erstellt wurde, muss Google die Validierung von Adressen für den Kunden beenden und die Kontaktdaten des Kunden (Name und Adresse), die entsprechende Eingabeadresse und aggregierte Nutzungsdaten an USPS melden. Durch die Verwendung der API stimmen Sie diesen dienstspezifischen Nutzungsbedingungen zu.

Nächste Schritte


  1. Google Maps Platform ist ein nicht ausschließlicher 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.