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
- Zu aktivierender Dienst:
addressvalidation.googleapis.com - Authentifizierung: API-Schlüssel, OAuth 2.0, Dienstkonto
- Erste Schritte: Address Validation API einrichten
- Referenz: Address Validation API-Referenz
- Preise: Address Validation API – Nutzung und Abrechnung
- Richtlinien: Address Validation API-Richtlinien
- Versionshinweise: Versionshinweise zur Address Validation API
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
addressCompletewird im Ergebnis weggelassen, wenn ihr Wertfalseist. Code, der das Vorhandensein des Felds erwartet, kann unvollständige Adressen daher falsch interpretieren. Lösung: Behandeln Sie ein fehlendesaddressComplete-Attribut alsfalseoder prüfen Sie, ob das Attribut vorhanden ist. Weitere Informationen finden Sie unter /maps/documentation/address-validation/understand-response. - Problem: Wenn
regionCodeweggelassen wird, leitet die API die Region aus der Adresse ab, was zu schlechteren Ergebnissen führen kann. Lösung: GibregionCodein derPostalAddressan, wenn du sie kennst. Weitere Informationen finden Sie unter /maps/documentation/address-validation/requests-validate-address. - Problem: Es ist nicht garantiert, dass das Objekt
uspsDatafür jede validierte US-Adresse vollständig ausgefüllt ist. Lösung: Verlassen Sie sich nicht nur aufuspsDataals 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
provideValidationFeedbackgesendet wird, muss sich auf dieresponseIdaus dem erstenvalidateAddress-Aufruf in der Sequenz beziehen, nicht auf einen späteren. Lösung: Speichere dieresponseIdaus der erstenvalidateAddress-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.
- Eine validierte Adresse für eine angegebene Adresse oder Teiladresse zurückgeben.
- Breiten- und Längengradkoordinaten für eine validierte Adresse zurückgeben
- Google-Orts-ID für eine validierte Adresse zurückgeben
- Verwenden Sie die CASS-Zertifizierung (Coding Accuracy Support System) des United States Postal Service (USPS) für die Adressvalidierung.
- Informationen darüber zurückgeben, ob es sich bei einer validierten Adresse um ein Unternehmen, einen Wohnsitz oder ein Postfach handelt.
- USPS-Zustellungsmetadaten (United States Postal Service) für eine validierte Adresse zurückgeben
- Eine englischsprachige Version einer validierten Adresse zurückgeben. Vorabversion
- Plus Code für eine bestätigte Adresse zurückgeben