Accepter 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 d'acceptation de la part de votre système. Pour plus de contexte, consultez la section Présentation du workflow dans Utiliser la réponse de validation.

Exemple courant : acceptation

Ce scénario illustre une adresse que votre système accepterait si elle était saisie par un client.

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

Verdict pour une adresse acceptable

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

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

De plus, le verdict indique les éléments suivants :

  • hasUnconfirmedComponents reste false
  • hasInferredComponents reste false
  • hasReplacedComponents reste false

Combinés, ces signaux indiquent une adresse de haute qualité.

Exemples de cas particuliers : acceptation

Les exemples suivants couvrent des situations dans lesquelles le verdict indique des problèmes de qualité d'adresse qui nécessitent une enquête plus approfondie. Ils illustrent également comment votre logique peut passer du verdict aux composants d'adresse pour obtenir une image plus complète afin d'améliorer la logique de votre système.

Numéro de rue non confirmé en dehors des États-Unis

Cet exemple illustre la saisie d'une adresse italienne avec tous les composants d'adresse présents, sans composants déduits ni remplacés. Toutefois, la validationGranularity est ROUTE.

Adresse saisie Région
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia IT

Verdict pour un numéro de rue non confirmé

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

Une enquête plus approfondie sur les composants d'adresse révèle que le niveau de confirmation du numéro de rue est UNCONFIRMED_BUT_PLAUSIBLE.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Numéro de rue non confirmé aux États-Unis

Cet exemple illustre la saisie d'une adresse américaine avec tous les composants d'adresse présents, sans composants déduits ni remplacés. Toutefois, la validationGranularity est PREMISE_PROXIMITY.

Adresse saisie Région
975 Carson Dr, Sunnyvale, CA 94086 États-Unis

Données USPS pour un numéro de rue non confirmé

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

Données USPS incomplètes pour une adresse confirmée

Cet exemple illustre la saisie d'une adresse américaine avec tous les composants d'adresse confirmés, sans composants déduits ni remplacés, et une validationGranularity de PREMISE. Toutefois, les uspsData ne sont pas entièrement renseignées et ne contiennent pas de valeur dpvConfirmation.

Adresse saisie Région
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 États-Unis

Verdict pour une adresse confirmée avec des données USPS incomplètes

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

Données USPS pour une adresse confirmée avec des données USPS incomplètes

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}