Address Validation API zum Verarbeiten von Adressen mit hohem Volumen

Ziel

Als Entwickler arbeiten Sie oft mit Datasets, die Kundenadressen enthalten, sind möglicherweise nicht qualitativ hochwertig. Sie müssen sicherstellen, dass die Adressen für von der Bestätigung der Kundennummer bis hin zur Lieferung

Die Address Validation API API ist ein Produkt von Google Maps Platform, mit der Sie eine Adresse validieren können. Es wurde jedoch nur verarbeitet eine Adresse nach der anderen. In diesem Dokument erfahren Sie, wie Sie der Adressüberprüfung mit hohem Volumen unter verschiedenen Szenarien, von API-Tests hin zur einmaligen und wiederkehrenden Adressvalidierung.

Anwendungsfälle

Jetzt werden wir die Anwendungsfälle verstehen, bei denen die Adressüberprüfung mit hohem Volumen nützlich sind.

Test

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

Einmalige Validierung von Adressen

Sie möchten bei der Einrichtung der Address Validation API Ihre mit der Nutzerdatenbank vergleichen.

Wiederkehrende Validierung von Adressen

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

• Sie haben möglicherweise geplante Jobs, um Adressen auf erfasste Details zu überprüfen im Laufe des Tages, z. B. aus Kundenanmeldungen, Bestelldetails, Lieferungen Zeitpläne.
• Sie erhalten möglicherweise Datendumps mit Adressen verschiedener Abteilungen, von Vertrieb bis Marketing. Die neue Abteilung erhält die Adressen vor der Verwendung häufig überprüfen möchten.
• Sie können Adressen im Rahmen von Umfragen oder bei verschiedenen Werbeaktionen und später erfassen zu Aktualisierungen im Onlinesystem. Sie möchten überprüfen, ob die Adressen wenn sie in das System eingegeben werden.

Technische Details

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

• Sie rufen die Address Validation API mit Adressen eines Kunden auf Datenbank (d.h. eine Datenbank mit Kundendetails)
• 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 ein wie sich einzelne Kunden anmelden.

<ph type="x-smartling-placeholder">

</ph> Jetzt testen:Rufen Sie die Google Cloud Console auf und aktivieren Sie die Address Validation API.

Cache für Produktionszwecke

Hinweis: Die spezifischen Antwortelemente, die im Folgenden beschrieben werden kann für maximal 30 aufeinanderfolgende Kalendertage gespeichert werden. Alle von Diese Antwortelemente MÜSSEN nach 30 Tagen gelöscht werden.

Bei Verwendung der Address Validation API empfiehlt es sich oft, einen Teil des Antwort des API-Aufrufs zurückgegeben. Unsere Nutzungsbedingungen Dienstlimit Welche Daten können im Cache gespeichert werden und welche Daten können von der Address Validation API im Cache gespeichert werden? muss für ein Nutzerkonto im Cache gespeichert werden. Das bedeutet, dass das Objekt in der Datenbank oder Adressmetadaten müssen mit der E-Mail-Adresse eines Nutzers oder eine andere primäre ID.

Für den Anwendungsfall „High Volume Address Validation“ muss das Daten-Caching Address Validation API dienstspezifisch Nutzungsbedingungen, wie in Abschnitt 11.3 beschrieben. Anhand dieser Informationen können Sie ermitteln, ob die E-Mail-Adresse eines Nutzers ungültig ist. In diesem Fall werden Sie Nutzer bei der nächsten Interaktion mit Ihrem .

• Daten aus AddressComponent Objekt <ph type="x-smartling-placeholder">
  </ph>
  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

Wenn Sie Informationen über die tatsächliche Adresse im Cache speichern möchten, darf nur mit Zustimmung des Nutzers im Cache gespeichert werden. So wird sichergestellt, dass die warum ein bestimmter Dienst seine Adresse speichert Adresse teilen.

Ein Beispiel für die Nutzereinwilligung ist die direkte Interaktion mit einer E-Commerce-Adresse. auf einer Zahlungsseite. Es besteht die Annahme, dass Sie die Adresse zum Zweck des Paketversands verarbeitet.

Mit Zustimmung des Nutzers kannst du formattedAddress und andere Schlüsselkomponenten im Cache speichern aus der Antwort. Im monitorlosen Szenario können Nutzende jedoch keine da die Adressbestätigung über das Back-End erfolgt. Dementsprechend wird können Sie in diesem monitorlosen Szenario nur sehr begrenzte Informationen im Cache speichern.

Antwort verstehen

Hinweis: Es gibt auch einen hilfreichen Leitfaden Ihre Validierung erstellen Logik enthalten, erklärt, wie die Antwort interpretiert wird.

Wenn die Antwort der Address Validation API die folgenden Markierungen enthält, sicher sein, dass die eingegebene Adresse eine lieferbare Qualität hat:

• Die addressComplete-Markierung im Verdikt Objekt true ist,
• Die validationGranularity im Verdikt Objekt ist PREMISE oder SUB_PREMISE
• Keine der Komponenten AddressComponent sind gekennzeichnet als: <ph type="x-smartling-placeholder">
  </ph>
  • Inferred(Hinweis: inferred=truekann auftreten, wenn addressComplete=true)
  • spellCorrected
  • replaced
  • unexpected und
• confirmationLevel: Die Bestätigungsebene auf der AddressComponent ist festgelegt auf CONFIRMEDoderUNCONFIRMED_BUT_PLAUSIBLE

