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

Exemple courant : accept

Ce scénario illustre une adresse dans laquelle votre système accepterait une adresse saisie par un client.

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

Évaluation d'une adresse acceptable

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

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

En outre, la réponse indique les éléments suivants :

  • hasUnconfirmedComponents reste inchangé et vaut false
  • hasInferredComponents reste inchangé et vaut false
  • hasReplacedComponents reste inchangé et vaut false

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

Exemples de cas particuliers : accept

Les exemples suivants couvrent des situations dans lesquelles verdict indique des problèmes de qualité qui nécessitent un examen plus approfondi. Ces exemples montrent également comment votre logique peut voyager de l'évaluation aux composants d'adresse pour obtenir une image plus complète et 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 dans laquelle sont présents tous les composants d'adresse, mais pas de composants déduits ni remplacés. Toutefois, validationGranularity est ROUTE.

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

Évaluation d'un numéro de rue non confirmé

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

Un examen approfondi des composants de l'adresse révèle que le numéro de rue est UNCONFIRMED_BUT_PLAUSIBLE.

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

Numéro de rue non confirmé (États-Unis)

Cet exemple illustre la saisie d'une adresse aux États-Unis avec tous les composants de l'adresse présents, sans composant inféré ni remplacé. Toutefois, 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 l'entrée d'une adresse aux États-Unis avec tous les composants d'adresse confirmés, sans composants déduits ou remplacés, et un validationGranularity défini sur PREMISE. Toutefois, uspsData n'est pas entièrement renseigné et ne contient pas de valeur dpvConfirmation.

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

Évaluation d'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"
}