Gran parte del código escrito para Mapbox Geocoding vive dentro de aplicaciones front-end, apps móviles y herramientas internas donde la llamada de geocodificación es un detalle pequeño y fácil de pasar por alto, enterrado en un sistema más grande. Cambiar de proveedor ahí suele significar encontrar cada lugar donde vive ese detalle antes de poder hacer cualquier otra cosa. Nuestro host compatible está pensado para reducir ese trabajo a casi nada.
Reproduce exactamente el formato de solicitud y la estructura de respuesta de Mapbox, salvo los textos de copyright, términos y privacidad, que son propios de My Geocode. Allí donde tu código envía hoy una solicitud con la forma de Mapbox, puede enviar esa misma solicitud a nuestro host, y la respuesta que vuelve se analizará de la misma forma que tu código existente ya espera.
La autenticación sigue nuestro patrón habitual en lugar de obligarte a reescribir también esa parte. 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 cómo se autentique hoy tu cliente. Las cuatro funcionan en todos los hosts y endpoints que operamos.
Los precios no cambian según el host que atienda la solicitud. Cualquier dirección recibe 2.500 solicitudes gratuitas al día sin necesidad de clave, contadas por red y no por cada llamante individual. Una clave añade otras 2.500 solicitudes gratuitas al día propias. Superadas ambas cuotas, el crédito prepago cuesta 0,0001 € por solicitud, o un paquete Unlimited lo cubre todo por 50 € al mes. El host compatible cuesta exactamente lo mismo que nuestros endpoints nativos /v1/forward y /v1/reverse.
Las cabeceras de cuota se añaden a cada respuesta sea cual sea el formato, lo que da una visibilidad que una integración directa con Mapbox no ofrece por sí sola: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit y X-Quota-Reset aparecen en este host igual que en todos los demás.
Para cualquier cosa más allá de la estructura de respuesta compatible, mg_extras=1 en la solicitud, o una cabecera X-MG-Extras, agrega campos extra opcionales sin alterar la estructura base. Está desactivado por defecto, así que la respuesta coincide con la estructura de Mapbox hasta que pidas explícitamente algo más.
El host está en /compatibility/mapbox/, con una guía general para migrar una integración en /docs/compatibility/. Si hoy mantienes una integración con la forma de Mapbox, probar esto cuesta una clave y cambiar una URL base.