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

Address Validation proporciona valor para una variedad de casos de uso, y hay consideraciones clave más allá de la calidad bruta de los resultados de las pruebas que te sugerimos explorar. Por ejemplo, una vista integral de los productos compatibles en un flujo de usuario, 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, te recomendamos que uses estas instrucciones como parte de tus pruebas.

Los objetivos de esta prueba serán los siguientes:

  1. Confirmar que la API de Address Validation es adecuada para tu caso de uso
  2. Verificar cómo la API de Address Validation cumple con los requisitos de tus soluciones, como los siguientes:
    • Identificar direcciones de buena calidad
    • Alertar sobre las entradas de direcciones 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
    • Alertar sobre datos de subdirecciones faltantes o incorrectos (solo en EE.UU.)
  3. Asegurarte de que recibirás un beneficio medible de 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 con una muestra de tus datos de direcciones existentes. No selecciones datos para la prueba, sino que elige muestras aleatorias que sean representativas de las áreas geográficas en las que operas. Esto significa que, si operas en Estados Unidos y el Reino Unido, pero el 70% de tu empresa se realiza en el Reino Unido en comparación con el 30% en Estados Unidos, la muestra debe reflejar esa división.

Usa 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 ingresaron tus clientes en el formulario, antes de que se produzca cualquier procesamiento existente que pueda reemplazarse con la implementación de la API de Address Validation.

Prepara un tamaño de 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 direcciones .

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 instrucciones 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 volúmenes.

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. Ya sea que uses una hoja de cálculo, una base de datos o cualquier otra herramienta, depende de ti.

Revisa los resultados

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

En esta sección, analizaremos los casos 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

PREMISE

PREMISE_PROXIMITY

BLOCK

ROUTE

OTHER

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

verdict.validationGranularity

Describe la validación general de salida de la dirección.

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

BLOCK

ROUTE

OTHER

Te permite determinar la calidad general de la dirección en la salida 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, un código de estado faltante.

verdict.hasReplacedComponents

Indica si la API reemplazó un componente.

Verdadero/falso

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

verdict.addressComplete

Indica si la dirección está completa.

Verdadero/falso

Si la API determina que la dirección de salida tiene todos los componentes necesarios, esto será verdadero.

address.missingComponentTypes

Indica una advertencia si a la dirección le faltan componentes.

Consulta la tabla dos para obtener los valores.

Destaca los componentes faltantes de una dirección incompleta.

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álidas. Los indicadores clave que debes buscar en la API son los siguientes:

  • verdict.validationGranularity contiene PREMISE o un valor mejor.
  • 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 debe 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

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 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 configurado como 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 direcciones que tu sistema marcaría como no válidos. En este punto, puedes determinar si el porcentaje de no validez es aceptable.

Es importante tener en cuenta que marcar direcciones como no válidas es una parte fundamental de la funcionalidad de la API de Address Validation, y un porcentaje alto de direcciones marcadas como no válidas no necesariamente refleja mal la API. La API te brinda información de que hay algo incorrecto en la dirección, y esto podría generar eficiencias en tu flujo de trabajo, ya que detecta errores antes de que causen 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 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 para 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 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

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 realizar correcciones en los datos de entrada, tomar una entrada de dirección potencialmente no válida y generar datos de direcciones 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 configurados como true en cualquiera de los addressComponents.
  • verdict.hasInferredComponentso 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 aplicó una corrección.

Una parte de estos datos se puede revisar manualmente 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

Route 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 subdirecciones faltantes o incorrectos

La API de Address Validation puede determinar si falta una subdirección o si es incorrecta para las direcciones de EE.UU.

Los indicadores clave que debes buscar son los siguientes:

  • En el objeto Address:
    • unconfirmedComponentTypes contiene subpremise.
    • missingComponentTypes contiene subpremise.
  • En el objeto UspsData:
    • dpvConfirmation es D (falta la subdirección).
    • dpvConfirmation es S (la subdirección no está confirmada).

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 subdirecciones faltantes o incorrectas, como números de departamentos. Esto puede causar problemas posteriores, en especial para los casos de uso de entrega. La API de Address Validation puede agregar valor a tu flujo de trabajo si identifica esto antes, lo que te permite implementar pasos para recopilar datos corregidos.

Ejemplo: Subdirección faltante

Dirección ingresada

Región

111 8th Avenue, Manhattan, NY 10011

EE.UU.

Componente faltante

"missingComponentTypes": [
    "subpremise"
]

Confirmación de DPV de datos de USPS

"dpvConfirmation": "D"

[Solo en EE.UU.] Revisa la dirección estandarizada de USPS

La API de Address Validation también muestra la dirección estandarizada de USPS para las direcciones de Estados Unidos. Esto es muy 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 agrega 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. Inicia hoy mismo las pruebas de la API de Address Validation para garantizar datos de direcciones precisos, mejorar la experiencia del cliente y optimizar tus operaciones comerciales. Después de seguir los casos de prueba descritos anteriormente, tendrás la información que necesitas para determinar si la API de Address Validation aportará valor a tu flujo de trabajo.

Lectura adicional sugerida:

Colaboradores

Henrik Valve | Ingeniero de DevX