Ce document décrit un certain nombre de scénarios concrets dans lesquels l'API Address Validation fournit des signaux de réponse qui justifient un comportement de fix de votre système. Consultez la section Présentation du workflow dans Créer votre logique de validation pour en savoir plus.
Exemples courants: corriger
Cette section décrit des exemples courants dans lesquels l'API Address Validation fournit des signaux de réponse indiquant des informations d'adresse de qualité inférieure.
Ville et code postal manquants
Cet exemple illustre une entrée ne contenant que l'adresse postale, sans ville ni code postal.
| Adresse saisie | Région |
|---|---|
| 21 45 40th Street | États-Unis |
Verdict de la ville et du code postal manquants
L'exemple ci-dessous met l'accent sur les signaux importants de la réponse.
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true
}
Ces signaux indiquent une adresse pour la livraison. Vous pouvez donc interroger addressComponents pour en savoir plus:
{
"componentName": {
"text": "21",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "45 40th street",
"languageCode": "en"
},
"componentType": "route",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "United States",
"languageCode": "en"
},
"componentType": "country",
"confirmationLevel": "CONFIRMED"
}
L'API Address Validation renvoie uniquement le pays (États-Unis) au format CONFIRMED.
Tous les autres composants d'adresse sont renvoyés sous la forme UNCONFIRMED_BUT_PLAUSIBLE, avec des omissions importantes dans les données, telles que la localité et le code postal.
Numéro de rue manquant
Dans cet exemple, le numéro de rue est manquant.
| Adresse saisie | Région |
|---|---|
| Buckingham Palace Road, SW1W 9TQ, Londres | Royaume-Uni |
Verdict pour l'absence d'un numéro de rue
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE"
}
La valeur validationGranularity est ROUTE, ce qui indique une correspondance avec la rue, mais pas assez d'informations pour accéder au bâtiment. De plus, la propriété addressComplete ne figure pas dans le verdict. Il s'agit donc de false. Une autre requête de l'objet address révèle qu'un type de composant est manquant:
"missingComponentTypes": [
"street_number"
]
Exemples de cas particuliers: corriger
Dans certaines situations, la correction, la confirmation ou l'acceptation d'une adresse dépendent de votre scénario commercial spécifique. Les exemples ci-dessous illustrent des scénarios qui peuvent ne pas correspondre strictement à une catégorie de correction.
Numéro de rue non confirmé
Dans ce scénario, l'API Address Validation ne peut pas confirmer le numéro de rue fourni, mais elle indique que l'adresse est complète.
| Adresse saisie | Région |
|---|---|
| 84 Buckingham Palace Road, SW1W 9TQ, Londres | Royaume-Uni |
Verdict pour un numéro de rue non confirmé
L'exemple ci-dessous met l'accent sur les signaux importants.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete" : true,
"hasUnconfirmedComponents": true
}
Il est utile d'étudier la combinaison de la précision de validation uniquement avec l'approximation au niveau du site et des composants non confirmés. Une requête de la propriété addressComponents affiche l'élément componentType non confirmé suivant:
{
"componentName": {
"text": "84",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Ici, le confirmation_level de street_number est défini sur UNCONFIRMED_BUT_PLAUSIBLE. Non confirmé signifie que le service ne peut pas correspondre au numéro de rue 84 de son ensemble de données, et plausible signifie que les données de composant peuvent toujours être valides.
Sous-lieu manquant
Ce scénario décrit une adresse qui ne comporte qu'un élément secondaire, tel qu'un numéro d'appartement ou de service. Sinon, l'API Address Validation peut valider entièrement l'adresse. Comme dans le cas où un composant d'adresse est manquant, addressComplete est false et ne figure donc pas lors de l'inspection manuelle de l'évaluation.
Par exemple, supposons qu'un client saisisse une adresse valide pour le bureau de l'évaluateur de la ville de San Francisco, mais qu'il manque le numéro de la chambre.
| Adresse saisie | Région |
|---|---|
| 1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102, États-Unis | États-Unis |
Le verdict pour l'absence d'un élément secondaire
Dans cet exemple, le verdict n'affiche pas la propriété addressComplete. Il s'agit donc de false. Pour cette raison, vous savez qu'au moins un élément d'adresse est inattendu, non résolu ou manquant.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
Une requête address révèle les éléments suivants:
"missingComponentTypes": [
"subpremise"
]
À la suite d'un examen approfondi, les données d'USPS fournissent un code dpvConfirmation de D, ce qui indique également qu'il manque un élément secondaire.