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

Ce document décrit plusieurs scénarios concrets dans lesquels l'API Address Validation fournit des signaux de réponse qui justifient un comportement add subpremises de votre système. Ces signaux ne sont disponibles que pour les adresses aux États-Unis. Pour plus de contexte, consultez les exemples de workflows dans Créer votre logique de validation.

Exemple courant : ajouter des sous-lieux

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

Verdict pour une adresse sans sous-lieu

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

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

Exemple de cas limite : ajouter un sous-établissement

L'exemple suivant couvre une situation dans laquelle le verdict indique des problèmes de qualité d'adresse qui nécessitent une enquête plus approfondie. Cet exemple illustre é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.

Sous-établissements 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-lieu manquant et des composants inférés 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
}