En este documento, se describen varios casos prácticos en los que la API de Address Validation proporciona indicadores de respuesta que podrían justificar un comportamiento de corrección por parte de tu sistema. Consulta los flujos de trabajo de ejemplo 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 señalan 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 |
Verdicto para 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,
"possibleNextAction": "FIX"
}
El possibleNextAction
proporciona una indicación inicial de que es posible que la dirección no sea apta para envíos. Los otros componentes destacados también admiten esta posibilidad, 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 Londres | Reino Unido |
Verificación del número de calle faltante
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"possibleNextAction": "FIX"
}
Una vez más, possibleNextAction
proporciona una indicación inicial de que la dirección podría no ser apta para la entrega. Además, el validationGranularity
es ROUTE
, lo que indica una coincidencia con la calle, pero no hay suficiente información para llegar a las instalaciones. 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, si corriges, confirmas o aceptas una dirección depende de la situación particular de tu empresa. En los siguientes ejemplos, se ilustran situaciones que tal vez no se incluyan estrictamente en una categoría de corrección.
Número de la calle no confirmado
En este caso, la API de Address Validation no puede confirmar el número de la calle proporcionado, pero indica que la dirección está completa.
Dirección ingresada | Región |
---|---|
84 Buckingham Palace Road, SW1W 9TQ, Londres | Reino Unido |
Verificación para 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,
"possibleNextAction": "ACCEPT"
}
Vale la pena investigar la combinación de una granularidad de validación solo para la aproximación a nivel de la premisa junto con los componentes no confirmados. Una búsqueda 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
del street_number
se establece en UNCONFIRMED_BUT_PLAUSIBLE
. Sin confirmar significa que el servicio no puede encontrar el número de la calle 84 en su conjunto de datos, y Plausible significa que los datos del componente aún podrían ser válidos.
Falta la subinstalación
En este caso, se describe una dirección a la que solo le falta una subinstalación, como un número de departamento o de oficina. De lo contrario, la API de Address Validation puede validar la dirección por completo. Como sucede cuando falta cualquier componente de dirección, el addressComplete
es false
y, por lo tanto, no está presente en la inspección manual del veredicto.
Para ilustrarlo, 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 en la entrada.
Dirección ingresada | Región |
---|---|
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 | Estados Unidos |
Verificación de la falta de subinstalación
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,
"possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}
Una búsqueda de address
revela lo siguiente:
"missingComponentTypes": [
"subpremise"
]
Tras una investigación adicional, los datos del USPS proporcionan un código dpvConfirmation
de D
, que también indica que falta una subinstalación.