En este documento, se describen varias situaciones reales en las que la API de Address Validation proporciona indicadores de respuesta para las direcciones que justifican un comportamiento de confirmación de tu sistema. Los ejemplos que se incluyen aquí son ilustrativos, pero no exhaustivos. Consulta la Descripción general del flujo de trabajo en Crea tu lógica de validación para obtener contexto.
Ejemplos comunes: confirmación
En el siguiente ejemplo, se ilustra el caso de las áreas metropolitanas con nombres de calles similares. Supongamos que un usuario quiere ingresar la dirección del edificio D de Google en Kirkland, WA, Estados Unidos. Sin embargo, en lugar de Kirkland como la ciudad, ingresan Seattle por error.
| Dirección ingresada | Región |
|---|---|
| Building D, 451 7th Avenue South, Seattle, WA 98033 | EE.UU. |
Veredicto para los datos reemplazados
En el siguiente ejemplo, se destacan los indicadores importantes del veredicto.
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete": true,
"hasUnconfirmedComponents": true
"hasReplacedComponents": true
}
El nivel de precisión PREMISE_PROXIMITY
indica la proximidad de una dirección a nivel de edificio, pero no es tan
detallado como SUB_PREMISE, que es la precisión que se proporciona en la entrada. La
respuesta también contiene componentes no confirmados y reemplazados, por lo que la
combinación inclina la balanza hacia la categoría confirm.
Una consulta de los componentes de la dirección revela las siguientes áreas de preocupación:
{
"componentName": {
"text": "451",
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
"componentName": {
"text": "98104",
},
"componentType": "postal_code",
"confirmationLevel": "CONFIRMED",
"replaced": true
}
...
{
"componentName": {
"text": "Building D",
"language_code": "en"
},
"componentType": "subpremise",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......
"unconfirmedComponentTypes": [
"street_number",
"subpremise"
]
En este caso, la API de Address Validation encontró una aproximación cercana a la dirección proporcionada en Seattle y reemplazó el código postal, un componente de nivel superior, para resolver una dirección de Seattle. Este podría ser un reemplazo válido, pero, junto con el hecho de que los componentes no se confirmaron, tiene sentido asegurarse de que el usuario tenga la intención de ingresar una dirección de Seattle y no otra, como Kirkland.
Ejemplos de casos extremos: confirmación
En los siguientes ejemplos, se ilustran los siguientes tipos de casos extremos:
- Inferencia menor que SÍ se confirma. La API de Address Validation infiere el país, el código postal o el estado, pero todo lo demás se proporciona y se confirma. La combinación de la nivel de detalle y el nivel de confirmación genera una inferencia menor que no necesariamente requiere una acción de confirmación.
- NO se confirmó el componente de dirección inesperado. Los componentes de dirección no confirmados aumentan el nivel de riesgo de la dirección. Esto podría requerir una confirmación.
- Componente de dirección inesperado que SÍ se confirmó. El componente no es estrictamente necesario para una dirección correcta, y la API de Address Validation lo quita del resultado. Por lo general, los problemas de formato no justifican una confirmación.
Inferencias menores que SÍ se confirman
Cuando se combina con datos confirmados de un nivel más detallado, la API puede realizar una inferencia correcta si a la entrada le falta solo un componente de los siguientes tipos:
- Ciudad
- Estado
- Código postal
- País
Por ejemplo, un cliente proporciona una dirección válida para un restaurante de McDonald's en Springfield, Massachusetts, pero olvida ingresar la ciudad y proporciona un código postal sin la extensión de 4 dígitos.
| Dirección ingresada | Región |
|---|---|
| 1402 Allen St, MA 01118 | EE.UU. |
Veredicto para la ciudad faltante
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
"hasInferredComponents": true
}
En situaciones en las que la API de Address Validation infiere componentes de nivel superior para producir una dirección de entrega, puedes tener un mayor nivel de confianza en que los datos del sistema son correctos. Esto se debe a que los componentes inferidos que representan una región geográfica amplia se asocian con mayor facilidad a los componentes de dirección confirmados que son más detallados. Incluso en países donde se repiten los nombres de las ciudades, como Springfield en Estados Unidos, los otros componentes combinados con él pueden proporcionar una dirección única.
En el ejemplo anterior, un análisis de todos los componentes de la dirección muestra que todos están confirmados, lo que significa que coinciden con los datos almacenados por la API de Address Validation, y que el servicio también infiere dos componentes de nivel superior.
{
"componentName": {
"text": "Springfield",
"languageCode": "en"
},
"componentType": "locality",
"confirmationLevel": "CONFIRMED",
"inferred": true
},
{
"componentName": {
"text": "1806"
},
"componentType": "postal_code_suffix",
"confirmationLevel": "CONFIRMED",
"inferred": true
}
Componente de dirección inesperado NO confirmado
Esta situación ilustra la importancia de verificar cuándo no se confirman los componentes. Si un componente de dirección es inesperado, la API de Address Validation lo quita del resultado. En estos casos, puedes aceptar la dirección o volver a confirmarla con el cliente, según tu nivel de riesgo y de confianza.
Por ejemplo, una dirección puede ser de una región en la que los clientes suelen ingresar información inofensiva que la autoridad postal ignora, en cuyo caso aceptarías la dirección. Sin embargo, en algunos casos, es posible que un componente no confirmado no sea lo que el cliente desea.
| Dirección ingresada | Región |
|---|---|
| 1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry | Francia |
No se confirmó el veredicto para el componente de dirección inesperado
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"unconfirmedComponents": true
}
Además de un veredicto con componentes sin confirmar, la API de Address Validation devuelve la siguiente dirección con formato:
"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",
Un análisis de los componentes no confirmados muestra que la API quitó la caritat 2 de la dirección que se devolvió:
{
"componentName": {
"text": "la caritat 2",
"languageCode": "fr"
},
"componentType": "sublocality_level_1",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
"unexpected": true
}
Componente de dirección inesperado que SÍ está confirmado
En este ejemplo, se ilustra la inclusión de un condado del Reino Unido en la dirección proporcionada, lo que es una práctica común. Sin embargo, la autoridad postal del Reino Unido no lo exige y, básicamente, se ignora. Consulta postoffice.co.uk y Cómo dirigir el correo internacional y del Reino Unido.
Como resultado, cuando un cliente proporciona un condado en una dirección del Reino Unido, el servicio evalúa esto como una entrada inesperada.
| Dirección ingresada | Región |
|---|---|
| 33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP | Reino Unido |
Veredicto para un componente de dirección inesperado que SÍ se confirmó
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE"
}
Aquí, address_complete se evalúa como falso y un análisis del componente de dirección revela un indicador inesperado.
{
"componentName": {
"text": "Gloucestershire",
"languageCode": "en"
},
"componentType": "administrative_area_level_2",
"confirmationLevel": "CONFIRMED",
"unexpected": true
}
Si bien Gloucestershire es el condado correcto para la dirección ingresada, la dirección en sí tiene un formato incorrecto. Recuerda que la API de Address Validation también evalúa la información para darle el formato adecuado.