Elige una solución de validación de direcciones

Objetivo

La validación de direcciones proporciona valor para una variedad de casos de uso y existen consideraciones clave más allá de la calidad sin procesar de los resultados de las pruebas que te sugerimos que explores. Por ejemplo, una vista integral de los productos compatibles en un flujo de usuarios, como Place Autocomplete y Maps, la disponibilidad regional y la confianza y confiabilidad de la empresa.

Una vez que llegues al punto de evaluar la API de Address Validation, aquí tienes algunos lineamientos que te recomendamos que uses como parte de tus pruebas.

Los objetivos de esta prueba serán los siguientes:

1. Confirma que la API de Address Validation es adecuada para tu caso de uso.
2. Verifica cómo la API de Address Validation cumple con los requisitos de tus soluciones, como los siguientes:
   • Identificar direcciones de buena calidad
   • Alertas para abordar las entradas de baja calidad
   • Hacer correcciones en los datos de dirección, incluidas inferencias, reemplazos y correcciones ortográficas
   • Proporcionar una dirección con formato para el envío
   • Alertas sobre datos de subpremisa faltantes o incorrectos (solo en EE.UU.)
3. Asegúrate de que obtendrás un beneficio medible con la implementación de la API.

Después de realizar la prueba, podrás responder las preguntas anteriores y determinar si la API es adecuada para tu empresa.

Prepara los datos

La prueba debe realizarse en una muestra de tus datos de direcciones existentes. No elijas datos de forma manual para la prueba, sino que elige muestras aleatorias que sean representativas de las geografías en las que opera tu empresa. Esto significa que, si opera en Estados Unidos y el Reino Unido, pero el 70% de su negocio se realiza en el Reino Unido en comparación con el 30% en EE.UU., la muestra debe reflejar esa división.

Usa las direcciones del punto de captura. Por ejemplo, si planeas implementar la validación de direcciones en la confirmación de la compra de tu comercio electrónico, usa las direcciones que ingresan tus clientes en el formulario, antes de que se realice cualquier procesamiento existente que se pueda reemplazar con la implementación de la API de Address Validation.

Prepara una muestra de alrededor de 5,000 a 10,000 registros para la prueba.

Llama a la API

Requisito previo de la sección: Comprende cómo enviar una solicitud de validación de dirección.

Una vez que hayas preparado los datos, deberás ejecutar cada registro de dirección en la API.

Consulta la documentación de la API de Address Validation para obtener orientación sobre cómo llamar a la API. También tenemos un artículo en el que se describen las prácticas recomendadas para usar la API de Address Validation para procesar direcciones a gran volumen.

El resultado de este paso debe ser la salida de datos de la API para cada registro de dirección. Luego, podrás analizar los resultados para determinar la idoneidad de la API para tu caso de uso. Tú decides si usar una hoja de cálculo, una base de datos o cualquier otra herramienta.

Revisa los resultados

Requisito previo de la sección: Comprender cómo controlar la respuesta de validación, en especial el concepto de corregir, confirmar y aceptar.

En esta sección, analizaremos los escenarios de resultados que puedes analizar para evaluar la adaptación de la solución.

Descripción general de los campos clave de la API que se analizan en este documento

Revisa las direcciones válidas

Ordena los datos que muestra la API para determinar el conjunto de direcciones que tu sistema aceptaría como válidos. Los indicadores clave que debes buscar en la API son los siguientes:

• verdict.validationGranularity contiene PREMISE o una versión posterior.
• verdict.addressComplete es true.
• No hay componentes inferidos ni reemplazados.

Consulta Cómo aceptar una dirección para obtener más información.

El resultado de este ejercicio debería ser un subconjunto de los datos de direcciones que tu sistema aceptaría como válidos. En este punto, puedes determinar lo siguiente:

• ¿Es aceptable el porcentaje de aceptación?
• Si usas un flujo de trabajo de validación de direcciones existente, ¿el porcentaje de aceptación es equivalente o mejor?

Ejemplo: Dirección válida

Veredicto

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Revisa las direcciones no válidas

Este paso es una oportunidad para revisar manualmente algunos de los datos de direcciones que se marcaron como no válidos y ver si, sin usar la API de Address Validation, esa dirección no válida podría causar problemas en el futuro.

Ordena los datos que muestra la API para determinar el conjunto de direcciones que tu sistema marcaría como no válidas. Los indicadores clave que debes buscar en la API son los siguientes:

• verdict.validationGranularity establecido en OTHER o ROUTE según tu nivel de riesgo
• verdict.addressComplete es false.

Consulta Cómo corregir una dirección para obtener más información.

