LocationIQ se ha ganado un lugar en muchos stacks que empezaron pequeños y crecieron, a menudo porque era fácil de adoptar al principio. Nuestro host compatible está pensado exactamente para ese tipo de integración: una que hoy funciona bien, que nunca se pensó como permanente y que simplemente nunca ha valido la pena reescribir.
El host reproduce exactamente los parámetros de solicitud y el cuerpo de respuesta de LocationIQ, salvo los textos de copyright, términos y privacidad, que son propios de My Geocode. Las solicitudes preparadas para los endpoints de LocationIQ pueden enviarse a nuestro host sin cambios, y la respuesta devuelta se analiza de la misma forma que el código existente ya espera.
Esa exactitud no depende del esfuerzo dedicado a cada proveedor. Todos los hosts compatibles se apoyan en el mismo sistema de facturación, cuotas y cuentas que hace funcionar el resto de My Geocode, así que construir uno nuevo es sobre todo un ejercicio de mapeo, hacer coincidir nombres de campos y formas de parámetros con lo que ya envían los clientes de un proveedor, y no montar un backend aparte. Por eso los precios, la autenticación y el seguimiento de la cuota se comportan igual en los diecisiete hosts en lugar de ir distanciándose entre sí con el tiempo.
La autenticación sigue el mismo patrón que en todos los hosts de la plataforma. Envía tu clave como cabecera X-API-Key, como cabecera Authorization: Bearer, mediante autenticación HTTP Basic con la clave como nombre de usuario o como parámetro de consulta, según lo que ya haga tu integración actual con LocationIQ. Las cuatro se aceptan aquí sin excepción, así que cambiar rara vez implica tocar tu cliente HTTP.
Los precios no cambian según el host o endpoint que atienda una llamada. Cualquier dirección recibe 2.500 solicitudes gratuitas al día sin necesidad de clave, contadas por red para que la cuota corresponda de forma lógica a una conexión compartida y no a cada dispositivo detrás de ella. Una clave añade otras 2.500 solicitudes gratuitas al día propias, contadas por separado de la cuota sin clave de la misma red. Superadas esas cuotas, el crédito prepago cuesta 0,0001 € por solicitud, o un paquete Unlimited lo cubre todo por 50 € al mes.
Cada respuesta incluye nuestro conjunto completo de cabeceras de cuota, sea cual sea el host compatible que la haya atendido: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used y X-Credits-Remaining se añaden a las respuestas de este host exactamente igual que a las de nuestros endpoints nativos, así que todo lo construido en torno a esas cabeceras sigue funcionando sin cambios.
Si un proyecto necesita más de lo que ofrece la respuesta compatible, mg_extras=1 en la solicitud, o una cabecera X-MG-Extras, agrega campos extra opcionales, totalmente a elección. En una llamada de geocodificación, eso puede incluir la elevación del terreno para las coordenadas devueltas, obtenida de la misma fuente que responde directamente a /v1/elevation. Si lo omites, el formato de respuesta coincide con precisión con la estructura de LocationIQ, sin sorpresas para la lógica de análisis existente.
Las cuentas que hacen el cambio y comprueban que aguanta con tráfico real a menudo acaban recomendándolo a quien siga pagando al proveedor original en su equipo. El programa de referidos del panel, en /dashboard/referrals, está pensado exactamente para ese tipo de boca a boca.
El host está documentado en /compatibility/locationiq/, con una guía general para cambiar de proveedor en /docs/compatibility/. Una sola llamada de prueba con una clave nueva suele bastar para confirmar que encaja limpiamente en una integración existente.