Vorteile der Address Validation API
Mit der Address Validation API können Sie die Zustellbarkeit verbessern und Zustellungsfehler reduzieren, was die Kundenzufriedenheit steigert. Dazu müssen Sie fehlerhafte Adressen erkennen und sich mit den Merkmalen von Adressen vertraut machen.
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ängengradkoordinaten um. Die Address Validation API prüft Adressen auf Richtigkeit. Einen detaillierten Vergleich finden Sie im Architecture Center unter Funktion zur Gebäudestandortbestätigung mit der Google Maps Platform.
Was Sie mit der Address Validation API tun können
Mit der Address Validation API können Sie feststellen, ob eine Adresse auf einen realen Ort verweist. Wenn die Adresse nicht auf einen realen Ort verweist, kann die API möglicherweise falsche Komponenten identifizieren, die Sie Ihren Kunden zur Korrektur vorlegen können. Hier ein Beispiel für einen Workflow mit der API:
Der Kunde gibt eine Adresse ein: Das folgende Bild zeigt ein einfaches Formular, in dem ein Kunde eine Adresse eingeben kann, möglicherweise im Rahmen des Bezahlvorgangs.
Die App sendet die Adresse an die API: Die Anwendung gibt diese Adresse als Eingabe an die Address Validation API weiter.
Die API validiert und standardisiert die Adresse: In der Antwort gibt die Address Validation API die vollständige Adresse zurück, die von der API ermittelt wurde, oder gibt an, wo Informationen fehlen.
Der Kunde korrigiert oder bestätigt die empfohlene Adresse: Je nachdem, was die API zurückgibt, kannst du dem Kunden die folgenden Aufforderungen geben:
Zeige dem Kunden eine empfohlene Adresse zur Bestätigung an:
Bitte den Kunden, fehlende Informationen hinzuzufügen:
Bitten Sie den Nutzer, die Adresse zu korrigieren, wenn die API die eingegebene Adresse aufgrund fehlender oder falscher Informationen nicht validieren kann:
Funktionsweise der Address Validation API
Die Adressbestätigung akzeptiert eine POST-Anfrage mit der Adresse im JSON-Text. Die Adresse wird in ihre einzelnen Komponenten unterteilt und dann werden die folgenden Prüfungen und Korrekturen durchgeführt:
- Richtig: Ermöglicht Validierungsüberprüfungen auf Komponentenebene, einschließlich untergeordneter Standorte, sofern verfügbar.
- Vollständig: Es wird versucht, fehlende oder falsche Adresskomponenten zu ermitteln.
- Gut formatiert: Das Format der Adresskomponenten wird bereinigt und standardisiert.
Testen Sie die Demo, um die Address Validation API in Aktion zu sehen.
Ressourcen
In der folgenden Tabelle sind die über die Address Validation API verfügbaren Ressourcen sowie die zurückgegebenen Daten zusammengefasst. Weitere Informationen finden Sie in der Referenz zur Address Validation API.
| Datenressourcen | Zurückgegebene Daten |
|---|---|
|
Adresskomponenten im JSON-Format Weitere Informationen finden Sie unter Adressen überprüfen. |
Vollständige, bestätigte Adresse (falls möglich) Der Validierungsstatus der einzelnen Adresskomponenten. Sofern für eine Adresse verfügbar:
Weitere Informationen finden Sie unter Validierungsantworten verstehen. |
Address Validation API verwenden
| 1 | Demo ausprobieren | In der Demo finden Sie eine Vielzahl von Adressen, sowohl korrekt als auch falsch. 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 sehen Sie, in welchen Ländern und Regionen die Address Validation API unterstützt wird. |
| 3 | Einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung. |
| 4 | Adresse bestätigen lassen | Beginnen Sie mit einer einfachen Adresse und aktivieren Sie dann CASS (nur für Adressen in den USA und in Puerto Rico), um die Genauigkeit zu erhöhen. Weitere Informationen finden Sie unter Adressenüberprüfung beantragen. |
| 5 | Antwort verarbeiten | Die Antwort der Address Validation API enthält zwei Properties, die Sie auf unterschiedliche Weise verwenden können. Weitere Informationen finden Sie unter Grundlegende Antwort. |
| 6 | Genauigkeit der Validierung verbessern | Sie können dazu beitragen, die Genauigkeit von Adressen zu verbessern, indem Sie Feedback zu den Antworten der Address Validation API geben. Weitere Informationen finden Sie unter Aktualisierte Adressen verarbeiten. |
Verfügbare Clientbibliotheken
Eine Liste der verfügbaren Clientbibliotheken für die Address Validation API finden Sie unter Clientbibliotheken.
CASS™
Der United States Postal Service® (USPS®)1 verwaltet das Coding Accuracy Support System (CASS™), um Anbieter von Adressvalidierungsdiensten zu unterstützen und zu zertifizieren. Ein CASS Certified™-Dienst wie die Address Validation API wurde für seine Fähigkeit bestätigt, fehlende Informationen in einer Adresse zu ergänzen, sie zu standardisieren und zu aktualisieren, um Ihnen die aktuellste und genaueste Adresse zu liefern.
CASS ist nicht standardmäßig aktiviert und wird nur für die Regionen „US“ und „PR“ unterstützt. Wenn Sie CASS aktivieren möchten, legen Sie enableUspsCass in einem Validierungsantrag auf true fest. Weitere Informationen finden Sie unter Adressen prüfen.
Im Rahmen der Nutzung der USPS-Dienste prüft USPS Anfragen auf künstlich erstellte Adressen. Wenn USPS eine Eingabeadresse als künstlich erstellt identifiziert, 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 Nutzung der API stimmen Sie diesen dienstspezifischen Nutzungsbedingungen zu.
Nächste Schritte
- FAQs lesen: FAQs
- Abdeckungsgebiete prüfen: Details zur Abdeckung von Ländern und Regionen
- Adressen in großem Umfang verarbeiten: Address Validation API zur Verarbeitung großer Adressmengen verwenden
-
Die Google Maps Platform ist ein nicht exklusiver Lizenznehmer von United States Postal Service®. Die folgenden Marken sind eingetragene Marken von United States Postal Service® und werden mit dessen Zustimmung verwendet: United States Postal Service®, CASS™, CASS Certified™. ↩