Corriger l'adresse – Exemples

Ce document décrit plusieurs scénarios concrets dans lesquels l'API Address Validation fournit des signaux de réponse qui justifient un comportement de correction de la part de votre système. Les exemples présentés ici sont illustratifs, mais non exhaustifs. Pour plus de contexte, consultez la section Présentation du workflow dans Créer votre logique de validation.

Exemples courants : correction

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 comportant que l'adresse de la rue, sans ville ni code postal.

Adresse saisie Région
21 45 40th street USA

Verdict pour la ville et le code postal manquants

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

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

Ces signaux indiquent une adresse à laquelle la livraison est impossible. 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) en tant que CONFIRMED. Elle renvoie tous les autres composants d'adresse en tant que UNCONFIRMED_BUT_PLAUSIBLE, avec des 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 London Royaume-Uni
Verdict pour le numéro de rue manquant
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity est ROUTE, ce qui indique une correspondance avec la rue, mais pas suffisamment d'informations pour accéder au bâtiment. De plus, la propriété addressComplete est manquante dans le verdict et 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 limites : correction

Dans certaines situations, le fait de corriger, de confirmer ou d'accepter une adresse dépend de votre scénario commercial particulier. Les exemples ci-dessous illustrent des scénarios qui ne correspondent pas 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 indique que l'adresse est complète.

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

Verdict pour le numéro de rue non confirmé

L'exemple ci-dessous met en évidence 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 uniquement pour l'approximation au niveau du bâtiment et 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, le confirmation_level de street_number est défini sur UNCONFIRMED_BUT_PLAUSIBLE. Non confirmé signifie que le service ne peut pas faire correspondre le 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-bâtiment manquant

Ce scénario décrit une adresse à laquelle il ne manque qu'un sous-bâtiment, tel qu'un numéro d'appartement ou de service. 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 verdict.

Supposons, par exemple, qu'un client saisisse une adresse valide pour le bureau d'évaluation de la ville de San Francisco, mais qu'il oublie le numéro de la pièce dans l'entrée.

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

Verdict pour le sous-bâtiment manquant

Dans cet exemple, le verdict n'affiche pas la propriété addressComplete. Elle est donc false. Par conséquent, 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"
      ]

Après une enquête plus approfondie, les données USPS fournissent un code dpvConfirmation de D, ce qui indique également un sous-bâtiment manquant.