API de Address Validation 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 de Google Maps Platform, como la API de Address Validation, es posible que desees encontrar una manera de comenzar a usar el servicio sin demasiada ayuda de los equipos técnicos.

Casos de uso

Ahora, veamos 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 desees probar rápidamente las capacidades de la API de Address Validation con tus propias direcciones.
• Comparación: Compara los resultados de la API de Address Validation con los resultados de otros extremos como la API de Geocoding o la API de Places.
• Prueba A/B: Realiza pruebas A/B de variaciones del 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 tiene como objetivo brindar orientación para la integración. Debes garantizar la calidad antes de usarlo 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 a través de 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 muestra 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 Hojas 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 la calle, el nombre, la ciudad y el código postal).
   
5. Selecciona las celdas de las hojas y, luego, en el menú, selecciona “Address Validation” > “Address Validation API selection”.
   
6. En la primera ejecución, aparecerá un mensaje de “Authorization Required” 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 el uso inesperado, asegúrate de compartir tu hoja solo con partes de confianza y borrar la clave en la consola después de terminar el análisis.

**Nota:** 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 naturales 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 de las Condiciones del Servicio de Google Maps Platform (Permisos de almacenamiento en caché):

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

Consideraciones

• Rendimiento: Procede en fragmentos de 1,000 filas, no más a la vez. El script puede detenerse, por ejemplo, cuando se excede la cuota de la API por segundo. Continúa desde la fila en la que se detuvo el script.
• Puedes acceder al código desde Menú > Extensiones > Apps Script y crear tu propia versión del script 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

Lectura adicional sugerida:

• Address Validation para la confirmación de compra de comercio electrónico
• Biblioteca de Address Validation de alto volumen

Colaboradores

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

Thomas Anglaret | Ingeniero de soluciones