Validierungslogik erstellen

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:

  1. Der zu verwendende Workflow – je nach Korrektur, Bestätigung, Akzeptieren des Verhaltens.
  2. 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 verdict weist darauf hin, dass wichtige Informationen fehlen die angegeben werden müssen. Die vom Die Address Validation API ist möglicherweise nicht lieferbar.

Workflow

  1. Prüfen Sie bei Bedarf Adresskomponenten.
  2. Bitte den Kunden, die Adressprobleme zu beheben.
  3. Fordern Sie die Bestätigung der aktualisierten Adresse an.
  4. (Optional) Senden Sie eine Anfrage an den Feedback-Endpunkt der API. Siehe Umgang mit aktualisierten Adressen.
  5. Fahren Sie mit der Adresse fort.

Ergebnissignale

Es gilt eines der folgenden Kriterien:
Adresse bestätigen

Die Antwort von verdict weist auf einen Liefergegenstand hin. und hat Änderungen an der ursprünglichen Eingabe vorgenommen: Ableitung von Daten, ist entweder eine Korrektur der Rechtschreibung oder Daten, die bestätigt werden können.

Workflow

  1. Erforderliche Korrekturen: <ph type="x-smartling-placeholder">
      </ph>
    1. Prüfen Sie bei Bedarf Adresskomponenten.
    2. Fordern Sie die Bestätigung der aktualisierten Adresse an.
    3. (Optional) Senden Sie eine Anfrage an den Feedback-Endpunkt der API. Siehe Umgang mit aktualisierten Adressen.
    4. Fahren Sie mit der Adresse fort.
  2. Es sind keine Korrekturen erforderlich:
    1. (Optional) Senden Sie eine Anfrage an den Feedback-Endpunkt der API. Siehe Umgang mit aktualisierten Adressen.
    2. Fahren Sie mit der Adresse fort.

Ergebnissignale

Es gelten alle folgenden Bedingungen:

  • validationGranularity enthält ROUTE oder besser. Siehe Detaillierungsgrad Werte.
  • addressComplete ist true.
  • Das Feld „hasInferredComponents“ ist „true“ ODER Das Feld hasReplacedComponents ist true.
Adresse akzeptieren

Die Antwort der Address Validation API zeigt eine Adresse von hervorragender Qualität an.

Workflow

Mit der Rückgabeadresse fortfahren.

Ergebnissignale

Es gelten alle folgenden Bedingungen:

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 provideValidationFeedback.

So erfährt Google, wie Sie mit der endgültigen Antwort umgegangen sind. Siehe Umgang mit aktualisierten Adressen.
<ph type="x-smartling-placeholder">

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 auf OTHER 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 eine missingComponentTypes 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

Adressbeispiele korrigieren

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 dpvConfirmation findest du unter Umgang mit US-Adressen
Adressantwort Enthält das Feld missingComponentType mit dem Wert von subpremise.

Adressbeispiele bestätigen

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 dpvConfirmation findest du unter Umgang mit US-Adressen

Adressbeispiele akzeptieren

Zurück
Grundlegende Antwort verstehen