Controla el uso de tu clave antes de alcanzar un límite
Vigilar las cabeceras de cuota sobre la marcha te indica cuándo te acercas a un límite, mucho antes de que se rechace realmente una solicitud.
Geocodifica una hoja de cálculo de direcciones con una sola solicitud por lotes
Una hoja de cálculo llena de direcciones no necesita un bucle. Todos los endpoints de My Geocode aceptan una solicitud POST con un array JSON en lugar de parámetros de consulta, y el endpoint de geocodificación directa acepta una columna entera de direcciones a la vez y devuelve un resultado geocodificado por fila en el mismo orden en que las enviaste.
Construir la solicitud
Exporta la columna de direcciones de tu hoja de cálculo como un array simple de cadenas y envíalo por POST a /v1/forward. Cada elemento del array se trata como una consulta independiente y devuelve su propio resultado, en el mismo orden en que los enviaste.
POST /v1/forward
Content-Type: application/json
["221B Baker Street, London", "1600 Pennsylvania Avenue, Washington"]{
"status": "ok",
"results": [
{"formatted": "221B Baker Street, London, UK", "lat": 51.5237, "lon": -0.1585, "type": "address", "precision": "house", "confidence": 0.95, "place_id": "abc123", "components": {}},
{"formatted": "1600 Pennsylvania Avenue, Washington, DC", "lat": 38.8977, "lon": -77.0365, "type": "address", "precision": "house", "confidence": 0.97, "place_id": "def456", "components": {}}
]
}Acotar resultados con una lista de países mezclados
Si tu hoja de cálculo abarca varios países, un array simple de cadenas sigue funcionando, pero los nombres de calles ambiguos en distintos países pueden acabar resolviéndose en el país equivocado. Si tu hoja de cálculo tiene una columna de país separada, envía las filas de cada país como un lote propio con el parámetro countries configurado con el código ISO correspondiente, en lugar de mezclar países en una sola llamada y esperar que el texto de la dirección baste para desambiguarlos.
Lo que cuesta
Una solicitud masiva se factura por elemento, no por llamada. Dos direcciones en un POST consumen dos solicitudes de tu cuota diaria, exactamente igual que si hubieras enviado dos solicitudes GET por separado. Una hoja de cálculo de 500 filas cuesta 500 solicitudes, holgadamente dentro de las 2.500 solicitudes gratuitas al día que vienen con cada clave, o incluso sin clave.
Volver a emparejar las filas
Los resultados vuelven en el mismo orden que el array que enviaste, así que conserva el índice de fila original junto a cada dirección antes de enviar la solicitud. Cuando llegue la respuesta, empareja los resultados con las filas de tu hoja de cálculo por posición, no comparando texto, ya que la dirección formateada de la respuesta rara vez será idéntica a lo que escribiste.
Gestionar fallos parciales
Una fila sin resultado, con una puntuación de confianza baja o con una precisión inferior a la que necesitas debería marcarse en lugar de aceptarse automáticamente. Comprueba el campo confidence de cada elemento y envía todo lo que esté por debajo de tu propio umbral a una lista de revisión manual.
Un caso límite: filas en blanco
La exportación de una hoja de cálculo suele traer unas cuantas filas completamente en blanco cerca del final del archivo, restos de formato o de un filtro que en su día incluyó celdas vacías. Una cadena vacía en el array sigue contando como un elemento y normalmente devuelve un resultado vacío o de confianza muy baja, que luego hay que filtrar antes de que llegue a tu tabla de datos, así que elimina las filas en blanco al exportar en lugar de enviarlas en el lote.
Un error que conviene evitar
Enviar la misma dirección dos veces, una desde una lista de clientes activos y otra desde una exportación antigua que nunca se limpió, es una forma fácil de gastar una buena parte de tu cuota diaria en trabajo duplicado. Elimina los duplicados de la columna de direcciones antes de construir el array y vuelve a procesar solo las filas que hayan cambiado desde la última exportación, en lugar de geocodificar de nuevo toda la hoja de cálculo cada vez que se añaden unas pocas filas.
Dividir archivos grandes
Los archivos muy grandes son más fáciles de gestionar en bloques de unos cientos a unos miles de filas. Dividirlos en bloques también facilita revisar tus encabezados de cuota entre lotes y detenerte antes de superar tu cuota gratuita o tu crédito prepago.
Si tu hoja de cálculo tiene más de unas pocas filas, esta es la diferencia entre una solicitud y cientos de idas y vueltas. La estructura completa de solicitud y respuesta está documentada en la página de geocodificación directa.