Confirmer l'adresse - exemples

Ce document décrit un certain nombre de scénarios réels dans lesquels l'API Address Validation fournit des signaux de réponse pour les adresses qui justifient un comportement de confirmation de la part de votre système. Les exemples présentés ici sont fournis à titre d'illustration, mais ne sont pas exhaustifs. Pour en savoir plus, consultez la section Présentation du workflow dans Créer votre logique de validation.

Exemples courants : confirm

L'exemple suivant illustre le cas de zones métropolitaines avec des noms de rues similaires. Supposons qu'un utilisateur souhaite saisir l'adresse du bâtiment D de Google à Kirkland, WA, États-Unis. Cependant, au lieu de Kirkland, il saisit par inadvertance Seattle.

Adresse saisie Région
Building D, 451 7th Avenue South, Seattle, WA 98033 États-Unis

Verdict pour les données remplacées

L'exemple ci-dessous met en évidence les signaux importants du verdict.

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

Le niveau de précision PREMISE_PROXIMITY indique une approximation d'une adresse au niveau du bâtiment, mais n'est pas aussi détaillé que SUB_PREMISE, qui est la précision fournie en entrée. La réponse contient également des composants non confirmés et remplacés. La combinaison de ces éléments fait donc basculer la réponse dans la catégorie confirm.

Une requête sur les composants d'adresse révèle les problèmes suivants :

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

Dans ce cas, l'API Address Validation a trouvé une approximation proche de l'adresse fournie à Seattle et a remplacé le code postal, un composant de niveau supérieur, pour résoudre une adresse à Seattle. Il pourrait s'agir d'un remplacement valide, mais comme les composants n'ont pas été confirmés, il est logique de s'assurer que l'utilisateur a l'intention de saisir une adresse à Seattle et non autre chose, comme Kirkland.

Exemples de cas limites : confirmer

Les exemples suivants illustrent les types de cas limites suivants :

  • Inférences mineures confirmées. L'API Address Validation déduit le pays, le code postal ou l'État, mais tout le reste est fourni et confirmé. La combinaison de la précision et du niveau de confirmation permet d'obtenir une inférence mineure qui ne nécessite pas nécessairement une action de confirmation.
  • Composant d'adresse inattendu NON confirmé. Les composants d'adresse non confirmés augmentent le niveau de risque de l'adresse. Cela peut nécessiter une confirmation.
  • Composant d'adresse inattendu qui EST confirmé. Le composant n'est pas strictement requis pour une adresse correcte, et l'API Address Validation le supprime du résultat. Les problèmes de mise en forme ne nécessitent généralement pas de confirmation.

Inférences mineures confirmées

Lorsqu'elle est combinée à des données confirmées d'un niveau plus précis, l'API peut toujours effectuer une inférence correcte s'il ne manque qu'un seul composant des types suivants :

  • Ville
  • État
  • Code postal
  • Pays

Par exemple, un client fournit une adresse postale valide pour un restaurant McDonald's à Springfield, dans le Massachusetts, mais oublie de saisir la ville et fournit un code postal sans l'extension à quatre chiffres.

Adresse saisie Région
1402 Allen St, MA 01118 États-Unis

Verdict pour la ville manquante

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
  "hasInferredComponents": true
}

Lorsque l'API Address Validation déduit des composants de niveau supérieur pour produire une adresse de livraison, vous pouvez avoir un niveau de confiance plus élevé dans l'exactitude des données du système. En effet, les composants déduits qui représentent une vaste région géographique sont plus facilement mis en correspondance avec des composants d'adresse confirmés plus précis. Même dans les pays où les noms de villes sont répétés, comme Springfield aux États-Unis, les autres composants combinés à ce nom peuvent fournir une adresse unique.

En reprenant l'exemple ci-dessus, une analyse de tous les composants d'adresse montre que chaque composant est confirmé, ce qui signifie qu'il correspond aux données stockées par l'API Address Validation, et que le service déduit également deux composants de niveau supérieur.

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

Composant d'adresse inattendu NON confirmé

Ce scénario illustre l'importance de vérifier quand les composants ne sont pas confirmés. Si un composant d'adresse est inattendu, l'API Address Validation le supprime de la sortie. Dans ce cas, vous pouvez accepter l'adresse ou la confirmer de nouveau auprès du client, en fonction de votre niveau de risque et de confiance.

Par exemple, une adresse peut provenir d'une région où les clients saisissent souvent des informations inoffensives ignorées par l'autorité postale. Dans ce cas, vous accepteriez l'adresse. Toutefois, dans certains cas, un composant non confirmé peut ne pas correspondre à ce que le client souhaite.

Adresse saisie Région
1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry France

Verdict pour un composant d'adresse inattendu non confirmé

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "unconfirmedComponents": true
}

En plus d'un verdict avec des composants non confirmés, l'API Address Validation renvoie l'adresse formatée suivante :

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

Une analyse des composants non confirmés montre que l'API a supprimé la caritat 2 de l'adresse renvoyée :

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

Composant d'adresse inattendu qui EST confirmé

Cet exemple illustre l'inclusion d'un comté du Royaume-Uni dans l'adresse fournie, ce qui est une pratique courante. Toutefois, cela n'est pas exigé par l'autorité postale britannique et est généralement ignoré. Consultez postoffice.co.uk et How to address UK and international mail (en anglais).

Par conséquent, lorsqu'un client indique un comté dans une adresse au Royaume-Uni, le service considère qu'il s'agit d'une entrée inattendue.

Adresse saisie Région
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP Royaume-Uni

Verdict pour un composant d'adresse inattendu qui EST confirmé

{
   "inputGranularity": "PREMISE",
   "validationGranularity": "PREMISE",
   "geocodeGranularity": "PREMISE"
}

Ici, address_complete est évalué à "false" et une analyse du composant d'adresse révèle un indicateur inattendu.

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

Bien que Gloucestershire soit le bon comté pour l'adresse saisie, l'adresse elle-même n'est pas correctement formatée. Rappelez-vous que l'API Address Validation évalue également le formatage des informations.