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 en la entrega, lo que brinda una mejor experiencia del cliente. Para ello, detecta direcciones incorrectas y obtén un mejor conocimiento de sus características.
Es posible que la API de Geocoding se ajuste mejor a 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, mientras que la API de Address Validation valida las direcciones para garantizar su precisión. Consulta Compilación de la capacidad de validación de 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 hace referencia a un lugar real. Si la dirección no hace referencia a un lugar real, la API puede identificar posibles componentes incorrectos que puedes presentar a los clientes para que los corrijan. A continuación, se muestra 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 le 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 proporcionarle 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:
Solicita al usuario que corrija la dirección si la API no puede validar la dirección de entrada debido a información incorrecta o faltante:
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 instancias secundarias cuando estén disponibles.
- Completo: Intenta inferir los componentes de dirección faltantes o incorrectos.
- Con el formato correcto: Limpia y estandariza el formato para 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 y 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 Si está disponible para una dirección:
|
Cómo usar la API de Address Validation
1 | Probar 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 | Verifica la cobertura | Revisa los detalles de cobertura para ver con qué países y regiones es compatible la API de Address Validation. |
3 | Prepárate | Para comenzar, consulta Configura tu proyecto de Google Cloud y completa las siguientes instrucciones. |
4 | Cómo solicitar una validación de dirección | Comienza con una dirección simple y, luego, para mayor precisión, puedes habilitar el CASS (solo para direcciones de EE.UU. y PR). 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, que se usan de diferentes maneras. Consulta Comprende una respuesta básica. |
6 | Mejora la exactitud de la validación | Puedes ayudar a mejorar la precisión de las direcciones si proporcionas comentarios sobre las respuestas de la API de Address Validation. Consulta Cómo proporcionar comentarios de validación de direcciones. |
Bibliotecas cliente disponibles
Si quieres ver una lista de las bibliotecas cliente disponibles para la API de Address Validation, consulta Bibliotecas cliente.
Información acerca de CASSTM
El Servicio Postal de Estados Unidos® (USPS®)1 mantiene el Sistema de Asistencia de Precisión de Codificación (CASSTM) para respaldar y certificar a los proveedores de validación de direcciones. Un servicio con certificación CASSTM, como la API de Address Validation, está confirmado 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.
CASS no está habilitado de forma predeterminada y solo es compatible con las regiones "US" y "PR". Para habilitar el CASS, establece enableUspsCass
en 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 de USPS, este servicio evalúa las solicitudes de direcciones creadas de forma artificial. Si USPS identifica que una dirección de entrada se creó artificialmente, 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 a USPS. Si usas la API, aceptas estas Condiciones Específicas del Servicio.
Próximos pasos
- Revisa las Preguntas frecuentes: Consulta las Preguntas frecuentes.
- Revisa las áreas de cobertura: Ve a Detalles de cobertura por país y región.
- Procesar direcciones en un gran volumen: Ve a Usa la API de Address Validation para procesar direcciones en un gran volumen.
-
Google Maps Platform es un Licenciatario no exclusivo del Servicio Postal de los Estados Unidos®. Las siguientes marcas pertenecen al Servicio Postal de Estados Unidos® y se usan con permiso: United States Postal Service®, CASSTM y CASS CertifiedTM. ↩