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 ligera.

Si no eres desarrollador y estás dispuesto a trabajar con datos provenientes de Google Maps Platform como la API de Address Validation, te recomendamos que busques la manera de comenzar a usar el servicio sin necesidad de obtener ayuda de los equipos técnicos.

Casos de uso

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

• 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 resultados, 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 Hojas 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 está destinado únicamente a orientación sobre 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 usa en este ejemplo.

Para ejecutar direcciones mediante la API, sigue 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. Copia y pega las direcciones en la plantilla (en una hoja aparte para darles formato a los datos: concatena el número de calle, el nombre, la ciudad y el código postal).
   
5. Selecciona las celdas de las hojas y, luego, en el menú "Address Validation" > "Address Validation API selection".
   
6. En la primera ejecución, aparecerá el mensaje “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 la hoja solo con personas de confianza y borrar la clave en la consola después de que hayas terminado con 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 calendario consecutivos. Después de ese período, el Cliente debe (1) borrar el Contenido de Google Maps almacenado en caché o (2) reemplazar con datos de 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 standardAddress
  

Consideraciones

• Rendimiento: Continúa en fragmentos de 1,000 filas, no más a la vez. La secuencia de comandos puede detenerse finalmente, por ejemplo, cuando se excede la cuota de API por segundo, procede desde la fila en la que se detuvo la secuencia de comandos.
• Puedes acceder al código en Menú > Extensiones > Apps Script y crear tu propia versión de la secuencia de comandos que se adapte 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 quienes no son desarrolladores comiencen a consultar la API de Address Validation y comprendan cómo puede ser estratégica para su negocio. En este documento, se intenta demostrar cómo cualquier persona puede comenzar a realizar consultas en la API. Para ello, debes crear una clave de API y usar la plantilla proporcionada de Hojas de cálculo de Google.

Acciones siguientes

Lecturas adicionales sugeridas:

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

Colaboradores

Google conserva este artículo. Los siguientes colaboradores la escribieron originalmente.
Autor principal:

Thomas Anglaret | Ingeniero de soluciones\