OpenCage se ha ganado seguidores entre los desarrolladores que prefieren una API de geocodificación sencilla y bien documentada sin mucho más añadido. Construimos nuestro host compatible con ese mismo espíritu: replicar exactamente el formato de solicitud y respuesta, para que nada del cambio se sienta como empezar de cero.
El host reproduce con precisión los parámetros de solicitud y el cuerpo de respuesta de OpenCage, y las únicas diferencias son los textos de copyright, términos y privacidad, que son propios de My Geocode. El código que hoy construye una solicitud con la forma de OpenCage y analiza una respuesta con la forma de OpenCage puede apuntar a nuestro host dejando esas dos partes totalmente intactas.
Lo que cambia es el nombre del host en tu configuración y la clave con la que te autenticas. Esa clave puede enviarse 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 el enfoque que ya use tu biblioteca cliente. Las cuatro funcionan igual en todos los hosts que operamos.
Los precios siguen nuestra estructura estándar sin importar qué host atienda una solicitud. Cualquier dirección recibe 2.500 solicitudes gratuitas al día sin ninguna clave, contadas por red. Una clave añade sus propias 2.500 solicitudes gratuitas al día. Superadas ambas cuotas, el crédito prepago cuesta 0,0001 € por solicitud, o un paquete Unlimited cubre el uso por 50 € al mes, y nada de eso cambia según la llamada pase por este host compatible o vaya directamente a /v1/forward.
Las cabeceras de cuota acompañan a cada respuesta, lo que añade una capa de visibilidad del uso que una integración simple con OpenCage no tendría: se incluyen siempre X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit y X-Quota-Reset.
Para los equipos que quieren más de lo que devuelve por defecto la respuesta compatible, añadir mg_extras=1 a la solicitud, o una cabecera X-MG-Extras, agrega campos opcionales, como la elevación del terreno, sin alterar la estructura base a menos que lo pidas.
La documentación del host está en /compatibility/opencage/, y una visión más amplia de cómo funcionan los hosts compatibles en toda la plataforma está en /docs/compatibility/. Si OpenCage ya está integrado en tu stack, probar el cambio es cuestión de modificar una URL base y usar una clave nueva.