Wenn die API-Antwort die oben genannten Markierungen nicht enthält, ist die Eingabeadresse wahrscheinlich von schlechter Qualität war, und Sie können die Flags in Ihrer Datenbank zwischenspeichern, Im Cache gespeicherte Markierungen weisen darauf hin, dass die Adresse insgesamt von schlechter Qualität ist, während Detailliertere Flags wie Spell Corrected geben die spezifische Art von Qualitätsproblem beheben. Bei der nächsten Kundeninteraktion mit einer gemeldeten Adresse kann die Address Validation API mit der vorhandenen Adresse. Die Address Validation API gibt die korrigierte Adresse zurück, die in einer UI-Eingabeaufforderung angezeigt werden kann. Sobald der Kunde die formatierte Adresse können Sie Folgendes aus der Antwort zwischenspeichern:

• formattedAddress
• postalAddress
• addressComponent componentNames oder
• UspsData standardizedAddress

monitorlose Adressvalidierung implementieren

Hinweis: Was ist monitorlos? Software, die auf einem Gerät ohne grafische Benutzeroberfläche, z. B. ein serverseitig oder über die Befehlszeile ausgeführtes Skript Dieser Begriff wird verwendet, um zu beschreiben, wenn die Software ohne GUI verwendet wird.

Basierend auf der obigen Diskussion:

• Häufig ist es erforderlich, einen Teil der Antwort der Adresse im Cache zu speichern Validation API aus geschäftlichen Gründen.
• Die Nutzungsbedingungen Dienst in Bei der Google Maps Platform ist eingeschränkt, welche Daten im Cache gespeichert werden können.

Im folgenden Abschnitt wird ein Prozess in zwei Schritten erläutert, die Nutzungsbedingungen einhalten und die Adressvalidierung in großem Umfang implementieren.

Schritt 1:

Im ersten Schritt erfahren Sie, wie Sie eine Adresse mit hohem Volumen implementieren. Validierungsskript einer vorhandenen Datenpipeline ausführen. So können Sie bestimmte Felder aus der Address Validation API-Antwort in einem Dienstkonform sein.

Diagramm A: Das folgende Diagramm zeigt, wie eine Datenpipeline optimiert werden kann. mit einer „High Volume Address Validation“-Logik.

Gemäß den Nutzungsbedingungen können Sie die folgenden Daten aus dem addressComponent:

• confirmationLevel
• inferred
• spellCorrected
• replaced
• unexpected

Daher speichern wir bei diesem Implementierungsschritt die oben genannten mit der UserID vergleichen.

Weitere Informationen finden Sie in den Details zu den tatsächlichen Daten Struktur.

Schritt 2:

In Schritt 1 haben wir Feedback gesammelt, dass einige Adressen im Eingabe-Dataset möglicherweise qualitativ hochwertig sind. Im nächsten Schritt werden die markierten Adressen und sie dem Nutzer vorlegen und seine Einwilligung zur Korrektur der gespeicherten Daten Adresse.

Diagramm B: Dieses Diagramm zeigt eine End-to-End-Integration des Nutzers. könnte so aussehen:

1. Prüfen Sie bei der Anmeldung des Nutzers zuerst, ob Validierungs-Flags im Cache gespeichert sind in Ihrem System.
2. Falls Flags vorhanden sind, sollten Sie dem Nutzer eine UI zur Korrektur ihre Adresse aktualisieren.
3. Sie können die Address Validation API noch einmal mit der aktualisierten oder im Cache gespeicherten Version der API aufrufen. Adresse und zeigen Sie dem Nutzer die korrigierte Adresse zur Bestätigung an.
4. Wenn die Adresse eine gute Qualität hat, gibt die Address Validation API eine formattedAddress
5. Sie können diese Adresse dem Nutzer entweder präsentieren, wenn Korrekturen vorgenommen wurden. oder sie stumm akzeptieren, wenn es keine Korrekturen gibt.
6. Sobald der Nutzer akzeptiert, können Sie das formattedAddress-Objekt in der Datenbank zwischenspeichern.

Hinweis: Nach Abschluss dieses Workflows sollte das im Cache gespeicherte validationFlags-Objekt wie folgt aussehen: gelöscht.

Fazit

Die Adressvalidierung mit hohem Volumen ist ein häufiger Anwendungsfall, in vielen Anwendungen. In diesem Dokument werden einige Szenarien Designmuster für die Implementierung einer solchen Lösung, die Google Maps entspricht Nutzungsbedingungen der Plattform.

Wir haben eine Referenzimplementierung der Adresse mit hohem Volumen Validierung als Open-Source-Bibliothek auf GitHub. Probieren Sie es aus und legen Sie los High Volume Address Validation nutzen. Weitere Informationen finden Sie im Artikel Designmustern für die Verwendung der Bibliothek in verschiedenen Szenarien.

Nächste Schritte

Laden Sie den Bericht Bezahlvorgang, Lieferung und Abläufe mit zuverlässigen Adressen verbessern Whitepaper und sehen Sie sich die Seite Bezahlvorgang, Lieferung und Abläufe mit Address verbessern Validierung Webinar.

Weitere Informationen:

• Anwendungen der Adressvalidierung für hohe Volumen
• Python-Bibliothek auf GitHub
• demo ansehen Validierung

Beitragende

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

Henrik Valve | Solutions Engineer
Thomas Anglaret | Lösungen Entwickler
Sarthak Ganguly | Lösungen Ingenieur