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

En este documento, se describen varias situaciones reales en las que la API de Address Validation proporciona indicadores de respuesta que justifican un comportamiento de agregar subinstalaciones de tu sistema. Estos indicadores solo están disponibles para direcciones de EE.UU. Consulta Flujos de trabajo de ejemplo en Crea tu lógica de validación para obtener contexto.

Ejemplo común: agregar subinstalaciones

En esta situación, 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.

Veredicto para una dirección a la que le falta un sublocal

En el siguiente ejemplo, se destaca el indicador importante.

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

Ejemplo de caso extremo: agregar sublocales

En el siguiente ejemplo, se aborda una situación en la que el verdict indica problemas de calidad de la dirección que justifican una investigación más detallada. En este ejemplo, también se ilustra cómo tu lógica puede pasar del veredicto a los componentes de la dirección para obtener un panorama más completo y mejorar la lógica de tu sistema.

Subinstalaciones faltantes y componentes inferidos y reemplazados

En este ejemplo, se ilustra la entrada de una dirección de EE.UU. a la que le falta la localidad y tiene un código postal incorrecto.

Veredicto para un sublocal 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 detallada 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
}