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 por correo y encuentra las coordenadas de latitud y longitud más conocidas para ella. De forma 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 la entrega y reducir los errores de entrega, lo que proporciona una mejor experiencia del cliente. Para ello, debes detectar las direcciones incorrectas y obtener un mejor conocimiento de sus características.

La API de Geocoding podría ser una mejor opción para tus necesidades si no necesitas validar los componentes individuales de la dirección. La API de Geocoding convierte direcciones en coordenadas de latitud y longitud. La API de Address Validation valida las direcciones para verificar su corrección. Consulta Cómo crear una función de validación de ubicación de edificios con Google Maps Platform en Architecture Center para ver 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 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 que usa la API:

1. El cliente ingresa una dirección: En la siguiente imagen, se muestra un formulario básico 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 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 determine la API o indica dónde falta información.

4. El cliente corrige o confirma la dirección recomendada: Según lo que muestre la API, puedes proporcionarle al cliente las siguientes indicaciones:

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

   • Pídele al cliente que agregue la información faltante:
     

   • Pídele al usuario que corrija la dirección si la API no puede validar la dirección de entrada debido a que falta información o esta es incorrecta:
     

Cómo funciona la API de Address Validation

La validación de direcciones 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 los componentes, incluidas las subdependencias, cuando están disponibles.
• Completa: Intenta inferir los componentes de la dirección faltantes o incorrectos.
• Con formato correcto: Limpia y estandariza el formato de los componentes de la 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 que se muestran
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, haz lo siguiente: Geocodificación Precisión de las direcciones Datos de los servicios postales, si están disponibles Consulta Cómo interpretar 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 formatos de direcciones, tanto correctos como incorrectos. La demostración proporciona una forma útil de explorar los valores que muestra el servicio, así como la respuesta de la API con formato JSON.
2	Cómo verificar la cobertura	Revisa los detalles de la cobertura para ver qué países y regiones admite la API de Address Validation.
3	Prepárate	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 una 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	Cómo procesar una respuesta	La respuesta de la API de Address Validation proporciona dos propiedades, cada una de las cuales se usa de diferentes maneras. Consulta Comprende 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.

Información acerca de CASS™

United States Postal Service® (USPS®)¹ mantiene el Coding Accuracy Support System (CASS™) para respaldar y certificar a los proveedores de validación de direcciones. Un servicio con certificación del CASS™, como la API de Address Validation, se confirmó por su capacidad para completar la información que falta en 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 en las regiones "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 del uso de los servicios del USPS, este evalúa las solicitudes de direcciones creadas de forma 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. Cuando usas la API, aceptas estas Condiciones Específicas del Servicio.

¿Qué sigue?

• Revisa las preguntas frecuentes: Ve a Preguntas frecuentes.
• Revisar las áreas de cobertura: Ve a Detalles de la cobertura por país y región.
• Procesa direcciones a gran volumen: Ve a Cómo usar la API de Address Validation para procesar direcciones a gran volumen