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 dafür sorgen, dass die Adressen für Anwendungsfälle wie Bestätigung der Kundennummer oder Lieferung korrekt sind.

Die Address Validation API ist ein Produkt der Google Maps Platform, mit dem Sie eine Adresse validieren können. Allerdings wird jeweils nur eine Adresse verarbeitet. In diesem Dokument erfahren Sie, wie Sie die Adressüberprüfung in großem Umfang in verschiedenen Szenarien verwenden, vom API-Test bis hin zur einmaligen und wiederkehrenden Adressvalidierung.

Anwendungsfälle

Jetzt werden Sie die Anwendungsfälle verstehen, in denen die Adressüberprüfung mit hohem Volumen nützlich ist.

Testen

Sie möchten die Address Validation API oft mit Tausenden von Adressen testen. Möglicherweise haben Sie die Adressen in einer Datei mit kommagetrennten Werten und möchten die Qualität der Adressen überprüfen.

Einmalige Validierung von Adressen

Sie möchten bei der Einrichtung der Address Validation API die vorhandene Adressdatenbank mit der Nutzerdatenbank vergleichen.

Wiederkehrende Validierung von Adressen

Eine Reihe von Szenarien erfordert eine regelmäßige Überprüfung von Adressen:

  • Sie haben möglicherweise Jobs geplant, um Adressen auf Details zu validieren, die während des Tages erfasst wurden, z. B. aus Kundenregistrierungen, Auftragsdetails oder Lieferplänen.
  • Möglicherweise erhalten Sie Datendumps mit Adressen aus verschiedenen Abteilungen, z. B. vom Vertrieb bis zum Marketing. Die neue Abteilung, die die Adressen erhält, möchte diese häufig vor der Verwendung validieren.
  • Sie können Adressen im Rahmen von Umfragen oder bei verschiedenen Werbeaktionen und später bei Aktualisierungen im Onlinesystem erfassen. Sie möchten überprüfen, ob die Adressen korrekt sind, während Sie sie in das System eingeben.

Technische Details

Für die Zwecke dieses Dokuments gehen wir von Folgendem aus:

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

Cache für Produktionszwecke

Wenn Sie die Address Validation API verwenden, sollten Sie oft einen Teil der Antwort des API-Aufrufs im Cache speichern. Während unsere Nutzungsbedingungen beschränken, welche Daten im Cache gespeichert werden können, müssen alle Daten, die über die Address Validation API im Cache gespeichert werden können, in einem Nutzerkonto zwischengespeichert werden. Das bedeutet, dass die Adress- oder 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 „High Volume Address Validation“ muss das Daten-Caching den dienstspezifischen Nutzungsbedingungen der Address Validation API entsprechen, die in Abschnitt 11.3 erläutert werden. Anhand dieser Informationen können Sie feststellen, ob die Adresse eines Nutzers ungültig ist. In diesem Fall werden Sie den Nutzer bei der nächsten Interaktion mit Ihrer Anwendung zur Eingabe einer korrigierten Adresse auffordern.

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

Wenn Sie Informationen zur tatsächlichen Adresse im Cache speichern möchten, dürfen diese Daten nur mit Zustimmung des Nutzers im Cache gespeichert werden. Dadurch wird sichergestellt, dass der Nutzer gut darüber informiert ist, 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 Nutzereinwilligung ist die direkte Interaktion mit einem E-Commerce-Adressformular auf einer Zahlungsseite. Es besteht Verständnis dafür, dass Sie die Adresse zum Zweck des Paketversands im Cache speichern und verarbeiten.

Mit Zustimmung des Nutzers kannst du formattedAddress und andere Schlüsselkomponenten aus der Antwort im Cache speichern. In einem monitorlosen Szenario kann ein Nutzer jedoch keine Einwilligung erteilen, da die Adressprüfung über das Back-End erfolgt. Daher können Sie in diesem monitorlosen Szenario nur sehr begrenzte Informationen im Cache speichern.

Antwort verstehen

Wenn die Address Validation API-Antwort die folgenden Markierungen enthält, können Sie sicher sein, dass die Eingabeadresse von der Qualität der Liefergegenstände ist:

  • Die Markierung addressComplete im Objekt Verdict ist true.
  • Die validationGranularity im Objekt Verdict ist PREMISE oder SUB_PREMISE.
  • Keine der AddressComponent ist so gekennzeichnet:
    • Inferred(Hinweis: inferred=truekann auftreten, wenn addressComplete=true)
    • spellCorrected
    • replaced
    • unexpected und
  • confirmationLevel: Die Bestätigungsebene für AddressComponent ist auf CONFIRMED oder UNCONFIRMED_BUT_PLAUSIBLE festgelegt.

