Procesar una lista de direcciones de una en una, una llamada HTTP tras otra, funciona bien con volúmenes pequeños y se vuelve tedioso enseguida a cualquier escala real. Ahora admitimos el envío de una lista completa de direcciones en una sola llamada masiva, lo que reduce los viajes de ida y vuelta necesarios para procesar una lista grande sin cambiar cómo se cobra nada.
La regla de recuento aquí es exactamente la misma que aplicamos en el resto de la plataforma: cada dirección dentro de una llamada masiva cuenta como una solicitud, no la llamada en su conjunto. Si envías una lista de quinientas direcciones en una llamada masiva, se consumen quinientas solicitudes de la cuota que corresponda, ya sea la cuota diaria gratuita, el crédito prepago a 0,0001 € por solicitud o la cobertura de un paquete Unlimited. No hay descuento ni penalización por agrupar el trabajo en una sola llamada en lugar de enviarlo en muchas más pequeñas.
Las cabeceras de cuota también reflejan con precisión la llamada masiva. X-Quota-Used, X-Quota-Free-Remaining y X-Credits-Remaining cambian según el número de direcciones realmente procesadas en la llamada, de modo que una solicitud masiva grande actualiza tu cuota visible igual que lo habrían hecho quinientas llamadas individuales, solo que en un único viaje de ida y vuelta en lugar de quinientos.
Está pensado exactamente para el tipo de carga de trabajo que antes obligaba a escribir un bucle de llamadas de una sola dirección: importar una lista de clientes que necesita geocodificación, depurar una base de datos de direcciones o preparar un trabajo por lotes grande que se ejecuta de forma programada y no en respuesta a una acción concreta de un usuario. Enviar esa lista en una sola llamada masiva reduce la carga de gestionar muchas conexiones HTTP separadas, algo especialmente útil para trabajos que se ejecutan en una infraestructura con sus propias restricciones de conexiones o de frecuencia, además de las nuestras.
La autenticación y el comportamiento general no cambian: funcionan los mismos cuatro métodos para enviar la clave, se aplican las mismas reglas de cuota y la misma cuota gratuita cubre pruebas significativas antes de que haya ningún coste real. Como con cualquier consulta basada en direcciones, los resultados de geocodificación directa e inversa siguen formando parte de nuestro backend en desarrollo para resultados reales completos, así que esta función masiva se documenta centrándose específicamente en la estructura de la solicitud y en el recuento.
La documentación completa para enviar solicitudes masivas, incluido el formato de la solicitud, está disponible en /docs/forward-geocoding/ y /docs/reverse-geocoding/. Si tu flujo de trabajo recorre ahora en bucle llamadas de una sola dirección, merece la pena echarle un vistazo para todo lo que procese más de unas pocas direcciones a la vez.