Corriger l'adresse – Exemples

Ce document décrit un certain nombre de scénarios réels dans lesquels l'API de validation d'adresses fournit des signaux de réponse qui justifient un comportement de correction de la part de votre système. Pour en savoir plus, consultez la section Présentation du workflow dans Créer votre logique de validation.

Exemples courants: fix

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 qui ne contient que l'adresse, sans ville ni code postal.

Adresse saisie Région
21 45 40th street USA

Évaluation de l'absence de ville et de code postal

L'exemple ci-dessous met en avant les signaux importants de la réponse.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Ces signaux indiquent une adresse non distribuable. 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 ne renvoie que le pays (États-Unis) sous la forme CONFIRMED. Il renvoie tous les autres composants d'adresse sous la forme UNCONFIRMED_BUT_PLAUSIBLE, avec certaines omissions importantes dans les données, telles que la localité et le code postal.

Numéro de rue manquant

Cet exemple montre un numéro de rue manquant.

Adresse saisie Région
Buckingham Palace Road, SW1W 9TQ Londres Royaume-Uni
Verdict pour le numéro de rue manquant
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

La valeur de validationGranularity est ROUTE, ce qui indique une correspondance avec la rue, mais les informations fournies ne sont pas suffisantes pour accéder au site. De plus, la propriété addressComplete est manquante dans l'évaluation. Elle est donc false. Une autre requête de l'objet address révèle un type de composant manquant:

"missingComponentTypes": [
        "street_number"
      ]

Exemples de cas particuliers : correction

Dans certains cas, vous devez corriger, confirmer ou accepter une adresse en fonction de votre situation. Les exemples ci-dessous illustrent des scénarios qui ne relèvent pas strictement d'une catégorie de correctifs.

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 il indique que l'adresse est complète.

Adresse saisie Région
84 Buckingham Palace Road, SW1W 9TQ, Londres Royaume-Uni

Évaluation du numéro de rue non confirmé

L'exemple ci-dessous met en avant les signaux importants.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete" : true,
  "hasUnconfirmedComponents": true
}

Il est intéressant d'examiner la combinaison d'une granularité de validation limitée à une approximation au niveau des sites avec des composants non confirmés. Une requête de la propriété addressComponents affiche le componentType non confirmé suivant:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Ici, l'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 dans son ensemble de données, et plausible signifie que les données du composant peuvent toujours être valides.

Sous-prémisse manquante

Ce scénario décrit une adresse à laquelle il ne manque qu'un sous-prémisse, tel qu'un numéro d'appartement ou de département. Sinon, l'API Address Validation peut valider complètement l'adresse. Comme c'est le cas lorsqu'un composant d'adresse est manquant, addressComplete est false et n'est donc pas présent lors de l'inspection manuelle du résultat.

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 omet le numéro de chambre de l'entrée.

Adresse saisie Région
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 USA

Évaluation de l'absence de sous-prémisse

Dans cet exemple, l'évaluation n'affiche pas la propriété addressComplete. Il s'agit donc de false. Vous savez donc 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"
      ]

Après enquête, les données USPS fournissent un code dpvConfirmation de D, ce qui indique également un sous-établissement manquant.