En este documento, se describen varias situaciones del mundo real en las que la API de Address Validation proporciona indicadores de respuesta que garantizan un comportamiento de agregar subpredios de tu sistema. Estos indicadores solo están disponibles para las direcciones de EE.UU. Consulta la descripción general del flujo de trabajo en Crea tu lógica de validación para obtener contexto.
Ejemplo común: agregar subpredios
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.
| Dirección ingresada | Región |
|---|---|
| 1450 Brickell Avenue, Miami, FL 33131-4065 | EE.UU. |
Veredicto para una dirección a la que le falta un subpredio
En el siguiente ejemplo, se destaca el indicador importante.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}
Ejemplo de caso extremo: agregar subpredios
En el siguiente ejemplo, se describe una situación en la que verdict indica problemas de calidad de la dirección que justifican una investigación más detallada. Estos ejemplos también ilustran 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 del sistema.
Faltan subpremisas, y se infirieron y reemplazaron componentes
En este ejemplo, se muestra la entrada de una dirección de EE.UU. a la que le falta la localidad y tiene un código postal incorrecto.
| Dirección ingresada | Región |
|---|---|
| 1450 Brickell Avenue, FL 33132-4065 | EE.UU. |
Veredicto para un supuesto 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
}