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 Google Sheets 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, te recomendamos que encuentres 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, te recomendamos que pruebes rápidamente las funciones 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 variaciones de A/B 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á solicitudes en secuencia a la API de Address Validation.

Sugerencia: Este ejemplo solo tiene fines de integración. Debes asegurarte de la calidad antes de usarlo con tus aplicaciones. Hay asistencia disponible en los productos como la API de Address Validation que se usa en este ejemplo.

Puedes ejecutar direcciones a través de la API siguiendo los pasos que se indican a continuación (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 de Hojas de cálculo “Clave de API + Panel”, reemplaza la celda B2 por tu clave de API.
   
4. Copiar y pegar las direcciones en la plantilla (en una hoja independiente 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” > “Selección de la API de Address Validation”.
   
6. En la primera ejecución, aparecerá el mensaje “Se requiere autorización” para otorgar acceso a Apps Script.
   

Precaución: Para proteger tu clave de API, restringe 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 borra la clave en la consola una vez que hayas terminado 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, 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 de Condiciones del Servicio de Google Maps Platform 11.3.1 (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, no más de una sola vez. La secuencia de comandos puede detenerse, 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 hacer 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 personas 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.

Acciones siguientes

Lecturas adicionales sugeridas:

• Validación de direcciones para la confirmación de la compra de comercio electrónico
• Biblioteca de validación de direcciones de alto volumen

Colaboradores

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

Thomas Anglaret | Ingeniero de soluciones\