Muchas integraciones de mapas se construyeron hace años sobre Bing Maps REST Services y desde entonces simplemente siguen funcionando, sin tocarse, porque nunca hubo un motivo de peso para reescribirlas. Creemos que ahora hay uno: un host compatible que acepta las mismas solicitudes y devuelve la misma estructura de respuesta, con precios y cuotas transparentes desde la primera llamada.
Nuestro host compatible con Bing Maps REST Services replica exactamente los parámetros de solicitud y el cuerpo de respuesta del servicio original, salvo los textos de copyright, términos y privacidad, que corresponden a My Geocode y no al proveedor original. El código existente que construye solicitudes en el formato de Bing, analiza respuestas en el formato de Bing, o ambas cosas, puede apuntar a nuestro host sin reescribir nada.
Para lograrlo hay que cambiar dos cosas: el nombre del host al que van tus solicitudes y la clave con la que te autenticas. Esa clave puede enviarse como tu integración ya espera enviarla: como cabecera X-API-Key, como cabecera Authorization: Bearer, mediante autenticación HTTP Basic con la clave como nombre de usuario o como un simple parámetro de consulta. Las cuatro funcionan exactamente igual en todos los hosts de My Geocode, incluido este.
Los precios bajo la capa de compatibilidad son los mismos que en el resto de la plataforma. Cada dirección recibe 2.500 solicitudes gratuitas al día sin necesidad de clave, contadas por red para que una conexión compartida no pueda repartirse entre muchas claves y multiplicar el nivel gratuito. Cada clave añade sus propias 2.500 solicitudes gratuitas al día además de eso. Una vez superadas esas cuotas, el uso se descuenta del crédito prepago a 0,0001 € por solicitud o de un paquete Unlimited a 50 € al mes, y esa tarifa se mantiene independientemente del host o endpoint al que haya ido la solicitud.
La visibilidad de la cuota no desaparece porque la estructura de la respuesta coincida con la de otro proveedor. Cada llamada sigue devolviendo X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining y el resto de nuestro conjunto estándar de cabeceras, así que siempre sabes exactamente en qué situación está una clave o una red, algo que el servicio original no ofrece de esta forma.
Para los equipos que quieren más que la respuesta estrictamente compatible, mg_extras=1 en la solicitud, o una cabecera X-MG-Extras, añade campos opcionales sobre la estructura estándar sin alterarla. Si dejas ese indicador desactivado, la respuesta es indistinguible en estructura de lo que habría devuelto la API original.
Las guías de migración que explican paso a paso cómo trasladar una integración existente, endpoint por endpoint, están en /docs/compatibility/, y el propio host está documentado en /compatibility/bing-maps/. Probarlo no cuesta nada más que unos minutos libres y una clave.