Connecter Mapbox : distance, durée et ETA des itinéraires pour les axes TMS

Copiez un Access Token depuis account.mapbox.com → Access Tokens, saisissez cet unique access_token dans Integration, testez-le avec un appel Directions réel, choisissez le modèle de planification d’itinéraires et activez : le TMS obtient alors distance, durée et itinéraire pour le coût d’axe et l’ETA.

Le connecteur Mapbox est une source de données d’itinéraires pour le TMS. Il utilise la Mapbox Directions API pour calculer un itinéraire à la fois (distance, durée et l’itinéraire lui-même), afin que les expéditions et les appels d’offres dans le TMS utilisent ce résultat comme base du coût d’axe et de l’ETA. C’est son seul rôle : il n’importe ni n’envoie de commandes, ne synchronise ni clients ni stock, ne suit pas les véhicules et ne calcule pas le meilleur ordre de visite pour de nombreux arrêts. Une connexion contient un seul Mapbox Access Token.

Prérequis#

• Un compte Mapbox auquel vous pouvez vous connecter sur account.mapbox.com, avec accès à la page Access Tokens.
• Vous comprenez que tester cette connexion génère de l’usage : il n’existe pas d’endpoint de sonde gratuit pour la Directions API, donc chaque test est un appel d’itinéraire réel et utilise un quota. Ne cliquez pas sur tester à répétition sans raison.
• Vos axes correspondent à ce que la Directions API accepte via ce connecteur : les coordonnées sont envoyées dans l’ordre longitude,latitude, et une demande d’itinéraire comporte au plus 25 coordonnées.
• Droit dans ce système d’ouvrir Integration et de créer une nouvelle connexion.

Obtenir les identifiants#

1. Connectez-vous sur account.mapbox.com et ouvrez Access Tokens.
2. Copiez un token de cette page en entier. Les tokens affichés pour ce connecteur commencent par pk.… ou sk.… : copiez la valeur entière telle qu’elle s’affiche, sans rien couper à aucun bout et sans ajouter d’espace.
3. Gardez ce token comme la seule valeur à rapporter. Cette connexion envoie le token à Mapbox comme paramètre de requête access_token sur chaque demande Directions, donc il n’y a ni autre clé, ni nom d’utilisateur, ni mot de passe à relever sur cette page.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Mapbox → Nouvelle connexion.
2. access_token, obligatoire, Mapbox Access Token : collez le token complet copié depuis account.mapbox.com → Access Tokens. C’est un champ de type mot de passe, conservé comme secret. Ce connecteur n’a pas de second champ : aucun nom d’utilisateur, mot de passe ni champ de compte à saisir ici.
3. Enregistrez la connexion avant de la tester, afin que le test utilise exactement le token que vous venez de saisir. Le token sera envoyé comme paramètre de requête access_token sur la demande de test.

Tester la connexion#

Cliquez sur Tester la connexion. Avec un token saisi, le test effectue un appel Directions réel et minimal : il envoie une requête GET à https://api.mapbox.com/directions/v5/mapbox/{profile}/{coordinates} avec votre token comme paramètre de requête access_token. Un succès signifie que l’access token est valide et que la Directions API est joignable, et le message de succès le dit en toutes lettres : access token valide, Directions API joignable (la sonde consomme un quota). Prenez cette dernière partie au pied de la lettre : cette sonde est un appel réel et utilise un quota à chaque exécution. Testez donc une fois, corrigez la cause en cas d’échec, et retestez seulement ensuite.

Mapping / choisir un modèle#

Choisissez le modèle de planification d’itinéraires — le seul que ce connecteur utilise. Il n’y a aucun champ de commande ni de client à mapper. Ce que le modèle définit, c’est le profil Directions pour chaque mode de déplacement demandé dans le TMS (driving, driving-traffic, walking et cycling partent vers Mapbox sous le profil du même nom) et la forme de la demande elle-même : coordonnées dans l’ordre longitude,latitude, au plus 25 coordonnées dans un itinéraire. Après un test réussi, demandez dans le TMS un itinéraire que vous connaissez déjà et comparez la distance et la durée renvoyées avec ce que vous attendez pour cet axe, avant d’activer.

Activer#

Après activation, le TMS peut demander un itinéraire à cette connexion quand une expédition ou un appel d’offres a besoin d’une estimation d’axe : la connexion renvoie distance, durée et itinéraire, et le TMS les utilise comme base du coût d’axe et de l’ETA. Surveillez les premières demandes réelles dans Runs / Logs et comparez quelques distances et durées renvoyées avec des axes que vous connaissez, avant de laisser la connexion sans surveillance.

