Créer votre logique de validation

Ce document décrit un processus de création d'un système de vérification d'adresse pour traiter diverses réponses de l'API Address Validation. Il explique comment créer votre logique pour utiliser correctement la réponse et étudier d'autres signaux de l'API, et quand et comment inviter vos clients à fournir des informations supplémentaires.

En général, la réponse de l'API détermine les actions suivantes pour votre système gérer une adresse:

• Corriger : l'adresse est de mauvaise qualité. Vous devriez demander plus d'informations.
• Confirmer : l'adresse est de bonne qualité, de l'adresse d'entrée. Vous pourriez demander à confirmation.
• Accept (Accepter) : l'adresse est de haute qualité. Vous pouvez acceptez l'adresse indiquée.

Objectif principal

Ce document vous aide à modifier votre système pour analyser au mieux la réponse de l'API et déterminer les prochaines actions à effectuer avec les adresses fournies. Les éléments suivants : le pseudo-code illustre un flux possible.

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.

La logique exacte dépend de votre situation. Consultez le guide d'implémentation. pour en savoir plus. Vous pouvez également utiliser notre implémentation open source de cette logique, qui se trouve dans la bibliothèque de composants étendus.

Présentation du workflow

Le tableau ci-dessous récapitule deux actions pour votre système:

1. Workflow à utiliser en fonction du comportement de la correction, de la confirmation et de l'acceptation.
2. Les premiers signaux à vérifier de la réponse. Les signaux décrits ici proviennent de la propriété verdict et ne sont pas les seules des signaux à vérifier, mais fournissez un indicateur initial de l'adresse qualité. Chaque type de comportement correspond à une section de ce document en décrivant d'autres signaux que vous devrez peut-être examiner.

Comportement de votre système
Corriger l'adresse	La réponse de verdict indique des éléments manquants importants les informations qui doivent être fournies. L'adresse renvoyée par Il est possible que l'API Address Validation ne soit pas de qualité livrable. Workflow Examinez les composants d'adresse si nécessaire. Invitez le client à résoudre les problèmes d'adresse. Demandez la validation de l'adresse mise à jour. (Facultatif) Envoyez une requête au point de terminaison feedback pour l'API. Consultez Gérer les adresses mises à jour. Procédez à l'adresse. Signaux d'évaluation N'importe laquelle des conditions suivantes s'applique: La valeur de validationGranularity est OTHER. Voir la précision valeurs. addressComplete est false.
Confirmer l'adresse	La réponse de verdict indique un produit livrable mais a modifié l'entrée d'origine: déduire les données qui soit l'orthographe est corrigée, soit les données peuvent être confirmées. Workflow Corrections nécessaires: <ph type="x-smartling-placeholder"> </ph> Examinez les composants d'adresse si nécessaire. Demandez la validation de l'adresse mise à jour. (Facultatif) Envoyez une requête au point de terminaison feedback pour l'API. Consultez Gérer les adresses mises à jour. Procédez à l'adresse. Aucune correction nécessaire: (Facultatif) Envoyez une requête au point de terminaison feedback pour l'API. Consultez Gérer les adresses mises à jour. Procédez à l'adresse. Signaux d'évaluation Toutes les conditions suivantes s'appliquent: validationGranularity contient ROUTE ou mieux. Voir la précision valeurs. addressComplete est true. Champ hasInferredComponents : true OU Le champ hasReplacedComponents est défini sur true.
Accepter l'adresse	La réponse de l'API Address Validation indique une excellente qualité d'adresse. Workflow Saisissez l'adresse renvoyée. Signaux d'évaluation Toutes les conditions suivantes s'appliquent: validationGranularity contient PREMISE ou mieux. Consultez les valeurs de précision. addressComplete est true. Aucun composant inféré ou remplacé.

Instructions relatives à la mise en œuvre

Lors de la conception de la façon dont votre système répond aux signaux de l'API Address Validation, les recommandations suivantes peuvent vous aider à élaborer une réponse plus efficace dans un modèle de ML. Toutefois, il ne s'agit que de recommandations. N'oubliez pas que doit être adaptée à votre modèle économique.

	Conseils	Détails
Niveau de risque	Tenez compte du niveau de tolérance à votre situation lorsque vous cherchez à corrections et accepter l'adresse telle qu'elle a été saisie.	L'API Address Validation renvoie divers signaux que vous pouvez intégrer à votre niveau de risque pour optimiser votre validation processus. Par exemple, si le numéro de rue d'une adresse n'est pas confirmé, vous pouvez il est toujours possible de l'accepter. D'un autre côté, si vos activités commerciales nécessitent une plus grande précision d'adresse, vous pourriez inviter votre utilisateur. Par exemple, peuvent appartenir à l'une ou l'autre de ces catégories, consultez la section Numéro de rue non confirmé aux États-Unis dans la section Accepter l'adresse – exemples.
Accepter les adresses	Nous vous recommandons d'autoriser votre système à accepter l'entrée d'origine si le client ne répond pas aux invites.	Dans ce cas, le client peut avoir saisi une adresse qui n'est pas dans le système, par exemple pour les nouvelles constructions.
Envoyer des commentaires	Lorsque vous envoyez une nouvelle demande de validation d'adresse, vous pouvez envoie également une requête au point de terminaison provideValidationFeedback.	Google saura ainsi comment vous avez géré la réponse finale. Consultez Gérer les adresses mises à jour.

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

</ph> Essayez la démo. Le reste de ce document utilise plusieurs exemples pour vous aider à comprendre la correction, confirmer et accepter le processus décrit ci-dessus. Vous pouvez explorer les résultats de ces exemples en les saisissant dans les Démonstration de l'API Address Validation

