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 corrección por parte de tu sistema. Los ejemplos que se incluyen aquí son ilustrativos, pero no exhaustivos. Consulta la descripción general del flujo de trabajo en Compila tu lógica de validación para obtener más contexto.
Ejemplos comunes: corrección
En esta sección, se describen ejemplos comunes en los que la API de Address Validation proporciona indicadores de respuesta que indican información de dirección de menor calidad.
Faltan la ciudad y el código postal
En este ejemplo, se ilustra una entrada que solo tiene la dirección de la calle, sin ciudad ni código postal.
| Dirección ingresada | Región |
|---|---|
| 21 45 40th street | Estados Unidos |
Veredicto por falta de ciudad y código postal
En el siguiente ejemplo, se destacan los indicadores importantes de la respuesta.
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true
}
Estos indicadores señalan una dirección no entregable, por lo que puedes consultar addressComponents para obtener más información:
{
"componentName": {
"text": "21",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "45 40th street",
"languageCode": "en"
},
"componentType": "route",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "United States",
"languageCode": "en"
},
"componentType": "country",
"confirmationLevel": "CONFIRMED"
}
La API de Address Validation solo devuelve el país (Estados Unidos) como CONFIRMED.
Devuelve todos los demás componentes de la dirección como UNCONFIRMED_BUT_PLAUSIBLE, con algunas omisiones importantes en los datos, como la localidad y el código postal.
Falta el número de la calle
En este ejemplo, se muestra un número de calle faltante.
| Dirección ingresada | Región |
|---|---|
| Buckingham Palace Road, SW1W 9TQ London | Reino Unido |
Veredicto por falta de número de calle
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE"
}
validationGranularity es ROUTE, lo que indica una coincidencia con la calle, pero no hay suficiente información para llegar al establecimiento. Además, falta la propiedad addressComplete en el veredicto y, por lo tanto, es false. Una consulta adicional del objeto address revela un tipo de componente faltante:
"missingComponentTypes": [
"street_number"
]
Ejemplos de casos extremos: corrección
En algunas situaciones, si corriges, confirmas o aceptas una dirección depende de tu situación comercial particular. En los siguientes ejemplos, se ilustran situaciones que podrían no entrar estrictamente en una categoría de corrección.
Número de calle no confirmado
En esta situación, la API de Address Validation no puede confirmar el número de calle proporcionado, pero indica que la dirección está completa.
| Dirección ingresada | Región |
|---|---|
| 84 Buckingham Palace Road, SW1W 9TQ, London | Reino Unido |
Veredicto por número de calle no confirmado
En el siguiente ejemplo, se destacan los indicadores importantes.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete" : true,
"hasUnconfirmedComponents": true
}
Vale la pena investigar la combinación de una granularidad de validación solo para la aproximación a nivel de establecimiento junto con componentes no confirmados. Una consulta de la propiedad addressComponents muestra el siguiente componentType no confirmado:
{
"componentName": {
"text": "84",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Aquí, el confirmation_level de street_number se establece en UNCONFIRMED_BUT_PLAUSIBLE. No confirmado significa que el servicio no puede hacer coincidir el número de calle 84 en su conjunto de datos, y plausible significa que los datos del componente aún podrían ser válidos.
Falta el subestablecimiento
En esta situación, se describe una dirección a la que solo le falta un subestablecimiento, como un número de apartamento o departamento. De lo contrario, la API de Address Validation puede validar por completo la dirección. Como sucede cuando falta cualquier componente de la dirección, addressComplete es false y, por lo tanto, no está presente en la inspección manual del veredicto.
Para ilustrar, supongamos que un cliente ingresa una dirección válida para la oficina del tasador de la ciudad de San Francisco, pero no incluye el número de habitación en la entrada.
| Dirección ingresada | Región |
|---|---|
| 1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 | Estados Unidos |
Veredicto por falta de subestablecimiento
En este ejemplo, el veredicto no muestra la propiedad addressComplete, por lo que es false. Por lo tanto, sabes que, al menos, un elemento de dirección es inesperado, no resuelto o faltante.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
Una consulta address revela lo siguiente:
"missingComponentTypes": [
"subpremise"
]
Tras una consulta adicional, los datos del USPS proporcionan un código dpvConfirmation de D, que también indica un subestablecimiento faltante.