Ajouter des sous-locaux à une adresse (États-Unis uniquement)

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'ajout de sous-locaux de la part de votre système. Ces signaux ne sont disponibles que pour les adresses aux États-Unis. Pour en savoir plus, consultez la section Exemples de workflows dans Créer votre logique de validation.

Exemple courant : ajouter des sous-locaux

Ce scénario illustre une adresse pour laquelle votre système peut inviter un client à ajouter un numéro d'appartement à l'adresse.

Verdict pour une adresse sans sous-locaux

L'exemple ci-dessous met en évidence le signal important.

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

Exemple de cas particulier : ajouter des sous-locaux

L'exemple suivant couvre une situation dans laquelle verdict indique des problèmes de qualité d'adresse qui méritent d'être examinés plus en détail. Cet exemple illustre é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.

Sous-locaux manquants, et composants déduits et remplacés

Cet exemple illustre la saisie d'une adresse aux États-Unis avec une localité manquante et un code postal incorrect.

Verdict pour un sous-bâtiment manquant, et composants déduits et remplacés

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Un examen plus approfondi des composants de l'adresse révèle que la localité a été déduite et que le code postal a été remplacé.

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}