En este documento, se describe un proceso para compilar un sistema de verificación de direcciones a fin de controlar una variedad de respuestas de la API de Address Validation. Se explica cómo compilar tu lógica para usar correctamente la respuesta, investigar otros indicadores de la API, y cuándo y cómo solicitar más información a los clientes.
En general, la respuesta de la API determina las siguientes formas en las que tu sistema debe controlar una dirección:
- Corregir: La dirección es de baja calidad. Deberías solicitar más información.
- Confirmar: La dirección es de alta calidad, pero tiene cambios desde la dirección ingresada. Es posible que solicites confirmación.
- Aceptar: La dirección es de alta calidad. Puedes aceptar la dirección proporcionada.
Propósito clave
Este documento te ayuda a modificar tu sistema para analizar mejor la respuesta de la API y determinar las siguientes acciones que debes realizar con las direcciones proporcionadas. En el siguiente seudocódigo, se ilustra un flujo posible.
if (the API response indicates significant problems in the address)
FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
CONFIRM - confirm with the user that the address is correct
else
ACCEPT - continue with the address returned by the API.
La lógica exacta depende de tu situación: consulta la Guía para la implementación para obtener más detalles. También puedes usar nuestra implementación de código abierto de esta lógica, que se encuentra en la Biblioteca de componentes extendidos.
Descripción general del flujo de trabajo
En la siguiente tabla, se resumen dos acciones para tu sistema:
- El flujo de trabajo a utilizar basado en el comportamiento de corrección, confirmación y aceptación.
- Los primeros indicadores que se deben verificar a partir de la respuesta. Los indicadores que se describen aquí provienen de la propiedad
verdict
y no son los únicos que se deben verificar, sino que proporcionan un indicador inicial de la calidad de la dirección. Cada tipo de comportamiento corresponde a una sección de este documento en la que se describen otros indicadores que quizás también debas investigar.
El comportamiento del sistema | |||
---|---|---|---|
Corregir la dirección |
La respuesta de
|
||
Confirmar la dirección |
La respuesta de
|
||
Aceptar la dirección |
La respuesta de la API de Address Validation indica una dirección de excelente calidad.
|
Asesoramiento para la implementación
Cuando diseñas la manera en que tu sistema responde a las señales de la API de Address Validation, las siguientes recomendaciones pueden ayudarte a crear un modelo de respuesta más eficaz. Sin embargo, estas son solo recomendaciones, así que ten en cuenta que tu implementación debe ajustarse a tu modelo de negocio.
Orientación | Detalles | |
---|---|---|
Nivel de riesgo |
Ten en cuenta el nivel de tolerancia a la situación cuando generes el equilibrio entre solicitar correcciones y aceptar la dirección tal como se ingresó. |
La API de Address Validation muestra una variedad de indicadores que puedes incorporar con tu nivel de riesgo para optimizar el proceso de validación. Por ejemplo, si una dirección tiene un número de calle sin confirmar, puedes aceptarlo. Por otro lado, si la operación de tu empresa requiere una mayor precisión de las direcciones, puedes preguntarle al usuario. Para ver un ejemplo que podría corresponder a cualquiera de las categorías, consulta Número de calle no confirmado de EE.UU. en Cómo aceptar una dirección: ejemplos. |
Aceptar direcciones |
Se recomienda permitir que el sistema acepte la entrada original si el cliente no responde los mensajes. |
En estos casos, es posible que el cliente haya ingresado una dirección que no está en el sistema, por ejemplo, para una nueva construcción. |
Proporcionar comentarios |
Cuando vuelves a emitir una solicitud de validación de dirección, también puedes enviar una solicitud al extremo |
Esto permite que Google sepa cómo manejaste la respuesta final en última instancia. Consulta Cómo administrar direcciones actualizadas. |
Corregir una dirección
Corrige una dirección cuando los resultados indiquen claramente que no se puede entregar. Luego, el sistema puede pedirle al cliente que proporcione la información necesaria, después de lo cual vuelves a emitir tu flujo de trabajo para obtener una dirección de entrega.
Corregir indicadores
La API de Address Validation proporciona una serie de indicadores para informarte si se debe corregir una dirección.
1. Nivel de detalle de la validación y componentes faltantes
Estos dos indicadores proporcionan el mejor indicador de una dirección problemática:
- Cuando el campo
validationGranularity
esOTHER
, el sistema debe investigar las señales de los componentes de la dirección para obtener más información sobre dónde se produjo el error y cómo solucionarlo. - Cada vez que el objeto
address
procesado previamente muestra un campomissingComponentTypes
, el sistema debe verificar ese componente. Los componentes faltantes también hacen que una dirección esté incompleta y no se pueda entregar.
2. Otros indicadores
La API de Address Validation también proporciona los otros indicadores para ayudar a diagnosticar problemas específicos:
Componentes sospechosos | Cuando el nivel de confirmación enum de un componente es UNCOMFIRMED_AND_SUSPICIOUS , es probable que el componente sea incorrecto.
|
---|---|
Componente sin resolver | Un unresolvedToken es una parte de la entrada que no se reconoce como válida de una dirección. |
3. Indicadores de dirección de EE.UU.
Ciertos campos aplicables solo a las direcciones de EE.UU. proporcionan una señal útil de que la dirección no se puede entregar y, por lo tanto, debe corregirse. En el caso de una dirección que requiere corrección, debes ver lo siguiente:
dpvConfirmation
|
Puede ser N , D o vacío.
|
---|
Para obtener detalles sobre dpvConfirmation
, consulta Cómo administrar direcciones de Estados Unidos.
Ejemplos de corrección de direcciones
Confirma una dirección
La confirmación de una dirección se confirma cuando el veredicto indica que la API de Address Validation infirió o realizó cambios en los componentes de dirección para producir una dirección validada. En estos casos, tienes una dirección de entrega, pero prefieres tener mayor confianza en que la dirección resultante es la que busca el cliente.
Para proporcionarle al cliente la instrucción correcta, tu lógica identificaría los componentes marcados por el servicio para determinar qué acción o marca la API aplicó al componente, como inferred
, replaced
o spellCorrected
.
Consulta AddressComponent en la referencia.
Confirma los indicadores
La API de Address Validation proporciona una serie de indicadores para informarte si se debe confirmar una dirección.
1. Nivel de detalle de la validación
Un validationGranularity
de ROUTE
o mejor es aceptable, pero tanto PREMISE como SUBPREMISE proporcionan un indicador de entrega más sólido.
2. Otros indicadores
Cuando decidas confirmar la entrada de la dirección con el cliente, el veredicto también proporciona lo siguiente para determinar qué componentes investigar:
Datos inferidos | Cuando el campo hasInferredComponents es true , sabes que la API completó la información que recopiló de otros componentes de la dirección.
|
---|---|
Datos reemplazados | Cuando el campo hasReplacedComponents es true , la API reemplazó los datos ingresados por datos que consideró que la dirección era válida.
|
3. Indicadores de dirección de EE.UU.
Ciertos campos aplicables solo a las direcciones de EE.UU. indican que tu lógica debe confirmar los detalles con el cliente. Se aplica cualquiera de las siguientes opciones:
dpvConfirmation
|
S
Para obtener detalles sobre |
---|---|
Respuesta en la dirección | Contiene el campo missingComponentType con el valor subpremise .
|
Ejemplos de confirmación de dirección
Cómo aceptar una dirección
Se acepta una dirección cuando el veredicto proporciona un alto grado de confianza en que la dirección es entregable y se puede usar sin más interacción con el cliente en el proceso posterior.
Aceptar indicadores
La API de Address Validation proporciona una serie de indicadores para informarte si se debe confirmar una dirección.
1. Nivel de detalle de la validación
Se acepta una validationGranularity
de PREMISE
o mejor, pero, en algunos casos, ROUTE
aún indica una dirección de entrega.
2. Otros indicadores
Un veredicto para una dirección de alta calidad también debe proporcionar lo siguiente:
- No hay datos reemplazados. En este caso, es
hasReplacedComponents: FALSE
. - No hay componentes inferidos. En este caso, es
hasInferredComponents: FALSE
.
3. Indicadores de dirección de EE.UU.
Ciertos campos aplicables solo a las direcciones de EE.UU. indican una dirección de alta calidad a la que se puede realizar el envío. Para obtener una dirección aceptable en EE.UU., debes ver lo siguiente:
dpvConfirmation
|
Y
Para obtener detalles sobre |
---|