Validación de direcciones en Hojas de cálculo de Google

Objetivo

En este documento, veremos cómo usar la API de Address Validation en Hojas de cálculo de Google para probar el servicio de forma rápida y sencilla.

Si no eres desarrollador, pero quieres trabajar con datos provenientes de Google Maps Platform, como la API de Address Validation, es posible que quieras encontrar una forma de comenzar a usar el servicio sin demasiada ayuda de los equipos técnicos.

Casos de uso

Ahora, analicemos los casos de uso en los que la API de Address Validation en Hojas de cálculo de Google es útil:

• Prueba: Como empresa, es posible que quieras probar rápidamente las capacidades de la API de Address Validation con tus propias direcciones.
• Comparar: Compara los resultados de la API de Address Validation con los de otros extremos, como la API de Geocoding o la API de Places.
• Prueba A/B: Prueba las variaciones de un mismo conjunto de datos para comprender qué podría proporcionar resultados más adecuados.
  

Plantilla de Hojas de cálculo de Google

La solución es una Hoja de cálculo de Google que incluye funciones personalizadas de Apps Script que realizarán solicitudes en secuencia a la API de Address Validation.

Nota: Este ejemplo solo sirve como guía para la integración. Debes garantizar la calidad antes de usarla con tus aplicaciones. La asistencia está disponible en los productos, como la API de Address Validation, que se usan en este ejemplo.

Puedes ejecutar direcciones con la API siguiendo los pasos que se indican a continuación (se requiere una Cuenta de Google y una clave de API):

1. Navega a la hoja de cálculo de ejemplo y, en el menú, selecciona Archivo > Crear una copia
   (debes acceder a tu Cuenta de Google o crear una).
   
2. Habilita la API de Address Validation y genera una clave de API desde la consola de Cloud.
   
3. En la pestaña “API Key + Dashboard” de la hoja de cálculo, reemplaza la celda B2 por tu clave de API.
   
4. Copia y pega las direcciones en la plantilla (en una hoja separada para dar formato a los datos: concatena el número de calle, el nombre, la ciudad y el código postal).
   
5. Selecciona las celdas de la hoja y, luego, en el menú, selecciona “Address Validation” > “Address Validation API selection”.
   
6. En la primera ejecución, aparecerá un mensaje de “Se requiere autorización” para proporcionar acceso a Apps Script.
   

Precaución: Protege tu clave de API restringiendo su uso solo a la API de Address Validation. Para evitar un uso inesperado, asegúrate de compartir tu hoja solo con partes de confianza y borra tu clave en la consola después de terminar el análisis.

Sugerencia: Para cumplir con las Condiciones de Google Maps Platform, asegúrate de borrar la hoja de cálculo después de 30 días, ya que Hojas de cálculo de Google tiene un historial integrado.

Condiciones de Google Maps Platform

La Solución se proporciona con fines de prueba en un conjunto limitado de direcciones: Período de almacenamiento en caché permitido: 30 días corridos consecutivos, después de los cuales el Cliente debe (1) borrar el Contenido de Google Maps almacenado en caché o (2) reemplazarlo por datos del Usuario Final proporcionados a través de la confirmación o corrección del Usuario Final. Consulta la tabla 11.3.1 (Permisos de almacenamiento en caché) de las Condiciones del Servicio de Google Maps Platform:

• placeId
  
• Ubicación: valores de latitud y longitud
  
• veredicto
  
• formattedAddress
  
• postalAddress
  
• addressComponent: componentName
  
• USPS Data standardizedAddress
  

Consideraciones

• Rendimiento: Procede en fragmentos de 1,000 filas, no más, a la vez. La secuencia de comandos puede detenerse en algún momento, por ejemplo, cuando se supera la cuota de la API por segundo, y continuar desde la fila en la que se detuvo.
• Puedes acceder al código desde Menú > Extensiones > Apps Script y crear tu propia versión de la secuencia de comandos adaptada a tus necesidades.
• Precios de la API de Address Validation

Conclusión

La API de Address Validation en Hojas de cálculo de Google permite que los usuarios que no son desarrolladores comiencen a consultar la API de Address Validation y comprendan cómo puede ser estratégica para su empresa. En este documento, se intenta demostrar cómo cualquier persona puede comenzar a consultar la API creando una clave de API y usando la plantilla de Hojas de cálculo de Google proporcionada.

Próximas acciones

Lecturas adicionales sugeridas:

• Address Validation para la confirmación de la compra en el comercio electrónico
• Biblioteca de High Volume Address Validation

Colaboradores

Google mantiene este artículo. Los siguientes colaboradores lo escribieron originalmente.
Autor principal:

Thomas Anglaret | Ingeniero de soluciones\