Accepter l'adresse - exemples

Ce document décrit plusieurs scénarios réels 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 en savoir plus, consultez la section Exemples de workflows dans Créer votre logique de validation.

Exemple courant : accept

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

Verdict pour 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
• hasSpellCorrectedComponents reste inchangé et vaut false

Lorsqu'ils sont combinés, ces signaux indiquent une adresse de haute qualité.

Exemples de cas limites : acceptation

Les exemples suivants couvrent les situations dans lesquelles le verdict indique des problèmes de qualité d'adresse qui justifient une investigation plus approfondie. Ces exemples illustrent également comment votre logique peut passer du verdict aux composants d'adresse pour obtenir une vue 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, le validationGranularity est ROUTE.

Verdict pour un numéro de rue non confirmé

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

Un examen plus approfondi des composants d'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é aux États-Unis

Cet exemple illustre la saisie d'une adresse aux États-Unis avec tous les composants d'adresse présents, sans composants déduits ni remplacés. Toutefois, le validationGranularity est PREMISE_PROXIMITY.

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 aux États-Unis dont tous les composants sont confirmés, sans composants déduits ni remplacés, et avec un validationGranularity de PREMISE. Toutefois, uspsData n'est pas entièrement renseigné et ne contient pas de valeur dpvConfirmation.

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"
}