Corriger une adresse

Corriger une adresse lorsque les résultats indiquent clairement qu'elle n'est pas les produits livrables. Votre système peut alors inviter le client à fournir les informations des informations, après quoi vous relancez votre flux de travail afin d'obtenir un produit livrable adresse e-mail.

Remarque :Lorsque vous envoyez des requêtes à l'API Address Validation pour la même adresse, vous pouvez appeler provideValidationFeedback pour indiquer le résultat. Voir Gérer les adresses aux États-Unis

Corriger les signaux

L'API Address Validation fournit un certain nombre de signaux qui vous permettent de savoir si un doit être corrigée.

1. Précision de la validation et composants manquants

Les deux signaux ci-dessous sont le meilleur indicateur d'une adresse problématique:

• Chaque fois que le champ validationGranularity est OTHER, votre système doit Examinez les signaux des composants d'adresse pour savoir où se trouve l'erreur et comment y remédier.
• Chaque fois que l'objet address post-traité renvoie une missingComponentTypes, votre système doit rechercher ce composant. Les composants manquants rendent également une adresse incomplète et impossible à livrer.

2. Autres signaux

L'API Address Validation fournit également d'autres signaux pour aider diagnostiquer des problèmes spécifiques:

Composants suspects	Lorsque l'énumération du niveau de confirmation pour un composant est UNCOMFIRMED_AND_SUSPICIOUS, il est probable que le composant incorrecte.
Composant non résolu	unresolvedToken est une partie de l'entrée non reconnue comme une partie valide d'une adresse.

3. Signaux d'adresse aux États-Unis

Certains champs applicables uniquement aux adresses aux États-Unis fournissent un signal utile indiquant que l'adresse n'est pas livrable et doit être corrigée. Pour une adresse qui nécessite vous devriez obtenir le résultat suivant:

dpvConfirmation	N, D ou vide.

Pour en savoir plus sur dpvConfirmation, consultez Gérer les adresses aux États-Unis

Exemples d'adresses de dépannage

Confirmer une adresse

Vous confirmez une adresse lorsque le verdict indique que l'API Address Validation inféré ou modifié des composants d'adresse afin de produire d'adresse e-mail validée. Dans ce cas, vous avez une adresse de livraison, mais préférez davantage de confiance quant au fait que l'adresse qui en résulte est celle prévue par le client.

Pour fournir au client la requête correcte, votre logique doit identifier les composants signalés par le service pour déterminer quelle action appliquée au composant, comme inferred, replaced ou spellCorrected. Consultez la section AddressComponent dans la documentation de référence.

Remarque :Tenez compte de votre niveau de risque lorsque vous décidez pour confirmer l'adresse avec le client ou l'accepter comme valide. En outre, si vous envoyez de nouveau des requêtes à l'API Address Validation, vous pouvez effectuer un appel à provideValidationFeedback pour indiquer le résultat. Voir Identifiant mis à jour adresses e-mail.

Confirmer les signaux

L'API Address Validation fournit un certain nombre de signaux qui vous permettent de savoir si un doit être confirmée.

1. Précision de la validation

Une valeur validationGranularity égale ou supérieure à ROUTE est acceptable, mais : L'emplacement PREMISE ou SOUS-SITE fournit un signal plus fort de délivrabilité.

2. Autres signaux

Au moment de décider de confirmer la saisie de l'adresse avec le client, le verdict fournit les éléments suivants pour déterminer les composants à examiner:

Données déduites	Lorsque le champ hasInferredComponents est défini sur true, vous savez que l'API a rempli des informations qu'elle a recueillies à partir d'autres adresses composants.
Données remplacées	Lorsque la valeur du champ hasReplacedComponents est true, la L'API a remplacé les données saisies par celles qui jugeaient que l'adresse était valide.

3. Signaux d'adresse aux États-Unis

Certains champs applicables uniquement aux adresses aux États-Unis indiquent que votre logique doit confirmer les détails avec le client. L'une des situations suivantes s'applique:

dpvConfirmation	S Pour en savoir plus sur dpvConfirmation, consultez Gérer les adresses aux États-Unis
Réponse d'adresse	Contient un champ missingComponentType dont la valeur est : subpremise Remarque: Si le champ contient des types autre que subpremise, l'action tombe dans le la catégorie d'adresse. Consultez la liste complète des adresses. dans la documentation sur Geocoding.

Confirmer des exemples d'adresses

Accepter une adresse

Vous acceptez une adresse lorsque le verdict fournit un niveau de confiance élevé que l'adresse peut être livrée et peut être utilisée sans autre interaction avec le client. dans le processus en aval.

Accepter les signaux

L'API Address Validation fournit un certain nombre de signaux qui vous permettent de savoir si un doit être confirmée.

1. Précision de la validation

Une valeur validationGranularity égale ou supérieure à PREMISE est acceptable, mais dans certains cas, ROUTE indique toujours une adresse de livraison.

2. Autres signaux

Le verdict concernant une adresse de haute qualité doit également fournir les éléments suivants:

• Aucune donnée remplacée : Dans le cas présent : hasReplacedComponents: FALSE.
• Aucun composant inféré. Dans le cas présent : hasInferredComponents: FALSE.

3. Signaux d'adresse aux États-Unis

Certains champs applicables uniquement aux adresses aux États-Unis indiquent que l'adresse est de bonne qualité. qui peuvent être livrés. Pour une adresse valide aux États-Unis, vous devez consulter le suivantes:

dpvConfirmation	Y Pour en savoir plus sur dpvConfirmation, consultez Gérer les adresses aux États-Unis

Exemples d'adresses acceptées