Descripción general de la API de Address Validation

La API de Address Validation es un servicio que acepta una dirección. Identifica los componentes de la dirección y los valida. También estandariza la dirección para el envío de correos y encuentra las coordenadas de latitud y longitud más conocidas para ella. De manera opcional, para las direcciones de Estados Unidos y Puerto Rico, puedes habilitar el Sistema de asistencia de precisión de programación (CASSTM).

Por qué usar la API de Address Validation

Con la API de Address Validation, puedes mejorar la previsibilidad de las entregas y reducir los errores de entrega, lo que proporciona una experiencia del cliente mejorada. Para ello, se detectan las direcciones incorrectas y se conocen mejor las características de las direcciones.

Es posible que la API de Geocoding se adapte mejor a tus necesidades si no necesitas validar los componentes individuales de la dirección. La API de Geocoding convierte las direcciones en coordenadas de latitud y longitud, mientras que la API de Address Validation valida las direcciones para verificar que sean correctas. Consulta Cómo compilar la capacidad de validación de la ubicación con Google Maps Platform en el Centro de arquitectura para obtener una comparación detallada.

Qué puedes hacer con la API de Address Validation

Con la API de Address Validation, puedes determinar si una dirección se refiere a un lugar real. Si la dirección no se refiere a un lugar real, la API puede identificar componentes posiblemente incorrectos que puedes presentar a tus clientes para que los corrijan. A continuación, se muestra un flujo de trabajo de muestra con la API:

1. El cliente ingresa una dirección: En la siguiente imagen, se muestra un formulario simple que le permite al cliente ingresar una dirección, posiblemente como parte de un flujo de confirmación de la compra.
   

2. La app envía la dirección a la API: La aplicación pasa esta dirección como la entrada a la API de Address Validation.

3. La API valida y estandariza la dirección: En su respuesta, la API de Address Validation muestra la dirección completa según lo determinado por la API o indica dónde falta la información.

4. El cliente corrige o confirma la dirección recomendada: según lo que muestre la API, puedes proporcionarle los siguientes mensajes:

   • Presenta una dirección recomendada para que el cliente la confirme:
     

   • Solicítale al cliente que agregue la información que falta:
     

   • Solicita al usuario que corrija la dirección si la API no puede validar la dirección ingresada debido a que falta información o es incorrecta:
     

Cómo funciona la API de Address Validation

La validación de dirección acepta una solicitud POST con la dirección en forma de cuerpo JSON. Separa la dirección en sus componentes individuales y, luego, realiza las siguientes verificaciones y correcciones:

• Correcto: Proporciona verificaciones de validación a nivel de componente, incluidas las sublocales cuando estén disponibles.
• Completo: Intenta inferir los componentes de la dirección faltantes o incorrectos.
• Formato correcto: Limpia y estandariza el formato de los componentes de dirección.

Prueba la demostración para ver la API de Address Validation en acción.

Recursos

En la siguiente tabla, se resumen los recursos disponibles a través de la API de Address Validation junto con los datos que muestra. Para obtener detalles específicos, consulta la referencia de la API de Address Validation.

Recursos de datos	Datos mostrados
Componentes de la dirección en formato JSON. Consulta Valida una dirección.	Dirección completa y validada (si es posible). Estado de validación de cada componente de la dirección. Cuando esté disponible para una dirección: Geocodificación Precisión de las direcciones Datos de servicios postales, si están disponibles. Consulta Comprende la respuesta de validación.

Cómo usar la API de Address Validation

1	Prueba la demostración	Explora la demostración con una variedad de formularios de dirección, tanto correctos como incorrectos. La demostración proporciona una manera útil de explorar los valores que se muestran del servicio y la respuesta de la API con formato JSON.
2	Cómo comprobar la cobertura	Revisa los detalles de cobertura para ver qué países y regiones admite la API de Address Validation.
3	Preparación	Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones que se indican a continuación.
4	Cómo solicitar la validación de la dirección	Comienza con una dirección simple y, luego, para mayor precisión, puedes habilitar CASS (solo para direcciones de EE.UU. y PR). Consulta Cómo solicitar la validación de la dirección.
5	Cómo procesar una respuesta	La respuesta de la API de Address Validation proporciona dos propiedades, cada una de las cuales puedes usar de diferentes maneras. Consulta Comprende una respuesta básica.
6	Mejora la precisión de la validación	Para ayudar a mejorar la precisión de las direcciones, puedes proporcionar comentarios sobre las respuestas de la API de Address Validation. Consulta Cómo administrar direcciones actualizadas.

Bibliotecas cliente disponibles

Si quieres obtener una lista de las bibliotecas cliente disponibles para la API de Address Validation, consulta Bibliotecas cliente.

Acerca de CASSTM

El United States Postal Service® (USPS®)¹ mantiene el Coding Precision Support System (CASSTM) para admitir y certificar a los proveedores de validación de direcciones. Se confirmó un servicio CASS CertifiedTM, como la API de Address Validation, por su capacidad para completar la información que falta de una dirección, estandarizarla y actualizarla para brindarte la dirección más actual y precisa.

El CASS no está habilitado de forma predeterminada y solo se admite para las regiones "US" y "PR". Para habilitar CASS, establece enableUspsCass en true como parte de una solicitud de validación. Si deseas obtener más información, consulta Cómo validar una dirección.

Como parte de nuestro uso de los servicios del USPS, el USPS evalúa solicitudes de direcciones creadas artificialmente. 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. Cuando usas la API, aceptas estas Condiciones Específicas del Servicio.

¿Qué sigue?

• Consulta las Preguntas frecuentes: Ve a Preguntas frecuentes
• Revisa las áreas de cobertura: Consulta los Detalles de cobertura por país y región.
• Procesa direcciones en grandes volúmenes: Consulta Usa la API de Address Validation para procesar direcciones en grandes volúmenes