Por qué usar la API de Address Validation
Con la API de Address Validation, puedes mejorar la previsibilidad de la entrega y reducir las fallas de entrega, lo que proporciona una mejor experiencia del cliente. Para ello, detecta las direcciones incorrectas y obtén un mejor conocimiento de las características de las direcciones.
Si no necesitas validar los componentes de dirección individuales para tu solicitud, es posible que la API de Geocoding coincida mejor con tus necesidades. La API de Geocoding convierte las direcciones en coordenadas de latitud y longitud, mientras que la API de Address Validation valida que las direcciones sean correctas. Para obtener más información, consulta la sección Cómo funciona la API de Address Validation que se encuentra a continuación, así como la descripción general de la API de Geocoding.
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 hace referencia a un lugar real, la API puede identificar los componentes posiblemente incorrectos que puedes presentar a tus clientes para que corrijan. Este es un flujo de trabajo de muestra con la API:
El cliente ingresa una 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.
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.
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 información.
El cliente corrige o confirma la dirección recomendada: Según lo que muestre la API, puedes proporcionar los siguientes mensajes al cliente:
Presenta una dirección recomendada para que el cliente confirme lo siguiente:
Pídele al cliente que agregue la información que falta:
Pídele al usuario que corrija la dirección si la API no puede validarla debido a información faltante o incorrecta:
Cómo funciona la API de Address Validation
La validación de la dirección acepta una solicitud POST con la dirección en forma de un cuerpo JSON. Separa la dirección en sus componentes individuales y, luego, realiza las siguientes verificaciones y correcciones:
- Proporciona verificaciones de validación a nivel del componente, incluidas las sublocales cuando estén disponibles.
- Intenta inferir los componentes de dirección faltantes o incorrectos.
- Limpia y estandariza el formato para 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. Si quieres obtener detalles específicos, consulta la referencia de la API de Address Validation.
Recursos de datos | Datos mostrados |
---|---|
Componentes de 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:
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 varios formularios de dirección correctos e incorrectos. La demostración proporciona una forma útil de explorar los valores que se muestran del servicio y la respuesta de la API con formato JSON. |
2 | Prepárate. | Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones que aparecen a continuación. |
3 | Cómo validar una dirección | Comienza con una dirección simple y, luego, para mayor precisión, puedes habilitar CASS (solo para direcciones de EE.UU. y RR.PP.). Consulta Valida una dirección. |
4 | Cómo procesar una respuesta | La respuesta de la API de Address Validation proporciona dos propiedades, cada una de las cuales utilizarás de diferentes maneras. Consulta Comprende la respuesta de validación. |
5 | Mejora la precisión de la validación | Para ayudarnos a mejorar la precisión de las direcciones, envíanos comentarios sobre las respuestas de la API de Address Validation. Consulta Cómo proporcionar comentarios para la validación de dirección. |
Bibliotecas cliente disponibles
Si deseas obtener una lista de las bibliotecas cliente disponibles para la API de Address Validation, consulta Bibliotecas cliente.
Acerca de CASSTM
El Servicio Postal de los Estados Unidos® (USPS®)1 mantiene el Sistema de Asistencia de Precisión en la Codificación (CASSTM) para admitir 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 su información que falta en una dirección, estandarizarla y actualizarla a fin de brindarte la dirección más actual y más 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 de nuestro uso de los servicios USPS, USPS evalúa las solicitudes de direcciones creadas de forma artificial. Si el USPS identifica una dirección de entrada como creada 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, das tu consentimiento para estas Condiciones específicas del servicio.
Próximos pasos
- Revisar las Preguntas frecuentes: Ir a Preguntas frecuentes
- Revisa las áreas de cobertura: Ve a Detalles de la cobertura del país y la región.
- Procesar direcciones de gran volumen: Consulta Cómo utilizar la API de Address Validation para procesar direcciones de gran volumen.
-
Google Maps Platform es un licenciatario no exclusivo del Servicio Postal de los Estados Unidos®. Las siguientes marcas son propiedad del Servicio Postal de los Estados Unidos y se usan con permiso: Servicio Postal de los Estados Unidos, CASSTM, certificación de CASSTM. [=]