Address Validation API zum Verarbeiten von Adressen mit hohem Volumen

Ziel

Als Entwickler arbeiten Sie häufig mit Datasets, die Kundenadressen enthalten, die möglicherweise nicht von guter Qualität sind. Sie müssen sicherstellen, dass Adressen für Anwendungsfälle wie die Überprüfung der Kunden-ID, die Lieferung und mehr korrekt sind.

Die Address Validation API ist ein Produkt der Google Maps Platform, mit dem Sie eine Adresse validieren können. Es wird jedoch nur eine Adresse gleichzeitig verarbeitet. In diesem Dokument erfahren Sie, wie Sie die Address Validation API für große Datenmengen in verschiedenen Szenarien verwenden, von API-Tests bis hin zur einmaligen und wiederkehrenden Adressvalidierung.

Anwendungsfälle

Sehen wir uns nun die Anwendungsfälle an, in denen die Address Validation API für große Datenmengen nützlich ist.

Test

Sie möchten die Address Validation API häufig testen, indem Sie Tausende von Adressen ausführen. Möglicherweise haben Sie die Adressen in einer CSV-Datei (Comma Separated Value) und möchten die Qualität der Adressen validieren.

Einmalige Validierung von Adressen

Beim Onboarding für die Address Validation API möchten Sie Ihre vorhandene Adressdatenbank mit der Nutzerdatenbank validieren.

Wiederkehrende Validierung von Adressen

In einer Reihe von Szenarien müssen Adressen regelmäßig validiert werden:

  • Möglicherweise haben Sie Jobs geplant, um Adressen für Details zu validieren, die im Laufe des Tages erfasst wurden, z. B. bei Kundenregistrierungen, Bestelldetails und Lieferplänen.
  • Möglicherweise erhalten Sie Daten-Dumps mit Adressen aus verschiedenen Abteilungen, z. B. aus dem Vertrieb und Marketing. Die neue Abteilung, die die Adressen erhält, möchte sie oft vor der Verwendung validieren.
  • Sie können Adressen bei Umfragen oder verschiedenen Werbeaktionen erfassen und später im Online-System aktualisieren. Sie möchten die Adressen beim Eingeben in das System validieren.

Technische Details

Für die Zwecke dieses Dokuments gehen wir davon aus, dass:

  • Sie die Address Validation API mit Adressen aus einer Kundendatenbank aufrufen (d. h. einer Datenbank mit Kundendetails).
  • Sie Gültigkeitsflags für einzelne Adressen in Ihrer Datenbank im Cache speichern können.
  • Gültigkeitsflags werden von der Address Validation API abgerufen, wenn sich ein einzelner Kunde anmeldet.

Cache für die Produktion

Wenn Sie die Address Validation API verwenden, möchten Sie oft einen Teil der Antwort aus dem API-Aufruf im Cache speichern. Gemäß unseren Nutzungs bedingungen ist eingeschränkt, welche Daten im Cache gespeichert werden können. Alle Daten, die aus der Address Validation API im Cache gespeichert werden können, müssen für ein Nutzerkonto im Cache gespeichert werden. Das bedeutet, dass die Adresse oder die Adressmetadaten in der Datenbank für die E-Mail-Adresse oder eine andere primäre ID eines Nutzers im Cache gespeichert werden müssen.

Für den Anwendungsfall der Address Validation API für große Datenmengen muss die Datenspeicherung im Cache den dienstspezifischen Nutzungsbedingungen der Address Validation API entsprechen , die in Abschnitt 11.3 beschrieben sind. Anhand dieser Informationen können Sie feststellen, ob die Adresse eines Nutzers ungültig ist. In diesem Fall fordern Sie den Nutzer bei der nächsten Interaktion mit Ihrer Anwendung auf, eine korrigierte Adresse anzugeben.

  • Daten aus dem AddressComponent Objekt
    • confirmationLevel
    • inferred
    • spellCorrected
    • replaced
    • unexpected

Wenn Sie Informationen zur tatsächlichen Adresse im Cache speichern möchten, müssen Sie dies nur mit der Einwilligung des Nutzers tun. So wird sichergestellt, dass der Nutzer genau weiß, warum ein bestimmter Dienst seine Adresse speichert, und dass er mit den Bedingungen für die Weitergabe seiner Adresse einverstanden ist.

Ein Beispiel für die Einwilligung des Nutzers ist die direkte Interaktion mit einem E-Commerce-Adressformular auf einer Checkout-Seite. Es wird davon ausgegangen, dass Sie die Adresse im Cache speichern und verarbeiten, um ein Paket zu versenden.

Mit der Einwilligung des Nutzers können Sie formattedAddress und andere wichtige Komponenten aus der Antwort im Cache speichern. In einem Headless-Szenario kann ein Nutzer jedoch keine Einwilligung geben, da die Adressvalidierung im Back-End erfolgt. Daher können Sie in diesem Headless-Szenario nur sehr wenige Informationen im Cache speichern.

Antwort verstehen

Wenn die Antwort der Address Validation API die folgenden Marker enthält, dann können Sie sicher sein, dass die eingegebene Adresse lieferbar ist:

  • Der addressComplete Marker im Verdict Objekt ist true,
  • Der Wert von validationGranularity im Verdict Objekt ist PREMISE oder SUB_PREMISE
  • Keine der AddressComponent Marker sind:
    • Inferred(Hinweis: inferred=truekann auftreten, wenn addressComplete=true)
    • spellCorrected
    • replaced
    • unexpected und
  • confirmationLevel: Die Bestätigungsstufe für die AddressComponent ist aufCONFIRMEDoderUNCONFIRMED_BUT_PLAUSIBLE

