Address Validation API – Kurzübersicht

Die Address Validation API akzeptiert eine Adresse, identifiziert ihre Komponenten und validiert sie, standardisiert die Adresse für den Postversand und gibt die genauesten Breiten- und Längengradkoordinaten für sie zurück. Für Adressen in den USA und Puerto Rico können Sie optional die USPS-CASS-Verarbeitung aktivieren.

Address Validation API: Wichtige Fakten

  • Produkt: Address Validation API
  • Kategorie: Orte
  • Plattform: Webdienst (REST)
  • Ausführung auf: Server (Backend-Code)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Address Validation API – Übersicht
  • Regionale Verfügbarkeit: Eingeschränkt. Die unterstützten Länder und die Datenqualität variieren je nach Land. Einige Länder befinden sich in der Vorabversion. Metadaten zu Wohn- und Gewerbegebieten werden nur für Länder zurückgegeben, die auf der Seite zur Abdeckung gekennzeichnet sind. USPS CASS wird nur für die USA und Puerto Rico unterstützt. (Details zur Abdeckung)

Address Validation API: Wann sollte sie verwendet werden?

Verwenden Sie die Address Validation API, wenn:

  • Sie müssen prüfen, ob sich eine Adresse auf einen realen Ort bezieht, und herausfinden, welche Komponenten fehlen oder möglicherweise falsch sind.
  • Sie müssen eine Adresse für den Postversand standardisieren und vervollständigen, z. B. während eines Bezahlvorgangs.
  • Für Adressen in den USA oder Puerto Rico benötigen Sie eine USPS-CASS-zertifizierte Validierung und uspsData.
  • Sie benötigen Metadaten zu Wohn- oder Geschäftsadressen für ein Land, das auf der Seite zur Abdeckung aufgeführt ist.

Verwenden Sie die Address Validation API nicht, wenn:

  • Sie müssen nur eine Adresse in Längen- und Breitengradangaben umwandeln und keine einzelnen Adresskomponenten validieren. Verwenden Sie stattdessen die Geocoding API.
  • Sie benötigen hyperlokale Zieldetails wie Gebäudeeingänge, Gebäudeumrisse oder Navigationspunkte. Verwenden Sie stattdessen die Geocoding API.

Address Validation API: Einrichtung

Offizielle Address Validation API-Pakete:

  • npm: @googlemaps/addressvalidation
  • pypi: google-maps-addressvalidation
  • go: cloud.google.com/go/maps

Address Validation API: Häufige Fehler

  • Problem: Die Property addressComplete wird im Ergebnis weggelassen, wenn ihr Wert false ist. Code, der das Vorhandensein des Felds erwartet, kann unvollständige Adressen daher falsch interpretieren. Lösung: Behandeln Sie ein fehlendes addressComplete-Attribut als false oder prüfen Sie, ob das Attribut vorhanden ist. Weitere Informationen finden Sie unter /maps/documentation/address-validation/understand-response.
  • Problem: Wenn regionCode weggelassen wird, leitet die API die Region aus der Adresse ab, was zu schlechteren Ergebnissen führen kann. Lösung: Gib regionCode in der PostalAddress an, wenn du sie kennst. Weitere Informationen finden Sie unter /maps/documentation/address-validation/requests-validate-address.
  • Problem: Es ist nicht garantiert, dass das Objekt uspsData für jede validierte US-Adresse vollständig ausgefüllt ist. Lösung: Verlassen Sie sich nicht nur auf uspsData als Validierungssignal, sondern verwenden Sie auch das Ergebnis und die Adresskomponenten. Weitere Informationen finden Sie unter /maps/documentation/address-validation/handle-us-address.
  • Problem: Feedback, das mit provideValidationFeedback gesendet wird, muss sich auf die responseId aus dem ersten validateAddress-Aufruf in der Sequenz beziehen, nicht auf einen späteren. Lösung: Speichere die responseId aus der ersten validateAddress-Antwort und sende sie in der Feedbackanfrage. Weitere Informationen finden Sie unter /maps/documentation/address-validation/handle-updated-address.

Möglichkeiten mit der Address Validation API

In den unten verlinkten Anleitungen finden Sie Informationen zu den einzelnen Aufgaben. Sie können die Produkte auch im Capabilities Explorer vergleichen.