Créer votre logique de validation

Ce document décrit un processus de création d'un système de vérification d'adresse capable de gérer diverses réponses de l'API Address Validation. Vous découvrirez comment créer votre logique pour utiliser correctement la réponse, examiner d'autres signaux de l'API, et quand et comment inviter vos clients à obtenir plus d'informations.

En général, la réponse de l'API détermine la manière dont votre système doit gérer une adresse:

• handyman Corriger : l'adresse est de mauvaise qualité. Vous devriez demander plus d'informations.
• edit Confirm (Confirmer) : l'adresse est de haute qualité, mais a été modifiée par rapport à l'adresse d'entrée. Vous pouvez demander confirmation.
• check Accepter : l'adresse est de haute qualité. Vous pouvez accepter l'adresse fournie.

Objectif de la clé

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. Le pseudo-code suivant 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. Pour en savoir plus, consultez les conseils d'implémentation. Vous pouvez également utiliser notre mise en œuvre Open Source de cette logique, disponible 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 seuls signaux à vérifier, mais fournissent un indicateur initial de la qualité de l'adresse. Chaque type de comportement correspond à une section de ce document décrivant d'autres signaux que vous devrez peut-être également examiner.

Comportement de votre système
handyman Corriger l'adresse	La réponse de verdict indique qu'il manque des informations importantes qui doivent être fournies. L'adresse renvoyée par l'API Address Validation n'est peut-être pas de la bonne qualité. 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: validationGranularity définie sur OTHER. Consultez les valeurs de précision. addressComplete correspond à false.
edit Confirmer l'adresse	La réponse de verdict indique une adresse livrable, mais a modifié l'entrée d'origine: déduisant des données dont l'orthographe a été corrigée ou des données pouvant être confirmées. Workflow Corrections nécessaires : 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. Consultez les valeurs de précision. addressComplete correspond à true. Le champ hasInferredComponents est true OU le champ hasReplacedComponents est true.
check 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 correspond à true. Aucun composant inféré ou remplacé.

Instructions relatives à la mise en œuvre

Lorsque vous concevez la manière dont votre système répond aux signaux de l'API Address Validation, les recommandations suivantes peuvent vous aider à créer un modèle de réponse plus efficace. Toutefois, il ne s'agit que de recommandations. N'oubliez pas que votre implémentation doit être adaptée à votre modèle économique.

	Conseils	Détails
Niveau de risque	Tenez compte du niveau de tolérance de votre situation lorsque vous cherchez à trouver un juste équilibre entre demander des corrections et accepter l'adresse telle que vous l'avez saisie.	L'API Address Validation renvoie divers signaux que vous pouvez intégrer à votre niveau de risque pour optimiser votre processus de validation. Par exemple, si une adresse possède un numéro de rue non confirmé, vous pouvez toujours l'accepter. En revanche, si vos activités commerciales nécessitent une adresse plus précise, vous pouvez envoyer une invite à l'utilisateur. Pour obtenir un exemple pouvant appartenir à l'une ou l'autre de ces catégories, consultez la section Numéro de rue non confirmé aux États-Unis dans Accepter l'adresse – exemples.
Accepter les adresses	Il est recommandé 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 ne figure pas dans le système, par exemple pour une nouvelle construction.
Fournir des commentaires	Lorsque vous réémettez une requête de validation d'adresse, vous pouvez également envoyer 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.

Corriger une adresse

Corrigez une adresse lorsque les résultats indiquent clairement qu'elle ne peut pas être livrée. Votre système peut alors inviter le client à fournir les informations nécessaires, après quoi vous pouvez renvoyer votre workflow afin d'obtenir une adresse de livraison.

Corriger les signaux

L'API Address Validation fournit un certain nombre de signaux pour vous indiquer si une adresse doit être corrigée.

1. Précision de la validation et composants manquants

Les deux signaux ci-dessous indiquent au mieux une adresse problématique:

• Chaque fois que le champ validationGranularity est défini sur OTHER, votre système doit examiner les signaux des composants d'adresse pour savoir où l'erreur s'est produite et comment la corriger.
• Chaque fois que l'objet address post-traité renvoie un champ 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 vous aider à diagnostiquer des problèmes spécifiques:

Composants suspects	Lorsque l'énumération du niveau de confirmation d'un composant est UNCOMFIRMED_AND_SUSPICIOUS, il est probable que le composant soit incorrect.
Composant non résolu	Un 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 doit être corrigée, vous devriez voir ce qui suit:

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 résultat indique que l'API Address Validation a déduit ou apporté des modifications aux composants d'adresse afin de produire une adresse validée. Dans ce cas, vous disposez d'une adresse de livraison, mais vous préférez être plus confiant que l'adresse obtenue est celle prévue par le client.

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

Confirmer les signaux

L'API Address Validation fournit un certain nombre de signaux pour vous indiquer si une adresse doit être confirmée.

1. Précision de la validation

Une validationGranularity de ROUTE ou plus est acceptable, mais PREMISE ou SOUS-PRESSION fournissent un signal plus fort de délivrabilité.

2. Autres signaux

Lorsque vous décidez de confirmer la saisie de l'adresse avec le client, l'évaluation fournit également les éléments suivants pour déterminer les composants à examiner:

Données déduites	Lorsque le champ hasInferredComponents présente la valeur true, vous savez que l'API a rempli des informations qu'elle a collectées à partir d'autres composants d'adresse.
Données remplacées	Lorsque le champ hasReplacedComponents est défini sur true, l'API a remplacé les données saisies par celles qui semblent valides pour l'adresse.

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 auprès du 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 avec la valeur subpremise.

Confirmer des exemples d'adresses

Accepter une adresse

Vous acceptez une adresse lorsque l'évaluation indique avec un haut degré de confiance que l'adresse est livrable et qu'elle 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 pour vous indiquer si une adresse doit être confirmée.

1. Précision de la validation

Une valeur validationGranularity supérieure ou égale à 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 une adresse de haute qualité à laquelle la livraison peut être effectuée. Pour une adresse valide aux États-Unis, vous devez voir ce qui suit:

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

Exemples d'adresses acceptées