Wenn die API-Antwort die oben genannten Markierungen nicht enthält, war die Eingabeadresse wahrscheinlich von schlechter Qualität. Sie können die Flags in Ihrer Datenbank im Cache speichern, um dies widerzuspiegeln. Im Cache gespeicherte Flags geben an, dass die Adresse als Ganzes eine schlechte Qualität hat. Detailliertere Flags wie „Spell Corrected“ geben hingegen an, um welche Art von Problem mit der Adressqualität es sich handelt. Bei der nächsten Kundeninteraktion mit einer Adresse, die als schlechte Qualität gekennzeichnet wurde, können Sie die Address Validation API mit der vorhandenen Adresse aufrufen. Die Address Validation API gibt die korrigierte Adresse zurück, die du über eine UI-Eingabeaufforderung anzeigen kannst. Sobald der Kunde die formatierte Adresse akzeptiert, können Sie Folgendes aus der Antwort im Cache speichern:

  • formattedAddress
  • postalAddress
  • addressComponent componentNames oder
  • UspsData standardizedAddress

Monitorlose 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.
  • In den Nutzungsbedingungen für die Google Maps Platform wird jedoch eingeschränkt, welche Daten im Cache gespeichert werden können.

Im folgenden Abschnitt wird ein Prozess in zwei Schritten beschrieben, mit dem Sie die Nutzungsbedingungen einhalten und eine Adressvalidierung mit hohem Volumen implementieren können.

Schritt 1:

Im ersten Schritt erfahren Sie, wie Sie aus einer vorhandenen Datenpipeline ein Skript zur Adressvalidierung mit großem Umfang implementieren. Dadurch können Sie bestimmte Felder aus der Antwort der Address Validation API so speichern, dass sie den Nutzungsbedingungen entspricht.

Diagramm A:Das folgende Diagramm zeigt, wie eine Datenpipeline mit einer Logik zur Adressvalidierung in großem Umfang erweitert werden kann.

alt_text

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

  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

Daher speichern wir bei diesem Implementierungsschritt die oben genannten Felder für die UserID im Cache.

Weitere Informationen finden Sie in den Details zur tatsächlichen Datenstruktur.

Schritt 2:

In Schritt 1 haben wir Feedback eingeholt, dass einige Adressen im Eingabe-Dataset möglicherweise nicht von hoher Qualität sind. Im nächsten Schritt präsentieren wir diese markierten Adressen dem Nutzer und holen seine Einwilligung zur Korrektur der gespeicherten Adresse ein.

Diagramm B: Dieses Diagramm zeigt, wie eine End-to-End-Integration des Ablaufs der Nutzereinwilligung aussehen könnte:

alt_text

  1. Prüfen Sie bei der Anmeldung des Nutzers zuerst, ob in Ihrem System Validierungs-Flags im Cache gespeichert sind.
  2. Wenn Flags vorhanden sind, sollten Sie dem Nutzer eine UI anzeigen, über die 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 vorlegen.
  4. Wenn die Adresse eine gute Qualität hat, gibt die Address Validation API eine formattedAddress zurück.
  5. Sie können diese Adresse entweder dem Nutzer anzeigen, wenn Korrekturen vorgenommen wurden, oder die Adresse stillschweigend akzeptieren, wenn es keine Korrekturen gibt.
  6. Sobald der Nutzer akzeptiert, können Sie das formattedAddress-Objekt in der Datenbank zwischenspeichern.

Fazit

Die High-Volume-Adressvalidierung ist ein häufiger Anwendungsfall, den Sie wahrscheinlich in vielen Anwendungen begegnen werden. In diesem Dokument werden einige Szenarien und ein Designmuster für die Implementierung einer solchen Lösung gemäß den Nutzungsbedingungen der Google Maps Platform veranschaulicht.

Auf GitHub haben wir eine Referenzimplementierung von High Volume Address Validation als Open-Source-Bibliothek veröffentlicht. Sehen Sie sich das Tool an, um schnell mit der Adressvalidierung mit hohem Volumen zu beginnen. Sehen Sie sich auch den Artikel zu Designmustern für die Verwendung der Bibliothek in verschiedenen Szenarien an.

Nächste Schritte

Laden Sie das Whitepaper Bezahl, Zustellung und Abläufe mit zuverlässigen Adressen verbessern herunter und sehen Sie sich das Webinar Bezahlvorgang, Bereitstellung und Abläufe mit Address Validation verbessern an.

Weitere Informationen:

Beitragende

Google verwaltet diesen Artikel. Er wurde von den folgenden Beitragenden verfasst.
Hauptautoren:

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