Geocodio se ganó su reputación con una geocodificación por lotes sencilla, y bastantes integraciones construidas sobre él dependen mucho de ese comportamiento por lotes. Nuestro host compatible replica exactamente tanto la estructura de las consultas individuales como la de las solicitudes por lotes, para que esa dependencia no se convierta en un obstáculo para cambiar.
El host reproduce con precisión los parámetros de solicitud y el cuerpo de respuesta de Geocodio, salvo los textos de copyright, términos y privacidad, que son propios de My Geocode. Las solicitudes preparadas actualmente para los endpoints de Geocodio, individuales o por lotes, pueden enviarse a nuestro host tal cual, y las respuestas se analizan de la misma forma que el código existente ya espera.
Las solicitudes por lotes se cuentan aquí igual que en toda la plataforma: cada dirección dentro de una llamada por lotes cuenta como una solicitud, no la llamada en su conjunto. Así el seguimiento de la cuota es exacto tanto si una llamada lleva una dirección como si lleva muchas.
Un lote de quinientas direcciones enviado en una sola llamada se contabiliza como quinientas solicitudes frente a la cuota, y frente al crédito prepago si las cuotas gratuitas ya se han agotado, igual que lo serían quinientas llamadas separadas. Esa granularidad es lo que permite que X-Quota-Used y X-Credits-Remaining sean exactos en el momento en que termina un lote grande, en lugar de ajustarse unos minutos después cuando algún proceso en segundo plano se pone al día.
La autenticación usa nuestras cuatro opciones estándar: una cabecera X-API-Key, una cabecera Authorization: Bearer, autenticación HTTP Basic con la clave como nombre de usuario o un parámetro de consulta, según lo que ya use tu integración actual con Geocodio.
Los precios son los mismos en toda la plataforma. Cualquier dirección recibe 2.500 solicitudes gratuitas al día sin necesidad de clave, contadas por red. Una clave añade sus propias 2.500 solicitudes gratuitas al día. Más allá de eso, el crédito prepago cuesta 0,0001 € por solicitud, o un paquete Unlimited lo cubre todo por 50 € al mes, con la misma tarifa para consultas individuales y para elementos de lotes.
Los códigos de cupón del panel son una forma habitual de probar una migración con mucho uso de lotes como esta sin comprometer antes presupuesto real: aplican un saldo de crédito a la cuenta antes de decidir si financiarla en serio mediante crédito prepago o un paquete Unlimited.
Las cabeceras de cuota acompañan a cada respuesta, por lotes o individual: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used y X-Credits-Remaining reflejan exactamente cuántos elementos ha consumido un lote, con una precisión fácil de tener en cuenta al planificar.
Si un proyecto quiere más que la respuesta compatible estándar, mg_extras=1 en la solicitud, o una cabecera X-MG-Extras, agrega campos extra opcionales sin tocar la estructura base a menos que se solicite explícitamente.
El host está documentado en /compatibility/geocodio/, y la guía general para migrar una integración existente está en /docs/compatibility/. Probar una llamada por lotes contra el nuevo host es una forma rápida de confirmar que el conteo de la cuota se comporta exactamente como se espera antes de confiarle volumen real.