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.
| Dirección ingresada | Región |
|---|---|
| 1450 Brickell Avenue, Miami, FL 33131-4065 | EE.UU. |
Verdicto para 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 el ingreso de una dirección de EE.UU. con una localidad faltante y un código postal incorrecto.
| Dirección ingresada | Región |
|---|---|
| 1450 Brickell Avenue, FL 33132-4065 | EE.UU. |
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
}