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 quieras encontrar una forma 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.
• 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 A/B 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 se incluye a modo de guía de integración. Debes asegurarte de que la calidad sea adecuada antes de usarla en tus aplicaciones. La asistencia está disponible en los productos, como la API de Address Validation que se usa en este ejemplo.

Puedes ejecutar direcciones en 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 Cloud Console.
   
3. En la pestaña de Hojas de cálculo “Clave de API + panel”, reemplaza la celda B2 por tu clave de API.
   
4. Copiar y pegar direcciones en la plantilla (en una hoja separada para dar formato a los datos: concatenar número de calle, nombre, ciudad y código postal)
   
5. Selecciona las celdas de la hoja y, luego, elige en el menú “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 terceros de confianza y borrar la clave en la consola cuando termines 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 para 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 los 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
  
• veredicto
  
• formattedAddress
  
• postalAddress
  
• addressComponent: componentName
  
• USPS Data standardizedAddress
  

Consideraciones

• Rendimiento: Procede en fragmentos de 1,000 filas como máximo 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 compra de comercio electrónico
• Biblioteca de High Volume Address Validation

Colaboradores

Google mantiene este artículo. Los siguientes colaboradores escribieron el texto original.
Autor principal:

Thomas Anglaret | Ingeniero de soluciones\