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

Ce document décrit un certain nombre de scénarios réels dans lesquels l'API de validation d'adresses fournit des signaux de réponse qui justifient un comportement d'ajout de sous-établissements 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 Présentation du workflow dans Créer votre logique de validation.

Exemple courant: ajouter des sous-établissements

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

Adresse saisie Région
1450 Brickell Avenue, Miami, FL 33131-4065 États-Unis

Évaluation d'une adresse sans sous-prémisse

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-sites

L'exemple suivant décrit une situation dans laquelle verdict indique des problèmes de qualité de l'adresse qui nécessitent des investigations supplémentaires. Cet exemple illustre également comment votre logique peut passer de l'évaluation aux composants d'adresse pour obtenir une image plus complète afin d'améliorer votre logique système.

Sous-prémisses manquantes, 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.

Adresse saisie Région
1450 Brickell Avenue, FL 33132-4065 États-Unis

Évaluation d'une sous-prémisse manquante 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 approfondi des composants de l'adresse révèle que la localité a été inférée 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
}