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 Descripción general del flujo de trabajo en Crea tu lógica de validación para obtener 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 direcciones de menor calidad.
Faltan la ciudad y el código postal
En este ejemplo, se ilustra 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 sobre la 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 el
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, falta el número de la calle.
| Dirección ingresada | Región |
|---|---|
| Buckingham Palace Road, SW1W 9TQ Londres | Reino Unido |
Veredicto para el número de calle faltante
{
"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 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, corregir, confirmar o aceptar una dirección depende de tu caso empresarial particular. En los siguientes ejemplos, se ilustran situaciones que podrían no pertenecer estrictamente a una categoría de corrección.
Número de calle sin confirmar
En este caso, 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, Londres | Reino Unido |
Veredicto para el 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 un nivel de detalle de validación solo para
la aproximación a nivel de la premisa junto con los componentes no confirmados. Una consulta de la propiedad addressComponents muestra el siguiente componentType sin confirmar:
{
"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. Unconfirmed 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 sublocal
En esta situación, se describe una dirección a la que solo le falta un sublocal, como un
número de departamento. De lo contrario, la API de Address Validation puede validar la dirección por completo. Como sucede 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.
Para ilustrar, supongamos que un cliente ingresa una dirección válida para la oficina del asesor de la ciudad de San Francisco, pero omite el número de habitación de la entrada.
| Dirección ingresada | Región |
|---|---|
| 1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 | Estados Unidos |
Veredicto para 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 la dirección es inesperado, no se resolvió o falta.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
Una consulta de 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 un sublocal.