接 Mapbox：为 TMS 线路提供路线距离、时长与 ETA
在 account.mapbox.com → Access Tokens 复制访问令牌，把唯一的 access_token 填进 Integration，用一次真实 Directions 调用测试，选路线规划模板再激活——TMS 就能拿到线路成本与 ETA 所需的距离、时长与线路。
Mapbox 连接器是 TMS 的路线数据源。它调用 Mapbox Directions API 一次算一条路线——距离、时长与线路本身——供 TMS 里的运单与招标单用作线路成本与 ETA 的依据。这就是它唯一的工作：不拉也不推订单，不同步客户或库存，不追踪车辆，也不计算多站点的最优拜访顺序。一个连接只放一个 Mapbox 访问令牌。
前置条件#
- 一个能登录 account.mapbox.com 的 Mapbox 账号，并能打开 Access Tokens 页面。
- 您清楚测试这个连接会产生用量：Directions API 没有免费探针端点，每次测试都是一次真实路线调用、消耗一次配额。不要无故反复点测试。
- 您的线路符合本连接调用 Directions API 的口径：坐标按 经度,纬度 顺序发送，一次路线请求最多带 25 个坐标。
- 在本系统里有打开 Integration 并新建连接的权限。
拿凭证#
- 登录 account.mapbox.com，打开 Access Tokens。
- 从该页面完整复制一个令牌。本连接的令牌以 pk.… 或 sk.… 开头——按页面显示原样复制完整值，两端不要截断，也不要多加空格。
- 把该令牌作为唯一需要带回的值。本连接在每次 Directions 请求时把令牌作为 access_token 查询参数发给 Mapbox，所以该页面上没有另外的密钥、用户名或密码要收集。
填进 Integration#
- 打开 Integration → 连接器市场 → Mapbox → 新建连接。
- access_token——必填，Mapbox 访问令牌：粘贴从 account.mapbox.com → Access Tokens 复制的完整令牌。这是密码类型字段，作为秘密保存。本连接没有第二个字段：这里不用填用户名、密码或账号字段。
- 测试前先保存连接，让测试用的正是您刚填的令牌。测试请求会把令牌作为 access_token 查询参数发送。
测试连接#
点测试连接。填了令牌时，测试会做一次真实的最小 Directions 调用：向 https://api.mapbox.com/directions/v5/mapbox/{profile}/{coordinates} 发 GET 请求，令牌作为 access_token 查询参数带上。测通表示访问令牌有效、Directions API 可达，成功提示会用文字写明：access token 有效，Directions API 可达（探针消耗一次配额）。最后一句请按字面理解——这个探针是真实调用，每跑一次就消耗一次配额，所以只测一次；失败先修原因，修好再测。
配 Mapping / 选模板#
选路线规划模板——本连接只用这一个模板。没有订单或客户字段要配 Mapping。模板定的是 TMS 里每种出行方式对应的 Directions profile——driving、driving-traffic、walking、cycling 各自以同名 profile 发给 Mapbox——以及请求本身的形态：坐标按 经度,纬度 顺序，一条路线最多 25 个坐标。测试通过后，在 TMS 里算一条您熟悉的路线，把返回的距离与时长和您对该线路的预期对照，确认后再激活。
激活#
激活后，TMS 的运单或招标单需要估算线路时就能向本连接要路线：连接返回距离、时长与线路，TMS 用它们作线路成本与 ETA 的依据。先在 运行监控 / 日志里盯头几次真实请求，拿几条您熟悉的线路对照返回的距离与时长，无误后再放手跑。
这个连接不做的事：它只通过 Directions API 提供路线规划。它不计算多站点的最优拜访顺序，不拉订单进来，不同步客户或库存，也不追踪移动中的车辆。激活后 TMS 界面没有新订单出现是正常的——订单来自您的订单渠道，本连接只在 TMS 提问时回答：多远、多久、走哪条线。
常见问题#
测试失败，提示 access token 无效
access_token 里的值不是您 Mapbox 账号里完整可用的令牌：复制时丢了字符、多带了空格，或令牌是从另一个账号复制的、并非您想用的那个。测试会把令牌按保存的样子原样作为 access_token 查询参数发出，任何差别都足以让 Mapbox 拒绝。
登录 account.mapbox.com，打开 Access Tokens，从该页面一次性重新复制一个令牌，粘贴进 access_token、不要手敲任何一段，保存后测一次。
连接还没激活，用量却在涨
每次测试都是真实调用。Directions API 没有免费探针端点，测试只能靠真算一条路线来证明令牌可用——而该请求会消耗一次配额，正如成功提示所写：探针消耗一次配额。激活前反复测试就是真实用量。
只测一次。失败就读失败信息，只修令牌里那一个原因，修好后再测。测通后就进入模板与激活步骤，不要为了再确认一遍而重复测试。
多站点的路线失败或没有结果返回
请求形态不符合本连接调用 Directions API 的口径：一条路线最多带 25 个坐标，且坐标必须按 经度,纬度 顺序。按 纬度,经度 拼的列表，或塞了超过上限坐标的路线，都不会返回您预期的路线。
检查该路线的坐标列表：每个点都改成 经度,纬度 顺序，数量保持在 25 个以内。更长的行程拆成每段最多 25 个坐标的若干段，逐段计算。
熟悉线路的距离与时长看着不对
这条路线是用与您预期不同的 Directions profile 算的，或某个点的两个数字写反了。模板把 driving、driving-traffic、walking、cycling 以同名 profile 发送，点位按 经度,纬度 顺序——把步行结果当开车结果看，或点位先写了纬度，都会得到看着不对的路线，尽管调用本身是成功的。
查该线路的两件事：TMS 请求用的 profile，以及每个坐标对的顺序。把 profile 或坐标顺序改成与线路相符的样子，再重算，新结果只拿同 profile 作判断。
站点按给定的顺序返回，不是最优顺序
这是本连接的能力边界。它用 Directions API 按给定的顺序算一条穿过各点的路线。算出多站点的最优拜访顺序是另一件工作，本连接不做——按所给顺序算出的路线是对的，只是不会替您重排顺序。
提问路线前，先在 TMS 里自己定好拜访顺序，按该顺序把点位给本连接。本连接只按距离、时长与所给顺序的路线来评判。
已激活，但哪里都没有订单或追踪出现
什么都没坏。这个连接本来就不承载订单或追踪：它唯一的能力是路线规划，激活不会新增订单来源，也不会有车辆位置——它只是让 TMS 在运单或招标单需要估算线路时能问到距离、时长与线路。
订单请走您的订单渠道，追踪请用承运商工具。本连接只用在需要线路成本或 ETA 的地方，验它的工作请看 TMS 运单或招标单里的路线结果。