Ejemplos para agregar dependencias a una dirección (solo en EE.UU.)

En este documento, se describen varios casos prácticos en los que la API de Address Validation proporciona indicadores de respuesta que justifican un comportamiento de agregar subinstalaciones por parte de tu sistema. Estos indicadores solo están disponibles para las direcciones de EE.UU. Consulta los flujos de trabajo de ejemplo en Crea tu lógica de validación para obtener contexto.

Ejemplo común: Agregar subinstalaciones

En este caso, se ilustra una dirección en la que tu sistema podría solicitarle a un cliente que agregue un número de unidad a la dirección.

Verificación de una dirección a la que le falta una subinstalación

En el siguiente ejemplo, se destaca el indicador importante.

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

Ejemplo de caso límite: agregar subinstalaciones

En el siguiente ejemplo, se aborda una situación en la que verdict indica problemas de calidad de la dirección que justifican una mayor investigación. Estos ejemplos también ilustran cómo tu lógica puede viajar desde el veredicto hasta los componentes de la dirección para obtener una imagen más completa y, así, mejorar la lógica de tu sistema.

Faltan subinstalaciones y se infieren y reemplazan componentes

En este ejemplo, se ilustra la entrada de una dirección de EE.UU. con una localidad faltante y un código postal incorrecto.

Verdicto para una subinstalación faltante y componentes inferidos y reemplazados

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

Una investigación más profunda de los componentes de la dirección revela que se infirió la localidad y se reemplazó el código postal.

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