El software de navegación y logística a menudo tiene TomTom Search integrado a un nivel bastante profundo, ya que allí las búsquedas de ubicación suelen estar junto a llamadas de rutas y mapas construidas por el mismo equipo, con el mismo estilo. Migrar una pieza sin tocar el resto es exactamente lo que nuestro host compatible está diseñado para hacer posible.
Reproduce exactamente los parámetros de solicitud y el cuerpo de respuesta de TomTom Search, y la única diferencia son los textos de copyright, términos y privacidad, que corresponden a My Geocode en lugar del proveedor original. Allí donde tu código envía hoy una solicitud de geocodificación con la forma de TomTom, puede enviar esa misma solicitud a nuestro host, y la respuesta se analiza de la misma forma sin ningún cambio en tu lógica existente.
Las llamadas de rutas y mapas construidas por el mismo equipo suelen compartir convenciones: la misma lógica de reintentos, el mismo manejo de errores, las mismas expectativas sobre tiempos. Replicar exactamente la estructura de solicitud y respuesta de TomTom Search, en lugar de ofrecer una API de geocodificación parecida pero distinta, significa que esa lógica circundante no necesita volver a probarse solo porque una llamada intermedia ahora apunte a otro sitio.
La autenticación usa nuestras cuatro opciones habituales: 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. La que ya use tu integración actual con TomTom se acepta también aquí, sin modificaciones.
Los precios son idénticos a los de cualquier otro host y endpoint de la plataforma. Cualquier dirección recibe 2.500 solicitudes gratuitas al día sin necesidad de clave, contadas por red. 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 cubre el uso por 50 € al mes, sin cargo adicional por usar un host compatible en lugar de uno nativo.
Los equipos que gestionan software de navegación o logística suelen repartir el tráfico entre más de una clave, una por entorno o una por servicio interno, para que un problema en staging nunca consuma cuota de producción. La página de claves del panel, en /dashboard/keys, permite generar y nombrar claves adicionales de la misma forma para una integración con la forma de TomTom que para cualquier otra.
Las cabeceras de cuota se añaden también a cada respuesta de este host: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used y X-Credits-Remaining están presentes, lo que da un nivel de visibilidad del uso que una integración directa con TomTom no mostraría.
Si un proyecto quiere más que la respuesta compatible estándar, añadir mg_extras=1 a la solicitud, o enviar una cabecera X-MG-Extras, agrega campos extra opcionales, totalmente a elección, y deja intacta la estructura base de la respuesta a menos que pidas expresamente algo más.
El host está documentado en /compatibility/tomtom/, y la guía general de migración para los hosts compatibles de toda la plataforma está en /docs/compatibility/. Redirigir aquí una integración existente con la forma de TomTom requiere cambiar el nombre del host y usar una clave nueva, nada más.