Ce que cette connexion ne fait pas : elle fournit uniquement la planification d’itinéraires via la Directions API. Elle ne calcule pas le meilleur ordre pour visiter de nombreux arrêts, n’importe pas de commandes, ne synchronise ni clients ni stock, et ne suit pas un véhicule en mouvement. Si un écran du TMS n’affiche aucune nouvelle commande après l’activation, c’est attendu : les commandes viennent de vos canaux de commande, et cette connexion répond seulement quand le TMS demande quelle distance, quelle durée et quel itinéraire.

FAQ#

Le test échoue et dit que l’access token n’est pas valide

La valeur dans access_token n’est pas un token complet et valide de votre compte Mapbox : un caractère s’est perdu à la copie, un espace en trop s’est glissé, ou le token a été copié depuis un autre compte que celui que vous vouliez utiliser. Le test envoie le token tel qu’il est enregistré, comme paramètre de requête access_token, donc le moindre écart suffit pour que Mapbox le refuse.

Connectez-vous sur account.mapbox.com, ouvrez Access Tokens, recopiez un token de cette page en une seule fois, collez-le dans access_token sans taper aucune partie à la main, enregistrez et testez une fois.

L’usage augmente alors que la connexion n’est pas encore activée

Chaque test est un appel réel. La Directions API n’a pas d’endpoint de sonde gratuit, donc le test ne peut prouver que le token fonctionne qu’en demandant un itinéraire réel — et cette demande utilise un quota, exactement comme le dit le message de succès : la sonde consomme un quota. Tester à répétition avant l’activation est un usage réel.

Testez une fois. En cas d’échec, lisez l’échec, corrigez cette seule cause dans le token, et retestez seulement ensuite. Quand le test réussit, passez au modèle et à l’activation au lieu de retester pour revérifier.

Un itinéraire avec de nombreux arrêts échoue ou revient sans résultat

La forme de la demande ne correspond pas à la Directions API via ce connecteur : un itinéraire comporte au plus 25 coordonnées, et les coordonnées doivent être dans l’ordre longitude,latitude. Une liste construite en latitude,longitude, ou un itinéraire chargé de plus de coordonnées que la limite, ne renverra pas l’itinéraire attendu.

Vérifiez la liste de coordonnées de cet itinéraire : mettez chaque point dans l’ordre longitude,latitude et gardez le nombre à 25 ou moins. Pour un trajet plus long, découpez-le en tronçons de 25 coordonnées au plus chacun et calculez les tronçons un par un.

Les distances et durées semblent fausses sur un axe que vous connaissez bien

L’itinéraire a été calculé avec un profil Directions différent de celui attendu, ou avec les deux nombres d’un point inversés. Le modèle envoie driving, driving-traffic, walking et cycling sous le profil du même nom, et les points partent dans l’ordre longitude,latitude : un résultat à pied lu comme un résultat en voiture, ou un point avec la latitude en premier, donne un itinéraire qui semble faux alors que l’appel a fonctionné.

Vérifiez deux choses pour cet axe : le profil utilisé par la demande du TMS, et l’ordre de chaque paire de coordonnées. Corrigez le profil ou l’ordre de la paire pour correspondre à l’axe, puis recalculez et jugez le nouveau résultat uniquement face au même profil.

Les arrêts reviennent dans l’ordre donné, pas dans le meilleur ordre

C’est la limite de cette connexion. Elle calcule un itinéraire par les points dans l’ordre où ils sont donnés, via la Directions API. Calculer le meilleur ordre de visite pour de nombreux arrêts est un autre travail, et cette connexion ne le fait pas : l’itinéraire est correct pour l’ordre fourni, il n’est simplement pas réordonné pour vous.

Décidez vous-même l’ordre de visite dans le TMS avant de demander l’itinéraire, et donnez les points à cette connexion dans cet ordre. Jugez cette connexion uniquement sur la distance, la durée et l’itinéraire pour l’ordre que vous avez fourni.

Activée, mais aucune commande ni aucun suivi n’apparaît nulle part

Rien n’est cassé. Cette connexion n’a jamais transporté de commandes ni de suivi : sa seule capacité est la planification d’itinéraires, donc l’activation n’ajoute ni flux de commandes ni positions de véhicules — elle permet seulement au TMS de demander distance, durée et itinéraire quand une expédition ou un appel d’offres a besoin d’une estimation d’axe.

Utilisez vos canaux de commande pour les commandes et les outils du transporteur pour le suivi. N’utilisez cette connexion que là où un coût d’axe ou un ETA est nécessaire, et vérifiez son travail dans le résultat d’itinéraire d’une expédition ou d’un appel d’offres dans le TMS.