Samsara 接続：車両 GPS を輸送追跡に取り込む
Samsara Dashboard の Settings → API Tokens で、fleet、vehicles、stats の読み取り権限を持つ API Token を生成し、Integration に貼り付け、地域に応じて US または EU のベース URL を選び、テスト・マッピング・有効化を行います。
Samsara コネクタは Samsara 車両群の車両 GPS を読み取ります。各車両について GPS 時刻、緯度・経度、進行方向、速度、その位置から逆引きした地名を取得し、それらの位置を TMS の追跡イベントに変換します。これにより、輸送中の貨物を車両ごとに追跡できます。役割はこれだけです：車両位置の読み取りのみを行います。注文は取り込まず、配車や積載は作成せず、ドライバーログや運転時間の記録は読まず、Samsara へは何も書き戻しません。1 接続は 1 つの Samsara API Token で動作します。
前提条件#
- GPS を報告する車両がある Samsara 車両アカウントと、追跡したい車両が Samsara に設定済みであること。
- Samsara Dashboard で Settings → API Tokens を開き、token を生成する権限。token の生成は管理者側の作業です。そのページが見えない場合は、Samsara 管理者に token の作成を依頼してください。
- token には fleet、vehicles、stats への読み取りアクセスが必要です。stats の読み取りアクセスなしに生成された token は、この接続が依存する GPS stats を読めず、テストも読み取りも権限で失敗します。
- Samsara アカウントが属する地域が分かっていること。US アカウントは https://api.samsara.com、EU アカウントは https://api.eu.samsara.com を使います。地域によって base_url が決まり、地域を間違えると車両群に応答しません。
認証情報の取得#
- API token を管理できるアカウントで Samsara Dashboard にログインし、Settings → API Tokens を開きます。
- この統合用に新しい API Token を生成します。生成時に fleet、vehicles、stats の 3 つすべてへの読み取りアクセスを付与してください。この接続は車両群の stats から車両 GPS を読むためです。
- Samsara が表示する token を全文コピーします。samsara_api_ で始まり、その後に長い文字列が続きます。生成時にコピーし、貼り付けられるよう用意してください。この時点からパスワードとして扱ってください。
- 同時に、地域をもう一度確認してください。アカウントが US 側なら US、EU 側なら EU です。その答えを次の手順の base_url に使います。
Integration への入力#
- Integration → コネクタマーケットプレイス → Samsara → 新規接続 を開きます。
- api_token、必須、API Token：Samsara Dashboard の Settings → API Tokens で生成した token 全体を貼り付けます。samsara_api_ で始まります。パスワード型のフィールドで、秘密情報として保存されます。
- base_url、任意、Base URL：このフィールドは地域の切り替えです。US アカウントの場合は空のままにするか、https://api.samsara.com を入力します。EU のお客様は代わりに https://api.eu.samsara.com を入力しなければなりません。US のアドレスでは EU の車両群は応答しません。
接続テスト#
接続テストをクリックします。token が入力されている場合、テストは実際の読み取り専用リクエストを 1 回送信します：GET {base_url}/fleet/vehicles/stats?types=gps、token を Bearer 認証情報として使用し、タイムアウトは 12 秒です。合格すると、結果に文字で確認が表示されます：Bearer token 認証が通過し、車両位置エンドポイントに到達可能であること。401 または 403 の応答は token が拒否されたことを意味します。誤っている、すでに無効である、またはエンドポイントに必要な読み取りアクセスが不足しています。時間内に応答しないリクエストはタイムアウトとして報告されます。原因を直して再テストしてください。テストが Samsara のデータを変更することはありません。
Mapping / テンプレート選択#
Samsara 標準の Mapping を選択します。各車両の GPS 記録（時刻、緯度・経度、進行方向、速度、位置の地名）を、その車両の TMS 追跡イベントに変換します。これにより、位置が TMS で追跡する車両や貨物と一致します。テスト合格後、1 回読み取りを実行し、路上にあることが分かっている車両を 1 台比較してください。ここでの最新位置、進行方向、速度と Samsara の同じ車両を照合します。一致すれば Mapping は正しく、有効化できます。
有効化#
有効化後、接続はお使いの token で Samsara から車両 GPS を読み取り、車両群の最新位置、進行方向、速度で TMS 追跡を更新し続けます。最初は Runs / Logs で読み取りを確認し、数台の車両を Samsara と照合してから無人運用に移してください。
この接続が行わないこと：Samsara から注文や積載を取り込まず、配車を作成・変更せず、ドライバーログ、運転時間、カメラやセンサーの記録は読まず、位置やその他のデータを Samsara に送信しません。これらは引き続き Samsara 自体で、または実際の作業を行うシステムで処理してください。
よくある質問#
テストが 401 で失敗する — token が拒否された
Samsara は api_token の値を受け入れませんでした。通常の原因は値自体にあります。一部だけ貼り付けた、すでに無効な古い token を貼り付けた、または Samsara API Token ではない値をフィールドに貼り付けた、といったケースです。
Samsara Dashboard → Settings → API Tokens へ移動し、fleet、vehicles、stats への読み取りアクセスを持つ新しい token を生成し、全文をコピーして（samsara_api_ で始まります）api_token に貼り付け、保存して再テストします。
テストが 403 で失敗する — token に読み取りアクセスがない
token は Samsara に届きましたが、テストが要求するものを読む権限がありません。この接続は車両群の stats から車両 GPS を読むため、fleet、vehicles、stats への読み取りアクセスなしで生成された token は、token 自体が存在していてもこのエンドポイントで拒否されます。
Samsara Dashboard → Settings → API Tokens で新しい token を生成し、今度はコピーする前に fleet、vehicles、stats への読み取りアクセスを付与してください。新しい token を api_token に貼り付けて保存し、再テストします。古い token は編集できません。そのアクセスは生成時に固定されています。
テストがタイムアウトして応答しない
GPS stats リクエストが 12 秒以内に応答しませんでした。これは Samsara API への到達性の問題です。最も多いのは、車両群と違う地域を指す base_url、または Samsara API の一時的な遅延です。token が間違っている証拠ではありません。
まず地域に対して base_url を確認してください。US は https://api.samsara.com、EU は https://api.eu.samsara.com です。もう一方の地域を指している場合は修正し、再テストします。正しい地域でもタイムアウトが繰り返される場合は、少し待って再試行し、サポートを求める際は Runs / Logs の失敗時刻を控えてください。
EU の車両群：すべて正しく見えるのにテストが失敗する
接続がまだ US の API アドレスを指しています。base_url のデフォルトは https://api.samsara.com で、EU アカウントはそこでは応答しません。token とそのアクセスが完璧でも、EU の車両群は US のアドレスには応答しません。
base_url を https://api.eu.samsara.com に設定し、保存して、同じ token で同じ接続を再テストしてください。先に新しい token を生成したり、他のものを変更したりしないでください。
接続済みだが、1 台の車両の GPS が表示されない
接続は Samsara が持つ車両群の GPS を返します。その車両について Samsara 自体に現在の GPS がない場合（車両の電源が切れている、カバー範囲外、報告していない）このシステムに表示できるものはありません。正常な接続でも、Samsara が持っていない位置を作り出すことはできません。
まず Samsara で同じ車両を確認してください。Samsara に現在の位置があるのにこのシステムにない場合は、手動読み取りを実行し、Runs / Logs で車両を比較し、接続を再テストします。Samsara にも何も表示されない場合は、その車両の Samsara 側の報告を直してください。
Samsara から注文や配車が入ってこないのはなぜですか？
このコネクタは車両の GPS 位置のみを読み取るためです。注文、積載、配車は Samsara から読める対象ではないため、ここで注文リストが空なのは想定どおりの動作で、接続の故障ではありません。
注文や配車は、引き続き実際の作業を行うシステムで作成・管理してください。この接続は、本来の用途に使ってください：TMS 追跡で、位置、進行方向、速度とともに、それらの貨物を運ぶ車両を追跡することです。