Wenn die API-Antwort die oben genannten Marker nicht enthält, war die eingegebene Adresse wahrscheinlich von schlechter Qualität. Sie können Flags in Ihrer Datenbank im Cache speichern, um dies widerzuspiegeln. Im Cache gespeicherte Flags geben an, dass die Adresse insgesamt von schlechter Qualität ist. Detailliertere Flags wie „Spell Corrected“ geben das spezifische Problem mit der Adressqualität an. Bei der nächsten Kundeninteraktion mit einer als von schlechter Qualität gekennzeichneten Adresse können Sie die Address Validation API mit der vorhandenen Adresse aufrufen. Die Address Validation API gibt die korrigierte Adresse zurück, die Sie mit einer UI-Aufforderung anzeigen können. Sobald der Kunde die formatierte Adresse akzeptiert, können Sie Folgendes aus der Antwort im Cache speichern:

  • formattedAddress
  • postalAddress
  • addressComponent componentNamesoder
  • UspsData standardizedAddress

Headless-Adressvalidierung implementieren

Basierend auf der obigen Diskussion:

  • Aus geschäftlichen Gründen ist es oft erforderlich, einen Teil der Antwort der Address Validation API im Cache zu speichern.
  • Gemäß den Nutzungs bedingungen in der Google Maps Platform ist jedoch eingeschränkt, welche Daten im Cache gespeichert werden können.

Im folgenden Abschnitt wird ein zweistufiger Prozess beschrieben, mit dem Sie die Nutzungsbedingungen einhalten und die Adressvalidierung für große Datenmengen implementieren können.

Schritt 1:

Im ersten Schritt sehen wir uns an, wie Sie ein Skript zur Adressvalidierung für große Datenmengen aus einer vorhandenen Datenpipeline implementieren. Mit diesem Prozess können Sie bestimmte Felder aus der Antwort der Address Validation API auf eine Weise speichern, die den Nutzungsbedingungen entspricht.

Diagramm A:Das folgende Diagramm zeigt, wie eine Datenpipeline mit einer Logik zur Adressvalidierung für große Datenmengen erweitert werden kann.

alt_text

Gemäß den Nutzungsbedingungen können Sie die folgenden Daten aus addressComponent im Cache speichern:

  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

In diesem Schritt der Implementierung speichern wir die oben genannten Felder im Cache für die UserID.

Weitere Informationen finden Sie unter Details zur tatsächlichen Daten struktur.

Schritt 2:

In Schritt 1 haben wir Feedback erhalten, dass einige Adressen im Eingabe-Dataset möglicherweise nicht von hoher Qualität sind. Im nächsten Schritt präsentieren wir diese gekennzeichneten Adressen dem Nutzer und holen seine Einwilligung ein, die gespeicherte Adresse zu korrigieren.

Diagramm B: Dieses Diagramm zeigt, wie eine End-to-End-Integration des Einwilligungsablaufs für Nutzer aussehen könnte:

alt_text

  1. Wenn sich der Nutzer anmeldet, prüfen Sie zuerst, ob Sie Validierungsflags in Ihrem System im Cache gespeichert haben.
  2. Wenn Flags vorhanden sind, sollten Sie dem Nutzer eine Benutzeroberfläche präsentieren, auf der er seine Adresse korrigieren und aktualisieren kann.
  3. Sie können die Address Validation API noch einmal mit der aktualisierten oder im Cache gespeicherten Adresse aufrufen und dem Nutzer die korrigierte Adresse zur Bestätigung präsentieren.
  4. Wenn die Adresse von guter Qualität ist, gibt die Address Validation API eine formattedAddress zurück.
  5. Sie können dem Nutzer diese Adresse präsentieren, wenn Korrekturen vorgenommen wurden, oder sie im Hintergrund akzeptieren, wenn keine Korrekturen erforderlich sind.
  6. Sobald der Nutzer die Adresse akzeptiert hat, können Sie formattedAddress in der Datenbank im Cache speichern.

Fazit

Die Adressvalidierung für große Datenmengen ist ein häufiger Anwendungsfall, der in vielen Anwendungen vorkommt. In diesem Dokument werden einige Szenarien und ein Designmuster beschrieben, mit denen Sie eine solche Lösung implementieren können, die den Nutzungsbedingungen der Google Maps Platform entspricht.

Wir haben außerdem eine Referenzimplementierung der Adressvalidierung für große Datenmengen als Open-Source-Bibliothek auf GitHub erstellt. So können Sie schnell mit der Entwicklung mit der Adressvalidierung für große Datenmengen beginnen. Lesen Sie auch den Artikel zu Designmustern, in dem beschrieben wird, wie Sie die Bibliothek in verschiedenen Szenarien verwenden.

Nächste Schritte

Laden Sie das Improve checkout, delivery, and operations with reliable addresses Whitepaper herunter und sehen Sie sich das Improving checkout, delivery, and operations with Address Validation Webinar an.

Weitere Informationen:

Beitragende

Dieser Artikel wird von Google verwaltet. Die folgenden Beitragenden haben ihn ursprünglich verfasst.
Hauptautoren:

Henrik Valve | Solutions Engineer
Thomas Anglaret | Solutions Engineer
Sarthak Ganguly | Solutions Engineer