Elige una solución de validación de direcciones

Diagrama de flujo que muestra la descripción general de alto nivel de los pasos de prueba.

Objetivo

La API de Address Validation proporciona valor para una variedad de casos de uso, y hay consideraciones clave más allá de la calidad sin procesar de los resultados de las pruebas que te sugerimos explorar. Por ejemplo, una vista integral de los productos compatibles en un flujo del usuario, como Place Autocomplete y Maps, la disponibilidad regional y la confiabilidad y la fiabilidad empresariales.

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 sea adecuada para tu caso de uso.
  2. Verifica cómo la API de Address Validation cumple con los requisitos de tus soluciones, por ejemplo, los siguientes:
    • Identificar direcciones de buena calidad
    • Alertas para abordar las entradas de baja calidad
    • Realizar correcciones en los datos de direcciones, incluidas las inferencias, los reemplazos y las 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 recibirás un beneficio medible por implementar 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 se debe realizar con una muestra de los datos de dirección existentes. No selecciones los datos de forma manual para la prueba, sino que elige muestras aleatorias que sean representativas de las ubicaciones geográficas en las que operas. Esto significa que, si operas en Estados Unidos y el Reino Unido, pero el 70% de tu negocio se realiza en el Reino Unido y el 30% en EE.UU., la muestra debe reflejar esa división.

Usar las direcciones desde el punto de captura Por ejemplo, si planeas implementar la validación de direcciones en la confirmación de 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 pueda reemplazarse con la implementación de la API de Address Validation.

Prepara una muestra de entre 5,000 y 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 en grandes cantidades.

El resultado de este paso deben ser los datos que genera la API para cada registro de dirección. Luego, podrás analizar los resultados para determinar si la API es adecuada para tu caso de uso. Puedes usar una hoja de cálculo, una base de datos o cualquier otra herramienta.

Revisa los resultados

Prerrequisito de la sección: Comprende cómo controlar la respuesta de validación, en especial el concepto de Fix, Confirm y Accept.

En esta sección, analizaremos las situaciones de salida que puedes analizar para evaluar la adecuación de la solución.

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

Datos de respuesta

¿Qué es?

Cómo evaluar

¿Cómo ayuda?

verdict.inputGranularity

Describe la granularidad de entrada de la dirección.

SUB_PREMISE

PREMISA

PREMISE_PROXIMITY

BLOQUEAR

ROUTE

OTRO

Te permite determinar si la dirección de entrada tiene suficientes datos para ser potencialmente válida.

verdict.validationGranularity

Describe la validación general del resultado de la dirección.

SUB_PREMISE

PREMISA

PREMISE_PROXIMITY

BLOQUEAR

ROUTE

OTRO

Te permite determinar la calidad general de la dirección en el resultado de la API.

verdict.hasInferredComponents

Indica si la API infirió un componente.

Verdadero/falso

La API puede agregar componentes faltantes cuando puede inferir los datos. Por ejemplo, falta un código de estado.

verdict.hasReplacedComponents

Indica si la API reemplazó un componente.

Verdadero/falso

En algunos casos, la API puede reemplazar los componentes incorrectos por los datos correctos.

verdict.addressComplete

Indica si la dirección está completa.

Verdadero/falso

Será verdadero si la API determina que la dirección de salida tiene todos los componentes necesarios.

address.missingComponentTypes

Es un indicador que advierte si faltan componentes en la dirección.

Consulta la tabla dos para ver los valores.

Destaca los componentes faltantes de una dirección incompleta.

Revisa las direcciones válidas

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

  • verdict.validationGranularity contiene PREMISE o una versión mejor.
  • verdict.addressComplete es true.
  • No se infieren ni reemplazan componentes.

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

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

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

Ejemplo: Dirección válida

Dirección ingresada

Región

76 Buckingham Palace Road, Londres SW1W 9TQ

Reino Unido

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 posteriores.

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

  • verdict.validationGranularity se establece 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 debe ser un subconjunto de los datos de dirección que tu sistema marcaría como no válidos. En este punto, puedes determinar si el porcentaje de tasa no válida es aceptable.

Es importante tener en cuenta que marcar 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 refleja un mal rendimiento de la API. La API te brinda información sobre algún problema con la dirección, lo que podría mejorar la eficiencia de tu flujo de trabajo, ya que detecta los errores antes y evita problemas posteriores.

Ejemplo: Dirección no válida

Dirección ingresada

Región

21 45 40th street

Estados Unidos

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 respuesta. 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 permitiría que sea válida. Para ello, envía comentarios al punto de recopilación de datos sobre los campos específicos que son incorrectos. Esta es una forma en la que la API proporciona valor, ya que te brinda información específica sobre la calidad de tus datos.

Ejemplo: Componente faltante y sin confirmar

Dirección ingresada

Región

Fake St, Nueva York, NY 10011

Estados Unidos

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 forma en que la API agrega valor, y es importante capturarla como parte de la prueba.

Los indicadores clave que debes buscar son los siguientes:

  • inferred, replaced o spellCorrected se establecen en true en cualquiera de los addressComponents.
  • verdict.hasInferredComponents o verdict.hasReplacedComponents establecido en 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 dirección a los que la API les aplicó una corrección.

Una parte de estos datos se puede revisar de forma manual para determinar si la API realiza correcciones en tus datos que reducirían la fricción en tu flujo de trabajo posterior.

Ejemplo: Dirección con una corrección

Dirección ingresada

Región

76 Bruckingm Palace Road, Londres SW1W 9TQ

Reino Unido

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 subpremise o si es incorrecto para las direcciones de EE.UU.

Los indicadores clave que debes buscar son los siguientes:

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

Consulta cómo controlar las direcciones de Estados Unidos para obtener más información.

Esta prueba mostrará si hay un problema en tus datos con subdirecciones faltantes o incorrectas, como números de departamento. Esto puede causar problemas posteriores, especialmente en los casos de uso de entrega. La API de Address Validation puede agregar valor a tu flujo de trabajo, ya que identifica esta situación antes, lo que te permite implementar pasos para recopilar datos corregidos.

Ejemplo: Falta una subpremisa

Dirección ingresada

Región

111 8th Avenue, Manhattan, NY 10011

EE.UU.

Falta un componente

"missingComponentTypes": [
    "subpremise"
]

Confirmación del DPV de los datos del USPS

"dpvConfirmation": "D"

[Solo para EE.UU.] Revisa USPS standardizedAddress

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

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

Ejemplo: Dirección estandarizada de 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 a realizar pruebas hoy mismo con la API de Address Validation para garantizar la precisión de los datos de direcciones, mejorar la experiencia del cliente y optimizar las operaciones de tu empresa. Después de seguir las situaciones de prueba descritas anteriormente, tendrás la información que necesitas para determinar si la API de Address Validation aportará valor a tu flujo de trabajo.

Lecturas adicionales sugeridas:

Colaboradores

Henrik Valve | Ingeniero de DevX