Descripción general de la API de Address Validation

La API de Address Validation es un servicio que acepta una dirección, identifica sus componentes y los valida. También estandariza la dirección para el correo y encuentra la ubicación de latitud y longitud más conocida. Puede ayudar a comprender si una dirección se refiere a un lugar real. Si la dirección no se refiere a un lugar real, puede identificar componentes posiblemente incorrectos, lo que permite a los usuarios corregirlos.

La API de Address Validation proporciona muchas funciones que te ayudan a procesar una dirección, entre ellas:

  • Separa la dirección en sus componentes individuales y, luego, proporciona verificaciones de validación a nivel de los componentes, incluidas las sublocales (si están disponibles).

  • Limpia, estandariza e infiere componentes de dirección incorrectos o faltantes.

  • Complementa la dirección con información adicional, como los datos de geocódigo, la precisión de la dirección y los datos de los servicios postales.

  • Muestra una sola string que contiene la dirección completa según lo determinado por la API.

Prueba la demostración para ver cómo funciona la API de Address Validation.

Agrega la API de Address Validation a tu flujo de trabajo

Uno de los casos prácticos más comunes de la API de Address Validation es garantizar que el cliente proporcione una dirección correcta para mejorar su experiencia. La validación de direcciones ayuda a reducir las fallas en la entrega, ya que detecta las direcciones incorrectas y mejora la previsibilidad de entrega con un mejor conocimiento de las características de la dirección.

En la siguiente imagen, se muestra un formulario simple que permite al cliente ingresar una dirección, posiblemente como parte de un flujo de confirmación de la compra. Pasa esta dirección como entrada para la API de Address Validation.

La dirección que ingresó el cliente.

En su respuesta, la API de Address Validation muestra la dirección completa según lo determina la API. Presenta la dirección completa a tu cliente como la dirección recomendada:

La dirección que determina la API.

Si la API de Address Validation detecta información que falta, pídele al usuario que la agregue:

El formulario que solicita al cliente que ingrese la información de dirección que falta.

Si la API no puede validar la dirección de entrada debido a información faltante o incorrecta, solicita al usuario que corrija la dirección:

El formulario que solicita al cliente que corrija la información de la dirección.

Diferencias entre la API de Address Validation y la API de Geocoding

Tanto la API de Geocoding como la API de Validación de dirección intentan responder la pregunta “¿cuál es la mejor ubicación para esta entrada del usuario?” A diferencia de la API de Geocoding, la API de Address Validation también intenta hacer lo siguiente:

  • Responde la pregunta "¿Esta entrada del usuario representa una dirección real?"
  • Comprender la dirección de entrada, incluso si partes de ella no pueden coincidir con los datos disponibles
  • Proporcione comentarios sobre la validez de los diferentes componentes
  • Verifica si la dirección está completa y marca los componentes necesarios que faltan
  • Da formato a la dirección que se muestra específicamente para el envío

Por ejemplo, dada una dirección como "123 Fake St, Mountain View, CA", la API de Geocoding simplemente mostrará un geocódigo para la ciudad de Mountain View, CA e ignorar "123 Fake St" ya que no existe esa calle (o calle con nombre similar) en Mountain View.

Por otro lado, la API de Address Validation, puede identificar que "123" es un número de calle, "Fake St" es una calle y muestra un resultado que contiene esos componentes y los marca como no confirmados, lo que te indica por qué la dirección no puede geocodificar.

Acerca de CASSTM

El Servicio Postal de los Estados Unidos® (USPS®)1 mantiene el Sistema de Asistencia para Exactitud de Codificación (CASSTM) a fin de brindar asistencia y certificar a los proveedores de validación de direcciones. Se confirmó un servicio de certificación CASS, como la API de Address Validation, para completar la información que falta en una dirección, estandarizarla y actualizarla a fin de brindarte la dirección más actual y precisa.

CASS no está habilitado de forma predeterminada y solo es compatible con las regiones “US” y “PR”. Para habilitar CASS, configura enableUspsCass como true como parte de una solicitud de validación. Para obtener más información, consulta Valida una dirección.

Como parte del uso de los servicios del USPS, este servicio evalúa las solicitudes de direcciones creadas de manera artificial. Si el USPS identifica que una dirección de entrada se creó de forma artificial, Google debe dejar de validar las direcciones del cliente y debe informar la información de contacto del cliente (nombre y dirección), la dirección de entrada relevante y los datos de uso agregados al USPS. Si usas la API, aceptas estas Condiciones específicas del servicio.

¿Qué sigue?


  1. Google Maps Platform es un licenciatario no exclusivo del Servicio Postal de los Estados Unidos®. Las siguientes marcas comerciales pertenecen a los Estados Unidos Service Postal® y se usan con permiso: United Postal Service®, CASSTM, CASS CertifiedTM.