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 corrección de tu sistema. Consulta la descripción general del flujo de trabajo en Crea tu lógica de validación para obtener contexto.
Ejemplos comunes: corregir
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.
Falta la ciudad y el código postal
En este ejemplo, se muestra una entrada que solo tiene la dirección, sin ciudad ni código postal.
| Dirección ingresada | Región |
|---|---|
| 21 45 40th street | Estados Unidos |
Veredicto para la ciudad y el código postal faltantes
En el siguiente ejemplo, se enfatizan los indicadores importantes de la respuesta.
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true
}
Estos indicadores indican que se trata de una dirección que no se puede entregar, 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 muestra el país (Estados Unidos) como CONFIRMED.
Muestra 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 Londres | Reino Unido |
Veredicto por falta del número de calle
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE"
}
El validationGranularity es ROUTE, lo que indica una coincidencia con la calle, pero no hay información suficiente para llegar a la premisa. Además, falta la propiedad addressComplete en el veredicto, por lo que 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, la corrección, confirmación o aceptación de una dirección depende de la situación comercial en particular. En los siguientes ejemplos, se ilustran situaciones que podrían no incluirse estrictamente en la categoría de corrección.
Número de calle sin confirmar
En esta situación, la API de Address Validation no puede confirmar el número de ruta proporcionado, pero indica que la dirección está completa.
| Dirección ingresada | Región |
|---|---|
| 84 Buckingham Palace Road, SW1W 9TQ, Londres | Reino Unido |
Veredicto para el número de calle no confirmado
El siguiente ejemplo hace hincapié en los indicadores importantes.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete" : true,
"hasUnconfirmedComponents": true
}
Vale la pena investigar la combinación de un nivel de detalle de validación solo para la aproximación a nivel de la premisa 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 coincide con el número de calle 84 en su conjunto de datos, y posible significa que los datos del componente aún podrían ser válidos.
Falta la subpremisa
En esta situación, se describe una dirección a la que solo le falta una subpremisa, como un número de departamento o de apartamento. De lo contrario, la API de Address Validation puede validar la dirección por completo. Al igual que cuando falta algún componente de la dirección, el addressComplete es false y, por lo tanto, no está presente en la inspección manual del veredicto.
A modo de ejemplo, 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 subpremisa faltante
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 se resolvió o falta.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
Una consulta address revela lo siguiente:
"missingComponentTypes": [
"subpremise"
]
Tras una investigación más detallada, los datos del USPS proporcionan un código dpvConfirmation de D, que también indica que falta una subpremisa.