Mapbox 接続：TMS レーン向けのルート距離・所要時間・ETA
account.mapbox.com → Access Tokens で Access Token をコピーし、その 1 つの access_token を Integration に入力、実際の Directions 呼び出しでテスト、ルート計画テンプレートを選んで有効化します。TMS がレーン原価と ETA に必要な距離・所要時間・ルートを取得できます。
Mapbox コネクタは TMS 向けのルートデータソースです。Mapbox Directions API を使って 1 回に 1 ルート（距離、所要時間、ルート自体）を計算し、TMS の出荷と入札がその結果をレーン原価と ETA の根拠として使えるようにします。それが唯一の役割です：注文の取得や送信はせず、顧客や在庫の同期もせず、車両追跡もせず、多数の停車地の最適な訪問順序も計算しません。1 接続につき Mapbox Access Token は 1 つです。
前提条件#
- account.mapbox.com にログインできる Mapbox アカウントがあり、Access Tokens ページにアクセスできること。
- この接続のテストには使用量が発生することを理解していること：Directions API には無料のプローブ用エンドポイントがないため、テストのたびに実際のルート呼び出しが 1 回発生し、クォータを 1 回使います。理由なくテストを繰り返しクリックしないでください。
- レーンが、このコネクタ経由で Directions API が受け付ける形式に合っていること：座標は 経度,緯度 の順で送られ、1 回のルートリクエストには最大 25 座標まで含まれます。
- このシステムで Integration を開き、新規接続を作成する権限。
認証情報の取得#
- account.mapbox.com にログインし、Access Tokens を開きます。
- そのページからトークンを全文コピーします。このコネクタで表示されるトークンは pk.… または sk.… で始まります。表示どおりに値全体をコピーし、両端を切り取ったり余分な空白を加えたりしないでください。
- そのトークンを、持ち帰る唯一の値として保管してください。この接続は Directions リクエストのたびにトークンを access_token クエリパラメータとして Mapbox へ送るため、そのページで集める別のキー、ユーザー名、パスワードはありません。
Integration への入力#
- Integration → コネクタマーケットプレイス → Mapbox → 新規接続 を開きます。
- access_token、必須、Mapbox Access Token：account.mapbox.com → Access Tokens でコピーしたトークン全体を貼り付けます。パスワード型のフィールドで、秘密情報として保存されます。このコネクタに 2 つ目のフィールドはありません：ユーザー名、パスワード、アカウント欄をここに入力する必要はありません。
- テスト前に接続を保存し、テストで今入力したトークンがそのまま使われるようにします。トークンはテストリクエストで access_token クエリパラメータとして送られます。
接続テスト#
接続テストをクリックします。トークンが入力されている場合、テストは実際の最小限の Directions 呼び出しを 1 回行います：https://api.mapbox.com/directions/v5/mapbox/{profile}/{coordinates} へ GET リクエストを送り、トークンを access_token クエリパラメータとして付けます。合格は access token が有効で Directions API に到達できることを意味し、成功メッセージにはその旨が文字で表示されます：access token 有効、Directions API 到達可能（プローブでクォータを 1 回消費）。最後の部分は文字どおりに読んでください。このプローブは実際の呼び出しで、実行のたびにクォータを 1 回使います。テストは 1 回だけ行い、失敗したら原因を直してから再テストしてください。
Mapping / テンプレート選択#
ルート計画テンプレートを選択します。このコネクタが使うテンプレートはこれだけです。マッピングする注文や顧客の項目はありません。テンプレートが決めるのは、TMS で指定された移動手段ごとの Directions プロファイル（driving、driving-traffic、walking、cycling はそれぞれ同名のプロファイルとして Mapbox へ送られます）と、リクエスト自体の形式です：座標は 経度,緯度 の順、1 ルートあたり最大 25 座標。テスト合格後、TMS で既に知っているルートを 1 件計算し、返された距離と所要時間をそのレーンに対する自身の想定と照合してから有効化してください。
有効化#
有効化後、TMS は出荷や入札でレーン見積もりが必要なときに、この接続へルートを依頼できます：接続は距離、所要時間、ルートを返し、TMS はそれらをレーン原価と ETA の根拠として使います。最初は Runs / Logs で実際のリクエストを確認し、返された距離と所要時間を既知のレーンと数件照合してから、無人運用に移してください。
この接続が行わないこと：Directions API によるルート計画だけを提供します。多数の停車地を訪れる最適な順序は計算せず、注文を取り込まず、顧客や在庫を同期せず、移動中の車両を追跡しません。有効化後に TMS の画面に新しい注文が表示されなくても、それが正常です。注文は注文チャネルから来るもので、この接続は TMS が「距離は、時間は、どのルートか」と尋ねたときにだけ答えます。
よくある質問#
テストが失敗し、access token が無効と表示される
access_token の値が、あなたの Mapbox アカウントの完全で有効なトークンではありません：コピー時に文字が欠けた、余分な空白が入った、または使うつもりだったアカウントとは別のアカウントからコピーしたトークンです。テストは保存されたトークンをそのまま access_token クエリパラメータとして送るため、わずかな違いでも Mapbox は拒否します。
account.mapbox.com にログインし、Access Tokens を開き、そのページからトークンを一度にコピーし直し、手入力せずに access_token へ貼り付けて保存し、1 回テストしてください。
接続がまだ有効化されていないのに使用量が増える
テストのたびに実際の呼び出しが発生します。Directions API には無料のプローブ用エンドポイントがないため、テストは実際のルートを求めることでしかトークンの動作を証明できず、そのリクエストでクォータを 1 回使います。成功メッセージのとおりです：プローブでクォータを 1 回消費。有効化前の繰り返しテストは実際の使用量です。
テストは 1 回だけ行ってください。失敗した場合は失敗内容を読み、トークンのその 1 つの原因だけを直してから再テストしてください。テストが合格したら、再確認のためにもう一度テストするのではなく、テンプレートと有効化の手順へ進んでください。
停車地の多いルートが失敗するか、結果が返らない
リクエストの形式が、このコネクタ経由の Directions API に合っていません：1 ルートには最大 25 座標までで、座標は 経度,緯度 の順でなければなりません。緯度,経度 の順で作った一覧や、上限を超える座標を詰め込んだルートでは、想定したルートは返りません。
そのルートの座標一覧を確認してください：すべての地点を 経度,緯度 の順にし、数は 25 以下に保ってください。より長い行程は、各区間が最大 25 座標までの区間に分割し、区間ごとに計算してください。
よく知っているレーンで距離と所要時間がおかしく見える
想定と異なる Directions プロファイルでルートが計算されたか、地点の 2 つの数値が入れ替わっています。テンプレートは driving、driving-traffic、walking、cycling を同名のプロファイルとして送り、地点は 経度,緯度 の順です。徒歩の結果を車の結果として読んだり、地点で緯度を先に書いたりすると、呼び出し自体は成功していてもルートがおかしく見えます。
そのレーンについて 2 点を確認してください：TMS のリクエストが使ったプロファイルと、各座標ペアの順序。プロファイルまたはペアの順序をレーンに合わせて直し、再計算して、新しい結果は同じプロファイル同士でのみ判断してください。
停車地が最適な順序ではなく、与えた順序で返ってくる
それがこの接続の限界です。与えられた順序で地点を通るルートを Directions API で計算します。多数の停車地の最適な訪問順序を出すのは別の仕事であり、この接続はそれを行いません。与えた順序に対するルートは正しいものの、順序を並べ替えてはくれません。
ルートを依頼する前に、TMS で訪問順序を自分で決め、その順序で地点をこの接続に渡してください。この接続は、与えた順序に対する距離、所要時間、ルートでのみ判断してください。
有効化したのに、注文も追跡もどこにも表示されない
何も壊れていません。この接続はもともと注文や追跡を扱いません：唯一の能力はルート計画であり、有効化しても注文フィードや車両位置は追加されません。出荷や入札でレーン見積もりが必要なときに、TMS が距離、所要時間、ルートを尋ねられるようになるだけです。
注文は注文チャネル、追跡は運送会社のツールを使ってください。この接続はレーン原価や ETA が必要な場面でのみ使い、その動作は TMS の出荷や入札のルート結果で確認してください。