In diesem Dokument wird ein Prozess zur Erstellung eines Adressprüfsystems beschrieben, verschiedene Antworten der Address Validation API zu verarbeiten. Sie erfahren, wie Sie Erstellen Sie Ihre Logik, um die Antwort richtig zu verwenden und andere Signale zu untersuchen. von der API erhalten und wann und wie Sie Ihre Kunden um weitere Informationen bitten können.
Im Allgemeinen bestimmt die API-Antwort, wie Ihr System eine Adresse zu verarbeiten:
- Problem: Die Adresse hat eine niedrige Qualität. Sie sollten nach weiteren Informationen fragen.
- Bestätigen: Die Adresse ist hochwertig, hat aber die sich von der Eingabeadresse ändern. Sie können bestätigen.
- Akzeptieren: Die Adresse ist hochwertig. Sie können angegebene Adresse akzeptieren.
Schlüsselzweck
Dieses Dokument hilft Ihnen dabei, Ihr System so anzupassen, dass Sie die API-Antwort und die nächsten Aktionen festlegen, die mit den angegebenen Adressen ausgeführt werden sollen. Die folgenden Pseudocode veranschaulicht einen möglichen Ablauf.
if (the API response indicates significant problems in the address)
FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
CONFIRM - confirm with the user that the address is correct
else
ACCEPT - continue with the address returned by the API.
Die genaue Logik hängt von Ihrer Situation ab. Weitere Informationen finden Sie im Implementierungsleitfaden. . Sie können auch unsere Open-Source-Implementierung dieser Logik verwenden, Sie finden sie in der erweiterten Komponentenbibliothek.
Workflowübersicht
In der folgenden Tabelle werden zwei Aktionen für Ihr System zusammengefasst:
- Der zu verwendende Workflow – je nach Korrektur, Bestätigung, Akzeptieren des Verhaltens.
- Die ersten Signale, die in der Antwort geprüft werden sollen. Die Signale
hier beschrieben, stammen aus der
verdict
-Eigenschaft und sind nicht die einzigen Signale, nach denen gesucht werden soll, aber geben Sie einen ersten Indikator für die Adresse an. die Qualität zu verbessern. Jeder Verhaltenstyp entspricht einem Abschnitt in diesem Dokument und beschreiben weitere Signale, die Sie möglicherweise ebenfalls untersuchen müssen.
Das Verhalten Ihres Systems | |||
---|---|---|---|
Adresse korrigieren |
Die Antwort von
|
||
Adresse bestätigen |
Die Antwort von
|
||
Adresse akzeptieren |
Die Antwort der Address Validation API zeigt eine Adresse von hervorragender Qualität an.
|
Implementierungsleitfaden
Wenn Sie festlegen, wie Ihr System auf Signale der Address Validation API reagiert, die folgenden Empfehlungen können Ihnen helfen, eine effektivere Reaktion modellieren. Hierbei handelt es sich jedoch nur um Empfehlungen. Implementierung am besten zu Ihrem Geschäftsmodell passen.
Anleitung | Details | |
---|---|---|
Risikostufe |
Berücksichtigen Sie die Ebene wenn Sie ein Gleichgewicht zwischen der Aufforderung zur korrigieren und die eingegebene Adresse akzeptieren. |
Die Address Validation API gibt eine Vielzahl von Signalen zurück die Sie in Ihr Risikoniveau einbeziehen können, um Ihre Validierung . Wenn eine Adresse beispielsweise eine nicht bestätigte Hausnummer hat, können Sie akzeptieren. Sind für Ihre Geschäftstätigkeiten andererseits Wenn die Adressgenauigkeit höher ist, wird der Nutzer möglicherweise aufgefordert, eine Aufforderung zu senden. Ein Beispiel, bei dem in beide Kategorien fallen, siehe Nicht bestätigte Hausnummer in den USA unter Adresse akzeptieren – Beispiele. |
Adressen akzeptieren |
Es empfiehlt sich, dem System die Annahme des ursprünglichen Eintrags zu erlauben wenn der Kunde nicht auf Aufforderungen reagiert. |
In diesen Fällen kann es sein, dass der Kunde eine Adresse eingegeben hat, die nicht in z. B. bei Neubauten. |
Feedback geben |
Wenn Sie eine neue Anfrage zur Adressüberprüfung senden, haben Sie folgende Möglichkeiten:
sendet auch eine Anfrage an den Endpunkt |
So erfährt Google, wie Sie mit der endgültigen Antwort umgegangen sind. Siehe Umgang mit aktualisierten Adressen. |
Adresse korrigieren
Korrigieren Sie eine Adresse, wenn die Ergebnisse eindeutig darauf hinweisen, dass die Adresse nicht Liefergegenstand. Ihr System kann den Kunden dann auffordern, Anschließend stellen Sie Ihren Workflow erneut aus, um einen Liefergegenstand Adresse.
Signale korrigieren
Die Address Validation API bietet eine Reihe von Signalen, über die Sie informiert werden, muss korrigiert werden.
1. Detaillierungsgrad der Validierung und fehlende Komponenten
Diese beiden Signale liefern den besten Hinweis auf eine problematische Adresse:
- Wenn das Feld
validationGranularity
aufOTHER
steht, Untersuchen Sie die Signale der Adresskomponente, um zu erfahren, wo der Fehler und wie Sie es beheben können. - Immer wenn das nachbearbeitete
address
-Objekt einemissingComponentTypes
eingeben, sollte Ihr System nach dieser Komponente suchen. Fehlende Komponenten führen außerdem dazu, dass eine Adresse unvollständig und nicht zustellbar ist.
2. Sonstige Signale
Die Address Validation API liefert auch weitere Signale, bestimmte Probleme zu diagnostizieren:
Verdächtige Komponenten | Wenn die Aufzählung der Bestätigungsebene für eine Komponente
UNCOMFIRMED_AND_SUSPICIOUS ist es wahrscheinlich, dass die Komponente
falsch.
|
---|---|
Nicht aufgelöste Komponente | Ein unresolvedToken ist Teil einer Eingabe, die nicht als gültiger Teil einer Adresse erkannt wird. |
3. US-Adresssignale
Bestimmte Felder, die nur für US-Adressen gelten, sind ein hilfreiches Signal dafür, Adresse nicht lieferbar und muss korrigiert werden. Für eine Adresse, die sollten Sie Folgendes sehen:
dpvConfirmation
|
Entweder N , D oder leer.
|
---|
Weitere Informationen zu dpvConfirmation
findest du unter
Umgang mit US-Adressen
Adresse bestätigen
Sie bestätigen eine Adresse, wenn das Ergebnis anzeigt, dass die Address Validation API abgeleiteten oder Änderungen an Komponenten vorgenommen haben, um überprüfte Adresse. In diesen Fällen haben Sie eine Lieferadresse, können Sie sich darauf verlassen, dass die ausgegebene Adresse die vom Kunden.
Um der Kundschaft die richtige Aufforderung zu liefern, würde Ihre Logik Folgendes identifizieren:
Die vom Dienst gekennzeichneten Komponenten, um zu bestimmen, welche Aktion oder welche API
auf die Komponente angewendet, z. B. inferred
, replaced
oder spellCorrected
.
Weitere Informationen finden Sie in der Referenz unter AddressComponent.
Signale bestätigen
Die Address Validation API bietet eine Reihe von Signalen, über die Sie informiert werden, muss bestätigt werden.
1. Detaillierungsgrad der Validierung
Ein validationGranularity
von ROUTE
oder höher ist akzeptabel, aber entweder
PREMISE oder SUBPREMISE bieten ein stärkeres Signal für die Lieferbarkeit.
2. Sonstige Signale
Bei der Entscheidung, die Adresseingabe dem Kunden zu bestätigen, stellt Folgendes zur Verfügung, um die zu untersuchenden Komponenten zu bestimmen:
Abgeleitete Daten | Wenn das Feld hasInferredComponents den Wert true hat,
Sie wissen, dass die API Informationen
von anderen Adressen eingegeben hat,
Komponenten.
|
---|---|
Ersetzte Daten | Wenn das Feld hasReplacedComponents den Wert true hat, gibt das Feld
Das API hat die eingegebenen Daten durch Daten ersetzt, die die Adresse für gültig halten.
|
3. US-Adresssignale
Bestimmte Felder, die nur für US-Adressen gelten, geben an, dass Ihre Logik mit der Kundin oder dem Kunden bestätigen. Es gibt folgende Möglichkeiten:
dpvConfirmation
|
S
Weitere Informationen zu |
---|---|
Adressantwort | Enthält das Feld missingComponentType mit dem Wert von
subpremise .
|
Adresse akzeptieren
Sie akzeptieren eine Adresse, wenn das Ergebnis ein hohes Maß an Sicherheit zeigt, das die Adresse lieferbar ist und ohne weitere Kundeninteraktion verwendet werden kann. im nachgelagerten Prozess.
Signale akzeptieren
Die Address Validation API bietet eine Reihe von Signalen, über die Sie informiert werden, muss bestätigt werden.
1. Detaillierungsgrad der Validierung
Ein validationGranularity
von PREMISE
oder höher ist akzeptabel, aber in einigen
Fällen wird mit ROUTE
immer noch eine Adresse für den Liefergegenstand angegeben.
2. Sonstige Signale
Ein Ergebnis für eine qualitativ hochwertige Adresse sollte auch Folgendes enthalten:
- Keine ersetzten Daten: In diesem Fall
hasReplacedComponents: FALSE
. - Keine abgeleiteten Komponenten. In diesem Fall
hasInferredComponents: FALSE
.
3. US-Adresssignale
Bestimmte Felder, die nur für Adressen in den USA gelten, geben eine hochwertige Adresse an. die ausgeliefert werden können. Für eine zulässige Adresse in den USA wird die Folgendes:
dpvConfirmation
|
Y
Weitere Informationen zu |
---|