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 fix de tu sistema. Consulta la Descripción general del flujo de trabajo en Compila la 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 direcciones de menor calidad.
Faltan la ciudad y el código postal
En este ejemplo, se ilustra una entrada que contiene solo la dirección, sin ciudad ni código postal.
Dirección ingresada | Región |
---|---|
21 45 40th street | EE.UU. |
Veredicto de ciudad y código postal faltantes
El siguiente ejemplo enfatiza las señales importantes de la respuesta.
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true
}
Estos indicadores indican una dirección que no se puede entregar, 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 muestra el país (Estados Unidos) como CONFIRMED
.
Muestra todos los demás componentes de 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 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 suficiente información para llegar al lugar. 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: corregir
En algunas situaciones, la corrección, confirmación o aceptación de una dirección depende de tu situación de negocio particular. En los siguientes ejemplos, se ilustran situaciones que podrían no corresponder estrictamente a 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 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 de número de calle no confirmado
El siguiente ejemplo enfatiza 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 local junto con 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
. Sin confirmar significa que el servicio no puede coincidir con el número de calle de 84 en su conjunto de datos, y plausible 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 un sublocal, como un número de departamento o departamento. De lo contrario, la API de Address Validation puede validar la dirección por completo. Como sucede cuando falta algún componente de dirección, 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 asesor de la ciudad de San Francisco, pero no ingresa el número de habitación.
Dirección ingresada | Región |
---|---|
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 | EE.UU. |
Veredicto por falta de subpremisa
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 está resuelto o está faltante.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
Una consulta address
muestra lo siguiente:
"missingComponentTypes": [
"subpremise"
]
Tras una nueva consulta, los datos del USPS proporcionan un código dpvConfirmation
de D
, que también indica que falta una subpremisa.