Descripción general de la API de Address Validation

Introducción

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 por correo 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 Coding Accuracy Support System (CASS™).

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 en ellas, lo que mejora la experiencia del cliente. Para ello, detecta las direcciones incorrectas y obtiene un mejor conocimiento de las características de las direcciones.

La API de Geocoding podría ser más adecuada para tus necesidades si no necesitas validar los componentes de dirección individuales. La API de Geocoding convierte direcciones en coordenadas de latitud y longitud. La API de Address Validation valida la corrección de las direcciones. Consulta Cómo crear una capacidad de validación de ubicaciones con Google Maps Platform en el Centro de arquitectura para obtener una comparación detallada.

Qué puedes hacer con la API de Address Validation

inputProbar la demostración

Con la API de Address Validation, puedes determinar si una dirección hace referencia a un lugar real. Si la dirección no hace referencia 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 ejemplo con la API:

1. El cliente ingresa una dirección: En la siguiente imagen, se muestra un formulario básico que permite que un cliente ingrese una dirección, posiblemente como parte de un flujo de confirmación de compra.

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

   

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

4. El cliente confirma o corrige la dirección: Según lo que devuelva la API, puedes proporcionar las siguientes indicaciones al cliente: A. Confirma la dirección recomendada. B. Proporciona la información faltante. C. Corrige la dirección.

   

Cómo funciona la API de Address Validation

La validación de direcciones acepta una solicitud POST con la dirección en forma de un cuerpo JSON. Separa la dirección en sus componentes individuales y, luego, intenta lo siguiente:

• Corrige: Proporciona verificaciones de validación a nivel del componente, incluidas las subinstalaciones cuando están disponibles.
• Completa: Intenta inferir los componentes de dirección faltantes o incorrectos.
• Formatos: Limpia y estandariza el formato de los componentes de la direcció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 devuelve. Para obtener detalles específicos, consulta la referencia de la API de Address Validation.

Recursos de datos	Datos devueltos
Componentes de la dirección en formato JSON. Consulta Cómo validar una dirección.	Dirección completa y validada (si es posible) Es el estado de validación de cada componente de la dirección. Cuando está disponible para una dirección, se muestra de la siguiente manera: Geocodificación Precisión de la dirección Datos de servicios postales, cuando estén disponibles Consulta Cómo interpretar la respuesta de validación.

Cómo usar la API de Address Validation

1	Probar la demostración	Explora la demostración con una variedad de formularios de direcciones, tanto correctos como incorrectos. La demostración proporciona una forma útil de explorar tanto los valores de devolución del servicio como la respuesta de la API con formato JSON.
2	Comprobar la cobertura	Revisa los detalles de cobertura para ver qué países y regiones admite la API de Address Validation.
3	Inicia la configuración	Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones que se indican a continuación.
4	Cómo solicitar una validación de dirección	Comienza con una dirección básica y, luego, para mayor precisión, puedes habilitar CASS (solo para direcciones de EE.UU. y Puerto Rico). Consulta Cómo solicitar una validación de dirección.
5	Procesa una respuesta	La respuesta de la API de Address Validation proporciona dos propiedades, cada una de las cuales se usa de diferentes maneras. Consulta Cómo comprender una respuesta básica.
6	Mejora la precisión de la validación	Puedes ayudar a mejorar la precisión de las direcciones proporcionando comentarios sobre las respuestas de la API de Address Validation. Consulta Cómo controlar las direcciones actualizadas.

Bibliotecas cliente disponibles

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

Acerca de CASS™

El United States Postal Service® (USPS®)¹ mantiene el Coding Accuracy Support System (CASS™) para respaldar y certificar a los proveedores de validación de direcciones. Se confirmó que un servicio con certificación CASS Certified™, como la API de Address Validation, tiene la capacidad de completar la información que falta en una dirección, estandarizarla y actualizarla para brindarte la dirección más actual y precisa.

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

Como parte de nuestro uso de los servicios de USPS, esta empresa evalúa las solicitudes de direcciones creadas artificialmente. Si el USPS identifica una dirección de entrada como creada de forma artificial, Google debe dejar de validar direcciones para el cliente y debe informar al USPS la información de contacto del cliente (nombre y dirección), la dirección de entrada pertinente y los datos de uso agregados. Cuando usas la API, aceptas estas Condiciones Específicas del Servicio.

¿Qué sigue?

• Probar la demostración: Ve a Demostración
• Revisa las áreas de cobertura: Ve a Detalles de la cobertura por país y región
• Prueba tu primera solicitud de validación: Ve a Envía una solicitud de validación de dirección
• Procesa direcciones en grandes cantidades: Consulta Cómo usar la API de Address Validation para procesar direcciones en grandes cantidades