Envía una llamada a la API con cien direcciones dentro y esa llamada consume cien solicitudes, no una. Contamos individualmente cada elemento de una solicitud masiva o por lotes. Es una regla sencilla, pero vale la pena explicarla con claridad, porque determina cómo se debe planificar y presupuestar un trabajo por lotes.
La lógica es sencilla en cuanto piensas en lo que hace realmente una llamada por lotes. Una sola solicitud HTTP que geocodifica cien direcciones supone cien unidades de trabajo por nuestra parte: cien consultas, cien respuestas, cien líneas en la respuesta. Cobrar eso como si fuera una sola solicitud significaría cobrar una fracción de céntimo por lo que en realidad son cien datos distintos. Contar por elemento mantiene el precio ligado al trabajo realmente realizado, no a cuántas veces abriste una conexión.
Esto se aplica igual tanto si estás cerca del nivel gratuito como si pagas por lo que usas. Si a tu red aún le quedan 400 solicitudes de su cuota gratuita diaria y envías un lote de 1.000 direcciones, 400 de esos elementos quedan cubiertos por la cuota gratuita y los 600 restantes se descuentan del crédito prepago o de un paquete Unlimited. Los encabezados de cuota de la respuesta lo reflejan exactamente: X-Quota-Used avanza según el número de elementos, no según el número de llamadas, y X-Credits-Remaining refleja lo que el lote haya consumido más allá de la parte gratuita.
También significa que no hay ningún incentivo para dividir el trabajo en muchas llamadas pequeñas con el fin de engañar a la cuota, ni ninguna penalización por agrupar el trabajo en menos llamadas más grandes. Cien llamadas de un elemento y una llamada de cien elementos cuestan lo mismo y cuentan lo mismo. Elige la forma que le resulte más fácil de escribir a tu código y de ejecutar a tu infraestructura. Algunos equipos prefieren muchas llamadas pequeñas porque es más sencillo reintentar un fallo. Otros prefieren una llamada grande porque supone menos idas y vueltas. Ambas opciones tienen exactamente el mismo precio.
A efectos de planificación, esto facilita mucho los cálculos de capacidad. Si un trabajo diario tiene que procesar 50.000 direcciones, son 50.000 solicitudes, sin más, tanto si se envían en una llamada como en diez o en quinientas. A 0,0001 € por solicitud por encima de la cuota gratuita, ese cálculo se hace en segundos sobre el papel.
Todos los endpoints y todos los hosts compatibles siguen el mismo recuento por elemento para las operaciones por lotes y masivas. No existe un nivel de precios por lotes aparte más barato ni otro más caro. Una consulta cuesta lo mismo tanto si llega sola como dentro de una lista con otras mil.
Si estás construyendo un trabajo por lotes con My Geocode, planifica tu volumen de solicitudes contando las direcciones, coordenadas o IP que envías, no el número de llamadas HTTP que las transportan. Ese número es el que aparece en tu cuota y el que reflejará cualquier factura.