Conectar Mapbox: distancia, duración y ETA de rutas para carriles TMS
Copie un Access Token desde account.mapbox.com → Access Tokens, complete ese único access_token en Integration, pruébelo con una llamada real a Directions, elija la plantilla de planificación de rutas y active: TMS obtendrá distancia, duración y ruta para costo de carril y ETA.
El conector de Mapbox es una fuente de datos de rutas para TMS. Usa la Mapbox Directions API para calcular una ruta por vez (distancia, duración y la propia ruta), para que los envíos y las licitaciones en TMS usen ese resultado como base del costo de carril y del ETA. Ese es su único trabajo: no trae ni envía pedidos, no sincroniza clientes ni inventario, no rastrea vehículos y no calcula el mejor orden de visita para muchas paradas. Una conexión guarda un solo Mapbox Access Token.
Requisitos previos#
- Una cuenta de Mapbox con la que pueda entrar en account.mapbox.com y acceder a la página Access Tokens.
- Entiende que probar esta conexión genera uso: no hay un endpoint de prueba gratuito para la Directions API, así que cada prueba es una llamada real de ruta y usa una cuota. No haga clic en probar una y otra vez sin motivo.
- Sus carriles encajan con lo que la Directions API acepta por este conector: las coordenadas se envían en orden longitud,latitud, y una solicitud de ruta lleva como máximo 25 coordenadas.
- Permiso en este sistema para abrir Integration y crear una conexión nueva.
Obtener credenciales#
- Inicie sesión en account.mapbox.com y abra Access Tokens.
- Copie un token de esa página por completo. Los tokens mostrados para este conector empiezan con pk.… o sk.…: copie el valor entero tal como se muestra, sin cortar nada en ningún extremo y sin añadir espacios.
- Guarde ese token como el único valor que necesita traer. Esta conexión envía el token a Mapbox como el parámetro de consulta access_token en cada solicitud a Directions, así que no hay otra clave, usuario ni contraseña que recoger en esa página.
Completar en Integration#
- Abra Integration → Marketplace → Mapbox → Nueva conexión.
- access_token, obligatorio, Mapbox Access Token: pegue el token completo que copió de account.mapbox.com → Access Tokens. Es un campo de tipo contraseña y se guarda como secreto. Este conector no tiene un segundo campo: aquí no se completa usuario, contraseña ni campo de cuenta.
- Guarde la conexión antes de probarla, para que la prueba use exactamente el token que acaba de introducir. El token se enviará como el parámetro de consulta access_token en la solicitud de prueba.
Probar la conexión#
Haga clic en Probar la conexión. Con un token completado, la prueba hace una llamada real y mínima a Directions: envía una solicitud GET a https://api.mapbox.com/directions/v5/mapbox/{profile}/{coordinates} con su token como el parámetro de consulta access_token. Aprobar significa que el access token es válido y que la Directions API responde, y el mensaje de éxito lo dice con palabras: access token válido, Directions API alcanzable (la sonda consume una cuota). Lea esa última parte al pie de la letra: esta sonda es una llamada real y usa una cuota cada vez que la ejecuta, así que pruebe una vez, corrija la causa si falla y solo entonces vuelva a probar.
Mapping / elegir plantilla#
Elija la plantilla de planificación de rutas, la única que usa este conector. No hay campos de pedidos ni de clientes para mapear. Lo que define la plantilla es el perfil de Directions para cada modo de viaje pedido en TMS (driving, driving-traffic, walking y cycling van a Mapbox como el perfil del mismo nombre) y la forma de la propia solicitud: coordenadas en orden longitud,latitud, con un máximo de 25 coordenadas en una ruta. Tras aprobar la prueba, pida en TMS una ruta que ya conoce y compare la distancia y la duración devueltas con lo que espera para ese carril, antes de activar.
Activar#
Tras activar, TMS puede pedir una ruta a esta conexión cuando un envío o una licitación necesita una estimación de carril: la conexión devuelve distancia, duración y la ruta, y TMS los usa como base del costo de carril y del ETA. Vigile las primeras solicitudes reales en Runs / Logs y compare algunas distancias y duraciones devueltas con carriles que conoce, antes de dejar la conexión sin supervisión.
Lo que esta conexión no hace: solo ofrece planificación de rutas mediante la Directions API. No calcula el mejor orden para visitar muchas paradas, no trae pedidos, no sincroniza clientes ni inventario y no sigue a un vehículo mientras se mueve. Si una pantalla de TMS no muestra pedidos nuevos tras activar, es lo esperado: los pedidos vienen de sus canales de pedidos, y esta conexión solo responde cuando TMS pregunta cuánto, cuánto tiempo y por qué ruta.
Preguntas frecuentes#
La prueba falla y dice que el access token no es válido
El valor en access_token no es un token completo y válido de su cuenta de Mapbox: se perdió un carácter al copiar, vino un espacio de más, o el token se copió de otra cuenta distinta de la que quería usar. La prueba envía el token tal como está guardado, como el parámetro de consulta access_token, así que cualquier diferencia basta para que Mapbox lo rechace.
Inicie sesión en account.mapbox.com, abra Access Tokens, copie de nuevo un token de esa página de una sola vez, péguelo en access_token sin teclear ninguna parte a mano, guarde y pruebe una vez.
El uso sube aunque la conexión aún no está activada
Cada prueba es una llamada real. La Directions API no tiene un endpoint de sonda gratuito, así que la prueba solo puede demostrar que el token funciona pidiendo una ruta real, y esa solicitud usa una cuota, exactamente como dice el mensaje de éxito: la sonda consume una cuota. Probar una y otra vez antes de activar es uso real.
Pruebe una vez. Si falla, lea el fallo, corrija esa única causa en el token y solo entonces vuelva a probar. Cuando la prueba apruebe, siga con la plantilla y la activación en lugar de probar otra vez para reconfirmar.
Una ruta con muchas paradas falla o vuelve sin resultado
La forma de la solicitud no encaja con la Directions API por este conector: una ruta lleva como máximo 25 coordenadas, y las coordenadas deben ir en orden longitud,latitud. Una lista armada como latitud,longitud, o una ruta cargada con más coordenadas que el límite, no devolverá la ruta que esperaba.
Revise la lista de coordenadas de esa ruta: ponga cada punto en orden longitud,latitud y mantenga la cantidad en 25 o menos. Para un viaje más largo, divídalo en tramos de como máximo 25 coordenadas cada uno y calcule los tramos uno por uno.
Las distancias y duraciones se ven mal en un carril que conoce bien
La ruta se calculó con un perfil de Directions distinto del que esperaba, o con los dos números de un punto intercambiados. La plantilla envía driving, driving-traffic, walking y cycling como el perfil del mismo nombre, y los puntos van en orden longitud,latitud: un resultado a pie leído como resultado en auto, o un punto con la latitud primero, da una ruta que se ve mal aunque la llamada haya funcionado.
Revise dos cosas de ese carril: el perfil que usó la solicitud de TMS y el orden de cada par de coordenadas. Corrija el perfil o el orden del par para que coincida con el carril, recalcule y juzgue el nuevo resultado solo contra el mismo perfil.
Las paradas vuelven en el orden dado, no en el mejor orden
Ese es el límite de esta conexión. Calcula una ruta por los puntos en el orden en que se dan, usando la Directions API. Calcular el mejor orden de visita para muchas paradas es otro trabajo, y esta conexión no lo hace: la ruta es correcta para el orden entregado, solo que no se reordena por usted.
Decida usted el orden de visita en TMS antes de pedir la ruta, y entregue los puntos a esta conexión en ese orden. Juzgue esta conexión solo por la distancia, la duración y la ruta para el orden que entregó.
Activada, pero no aparecen pedidos ni rastreo en ningún lado
Nada está roto. Esta conexión nunca transportó pedidos ni rastreo: su única capacidad es la planificación de rutas, así que activar no añade una fuente de pedidos ni posiciones de vehículos, solo permite que TMS pida distancia, duración y ruta cuando un envío o una licitación necesita una estimación de carril.
Use sus canales de pedidos para los pedidos y las herramientas del transportista para el rastreo. Use esta conexión solo donde se necesita un costo de carril o un ETA, y revise su trabajo en el resultado de ruta de un envío o una licitación en TMS.