El resultado de este ejercicio debería ser un subconjunto de los datos de direcciones que el sistema marcaría como no válidos. En este punto, puedes determinar si el porcentaje de tasa no válido es aceptable.

Es importante tener en cuenta que marcar las direcciones como no válidas es una función principal de la API de Address Validation, y una alta tasa de direcciones marcadas como no válidas no necesariamente se refleja de manera negativa en la API. La API te informa que hay un problema con la dirección, lo que podría mejorar la eficiencia de tu flujo de trabajo, ya que detectaría los errores antes de que causen problemas más adelante.

Ejemplo: Dirección no válida

Veredicto

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Revisa los componentes faltantes o no confirmados

En esta etapa, también se pueden revisar los componentes faltantes o no confirmados. Esto forma parte del objeto Address en la devolución. Los dos campos son missingComponentTypes y unconfirmedComponentTypes.

Usa estos campos para detectar el motivo por el que la API marca una dirección como no válida y recopila la información correcta de la dirección que le permitiría ser válida. Para ello, envía al punto de recopilación de datos los campos específicos que son incorrectos. Esta es una forma en que la API proporciona valor, ya que te brinda información específica sobre la calidad de tus datos.

Ejemplo: Componente faltante y no confirmado

Veredicto

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

Componentes faltantes y no confirmados

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

Revisa las direcciones con correcciones

La API de Address Validation puede corregir los datos de entrada, tomar una entrada de dirección potencialmente no válida y generar datos de dirección válidos. Esta es una manera en que la API agrega valor, y es importante capturar esto como parte de la prueba.

Estos son los indicadores clave que debes tener en cuenta:

• inferred, replaced o spellCorrected configurados en true en cualquiera de los addressComponents
• verdict.hasInferredComponents o verdict.hasReplacedComponents configurados como true

Consulta Cómo confirmar una dirección para obtener más información.

El resultado de este ejercicio debe ser un subconjunto de los datos de direcciones a los que la API les aplicó una corrección.

Se puede revisar manualmente una parte de estos datos para determinar si la API realiza correcciones en tus datos que reducirían los problemas en tu flujo de trabajo descendente.

Ejemplo: Dirección con una corrección

Ruta addressComponent

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[Solo en EE.UU.] Revisa la dirección con datos de subpremisa faltantes o incorrectos

La API de Address Validation puede determinar si falta un número de departamento o si es incorrecto en el caso de las direcciones de EE.UU.

Estos son los indicadores clave que debes tener en cuenta:

• En el objeto Address, haz lo siguiente:
  • unconfirmedComponentTypes contiene subpremise
  • missingComponentTypes contiene subpremise
• En el objeto UspsData, haz lo siguiente:
  • dpvConfirmation es D (falta la subpremisa)
  • dpvConfirmation es S (no se confirmó la subpremisa)

Consulta Cómo manejar direcciones de Estados Unidos para obtener más información.

Esta prueba mostrará si hay un problema en tus datos con subpredios faltantes o incorrectos, como números de departamentos. Esto puede causar problemas downstream, especialmente en los casos de uso de publicación. La API de Address Validation puede agregar valor a tu flujo de trabajo, ya que identifica esto con anticipación, lo que te permite implementar pasos para recopilar datos corregidos.

Ejemplo: Falta la subpremisa

Falta un componente

"missingComponentTypes": [
    "subpremise"
]

Confirmación de DPV de datos del USPS

"dpvConfirmation": "D"

[Solo para EE.UU.] Revisa standardizedAddress de USPS

La API de Address Validation también muestra la dirección estandarizada del USPS para las direcciones de Estados Unidos. Esto es muy importante si necesitas que las direcciones en formato USPS se impriman en tus etiquetas de envío.

Puedes revisar UspsAddress para ver estos datos y determinar si agregan valor a tu flujo de trabajo.

Ejemplo: Dirección estandarizada del USPS

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

Conclusión

Comienza las pruebas: Comienza a probar la API de Address Validation hoy mismo para asegurarte de tener datos de direcciones precisos, mejorar la experiencia del cliente y optimizar las operaciones de tu empresa. Después de seguir las situaciones de prueba que se describieron anteriormente, tendrás la información que necesitas para determinar si la API de Address Validation agregará valor a tu flujo de trabajo.

Lecturas adicionales sugeridas:

• Documentación para desarrolladores de la API de Address Validation
• Cómo usar la API de Address Validation para procesar direcciones en gran volumen
• Validación de direcciones para la confirmación de la compra de comercio electrónico

Colaboradores

Henrik Valve | Ingeniero de DevX