ライブトラッキング
ライブトラッキングは、車両が今どこにいて、今日どこに停車するかを公開済み地図に表示します。キッチンカーのルート、シャトルの周回、移動クリニックなどです。訪問者には、シフト中の各車両が地図上を動く様子、現在ここにいます、営業中、本日休業 の付いた今日の停留所、次の停留所までの推定時間が表示されます。訪問者に何が見えるかはライブのレイアウトを参照してください。
3 つの部分で構成され、すべて Kaleidr Studio にあります。
| 部分 | 内容 |
|---|---|
| 停留所コレクション | ス ケジュール。各停留所、その住所、毎週の運行時間帯です。ほかと同じスポットライブラリのコレクションです。 |
| フリート | 車両、そのシフト、訪問者にどの精度で見せるか。データ、フリート で管理します。 |
| 位置 | 各車両の居場所。ドライバーのチェックインリンク、ドライバーモードの電話、自社のトラッカー、テレマティクス提供元とのコネクターの 4 つのいずれかから届きます。 |
位置が表示されるのは、車両がシフト中の間だけです。 車両のどのシフトにも含まれない時刻に記録された位置は、届いた時点で破棄されます。保存も表示もされず、件数だけが数えられます。シフトを参照してください。
フリート
データ で フリート タブを選び、新しいフリート を選びます。名前とタイムゾーンを付け、停留所コレクションがあれば 停留所コレクション で選びます。Studio は同じ名前の 車両 コレクションを作成します。このコレクションが地図上のフリートで、ほかのコレクションと同じように地図に追加します。インポートしたスポットは入らず、車両はフリートのものです。
フ リートのページの 車両を追加 で 1 台追加します。
| フィールド | 訪問者に表示 | 用途 |
|---|---|---|
| 名前 | はい | 地図とパネルに表示する車両のラベル（例：「トラック 1」）。フリート内で一意です。 |
| 種類 | はい | トラック、バン、乗用車、バス、シャトル、船、カート、自転車。 |
| 色 | はい | 地図上の車両の色。 |
| 説明 | はい | カードに表示する短い一文。最大 200 文字。 |
| 外部 ID | いいえ | 自社の ID。コネクターと停留所の 車両 列で照合に使います。 |
| シフト時間 | いいえ | 時間指定のフリートでシフトが従う毎週の時間。シフトを参照してください。 |
無効にした車両は表示されず、その位置は破棄されます。フリートのページには、フリートのライブ地図が完全な精度で、自分だけに表示されます。
フリートと車両はオーナー、管理者、メンバーが管理し、閲覧者は見ることができます。フリートの削除、車両の履歴の消去、コネクターの管理ができるのはオーナーと管理者だけです。フリートを削除 すると、フリート、その車両、デバイス、リンク、シフト、履歴、コネクターを削除し、続いて車両コレクションを削除します。
停留所のスケジュール
スケジュールは 停留 所 コレクションです。各停留所は名前と住所または座標を持つスポットで、次のフィールドがいつ運行するかを決めます。
| フィールド | 意味 |
|---|---|
| 営業時間 | 停留所の毎週の運行時間帯。営業時間と同じ書き方で、1 日に最大 4 つの時間帯を指定できます。時間帯は深夜 0 時をまたいでもよく、開始した日に属します。 |
| タイムゾーン | 時間帯を記述したタイムゾーン。空ならコレクションのタイムゾーン。 |
| ステータス | paused にすると停留所はどの日にも運行しません。それ以外の値、または空なら運行します。 |
| 車両 | 停留所を担当する車両の名前または外部 ID。空ならフリートのどの車両でもかまいません。 |
| 運行日 | YYYY-MM-DD 形式の日付をカンマまたはスペースで区切ったもの。指定がある場合、停留所はその日付にのみ運行します。 |
ある日付における停留所の時間帯は次のとおりです。
- ステータスが
pausedの場合、またはタイムゾーンが無効な場合はなし。 - 運行日 があり、その日付が含まれていない場合はなし。
- 営業時間 がない場合は、運行日 にその日付があれば終日、なければなし。
- それ以外の場合は、その曜日の 営業時間。
今日の時間帯が現地時刻を含むとき、または深夜 0 時をまたぐ昨日の時間帯が含むとき、停留所は営業中です。「今日」はフリートのタイムゾーンでの日付です。
| 停留所 | 確認時刻 | 時間帯 | 営業中 |
|---|---|---|---|
| 営業時間 月曜 11:00–14:00 | 月曜 12:00 | 11:00–14:00 | はい |
| 同じ | 月曜 15:00 | 11:00–14:00 | いいえ |
同じ、運行日 2026-11-02 付き | 月曜 2026-11-09、12:00 | なし | いいえ |
運行日 2026-11-02、営業時間なし | 2026-11-02、09:00 | 終日 | はい |
営業時間 月曜 11:00–14:00、ステータス Paused | 月曜 12:00 | なし | いいえ |
| 営業時間 金曜 22:00–02:00 | 土曜 01:00 | 金曜の 22:00–02:00 | はい |
| 営業時間 月曜 11:00–14:00、無効なタイムゾーン | 月曜 12:00 | なし | 不明 |
運行日 2026-11-02, 2026-11-03 2026-11-04、営業時間 月曜 11:00–14:00 | 火曜 2026-11-03 | 火曜の営業時間：なし | いいえ |
テンプレートビルダーの Location テンプレートと サンプルシートをダウンロード で、記入済みの停留所コレクションから始められます。
チェックインリンク
チェックインリンクを使うと、ドライバーはアプリもアカウントもなしに、どの電話のブラウザーからでも停留所 に車両がいることを知らせられます。
フリートのページで 作成 します。車両を選び、チェックインリンク、リンクを作成 を選びます。Studio はリンクを 1 回だけ表示し、リンクをコピー と読み取り用の QR コードを添えます。リンクは https://map-embed.kaleidr.com/checkin.html#… のような形です。
- リンクは車両ごとに 1 つ で、180 日間有効です。リンクを置き換え は新しいリンクを発行し、古いリンクをただちに無効にします。電話を紛失したときやドライバーが辞めたときに使います。リンクを無効化 で無効にします。その後 Studio に表示されるのは、リンクの末尾 4 文字、有効期限、最終使用日時だけです。
- リンクは鍵です。 持っている人なら誰でも、停留所の近くで車両をチェックインできます。ドライバーとだけ共有してください。
- ブラウザーで開いてください。 このページは他のページのフレーム内では動作しません。
ドライバーのページ には、車両、今日の停留所、その状態が表示されます。
- 今ここにいます は電話の位置を 1 回読み取り、届く範囲の停留所にチェックインします。範囲は 250 メートルに読み取り精度を加えた距離で、精度は 100 メートル以内である必要があります。範囲内の停留所が複数ある場合やない場合は、今日の停留所の一覧が表示され、ドライバーが 2,000 メートル以内の停留所を 1 つ選びます。停留所以外でのチェックインを許可 がオンのフリ ートでは、予定外の停車地 も選べます。
- 本日は終了 は、その車両の今日の残りの停留所を 本日休業 にし、シフトを終了します。同じ日なら 本日の営業を再開 でこの表示を取り消せます。シフトは開始されません。
チェックインすると、停留所の時間帯が終わってから 30 分後までのシフトが始まり、車両は電話の位置ではなく 停留所自体の位置 に表示されます。電話の位置は停留所を見つけるために使われ、その後破棄されます。停留所以外でのチェックインでは、車両は電話の位置を約 10 メートル単位に丸めた場所に 4 時間表示されます。フリートの公開精度がそれより粗い場合は、その精度で丸められます。
ドライバーモードの電話
Kaleidr アプリを入れたドライバーの電話は、ドライバーのシフト中に車両の位置を共有します。フリートのページで車両の 電話をペアリング、ペアリングコードを表示 の順に選ぶと、QR コードと 8 文字のコードが表示されます。有効期間は 10 分で、1 回だけ使えます。ドライバーは電話のカメラで QR を読み取るか、アプリでコードを入力します。ドライバー側の手順はドライバーモードを参照してください。
デバイス には各車両の電話とトラッカーが一覧表示されます。ペアリン グ解除 でデバイスをただちに外せます。そのデバイスからの次の呼び出しは拒否され、そのデバイスが開始したシフトは終了します。
トラッカーと位置 API
トラッカーとは、位置を送信する自社のデバイスやシステムのことです。HTTP クライアントを持つ GPS 装置や、自社の配車ソフトウェアなどです。フリートのページで車両の トラッカーを追加 を選んで名前を付けると、Studio がそのキーを 1 回だけ表示します。キーはその車両に属します。
curl https://api.kaleidr.com/live-api/v1/positions \
-H "Authorization: Bearer YOUR_DEVICE_KEY" \
-H "Content-Type: application/json" \
-d '{
"positions": [
{ "lat": 40.74110, "lng": -73.98970, "heading": 90, "speed": 8.3, "accuracy": 12,
"recorded_at": "2026-10-22T15:04:05Z" }
],
"sent_at": "2026-10-22T15:04:06Z"
}'
| フィールド | ルール |
|---|---|
positions | 1〜100 地点。順序は問いません。本文は最大 64 KiB です。 |
lat, lng | 必須。範囲内で、両方が 0 ではないこと。 |
heading | 北からの角度。 |
speed | 秒速（メートル）。 |
accuracy | メートル。精度が 100 メートルより悪い地点は破棄されます。 |
recorded_at | 必須。位置を測定した時刻。RFC 3339、または 1970 年からのミリ秒。 |
sent_at | デバイスの時計でバッチを送信した時刻。Kaleidr の時計との差が 5 秒より大きく 1 日未満なら、各 recorded_at をその差だけ補正します。1 日以上ならバッチは拒否されます。 |
応答：
{
"accepted": 1,
"dropped": { "off_shift": 0, "stale": 0, "future": 0, "inaccurate": 0, "rate": 0, "duplicate": 0 },
"shift": { "id": "…", "state": "on", "ends_at": "2026-10-23T03:04:05Z" },
"min_interval_s": 10
}
| 破棄の理由 | 説明 |
|---|---|
off_shift | 車両のどのシフトにも含まれない時刻に記録されたか、車両が無効です。保存されません。 |
stale | 12 時間以上前に記録されました。 |
future | Kaleidr の時計より 30 秒以上先の時刻で記録されました。 |
inaccurate | 精度が 100 メートルより悪いか、速度または精度が負の値です。 |
rate | 車両の直前の地点との時間差が、プランの更新間隔より短いです。 |
duplicate | 同じ recorded_at の地点がすでに保存されています。 |
GET /live-api/v1/device は、デバイス、その車両、フリート、進行中のシフトを返します。POST /live-api/v1/device/shift に { "action": "start" } または { "action": "end" } を送ると、デバイスから車両のシフトを開始・終了できます。
| ステータス | error | 意味 |
|---|---|---|
| 400 | invalid_request | 本文の形式が正しくありません。field が該当部分を示します。 |
| 400 | clock_invalid | sent_at が Kaleidr の時計と 1 日以上ずれています。 |
| 401 | unauthorized | キーがないか、不明なキーです。 |
| 401 | device_revoked | Studio でデバイスが外されました。送信を止めてください。 |
| 409 | off_shift | バッチに地点があったのにどれもシフト内になく、開いているシフトもありません。シフトが始まるまで送信を止めてください。 |
| 413 | batch_too_large | 100 地点を超えるか、64 KiB を超えています。 |
| 429 | rate_limited | このデバイスから 1 分あたり 12 リクエストを超えました。Retry-After の秒数だけ待ってください。 |
エラーは { "error": <code>, "message": <sentence> } の形です。移動中は 10〜30 秒ごとに送信してください。1 地点ごとにリクエストを送るより、複数の地点をまとめて送る方が適切です。
コネクター
コネクターは、車両がすでに報告しているテレマティクスシステムから位置を取り込みます。オーナーと管理者が、フリートのページの コネクタ、コネクタを追加 で追加し ます。コネクターは Pro と Enterprise で利用できます。
| コネクター | 用意するもの | 位置の届き方 |
|---|---|---|
| Samsara | 車両の位置を読み取れる API トークン | Kaleidr が 取得間隔 ごとに Samsara に新しい位置を問い合わせます。 |
| Geotab | サーバー（geotab.com のホスト）、データベース、ユーザー名、パスワード | Kaleidr が 取得間隔 ごとに Geotab に新しいログレコードを問い合わせます。 |
| Traccar | 不要。Studio が取り込み URL とシークレットを表示します | Traccar サーバーが各位置を転送します。 |
| Webhook | 不要。Studio が取り込み URL とシークレットを表示します | 自社のシステムが署名付きのバッチを送信します。 |
- 認証情報は書き込み専用です。 Studio は Samsara や Geotab の認証情報を保存前に 1 回の呼び出しで確認し、二度と表示しません。認証情報を置き換え で入れ替えます。
- 取り込み用シークレットは 1 回だけ表示されます。 シークレットを更新 で新しいものを発行し、古いものも 24 時間は使えます。
- 照合方法 は、提供元の車両を自社の車両とどう対応付けるかを決めます。外部 ID（既定）または 名前 です。一致しない提供元の車両は 未照合の車両 に 車両として追加 とともに表示され、 その位置は破棄されます。
- 取得間隔 は 30 秒以上で、プランの更新間隔より短くはなりません。
- 状態：有効、一時停止（自分で止めたか、プランで許可されるコネクター数が減ったため）、エラー（5 回連続で取得に失敗。再試行は続きます）、無効（提供元が認証情報を拒否。置き換えるまで）。一時停止中または無効の Traccar や Webhook のコネクターは、送られたものを拒否します。
コネクターからの位置にもシフトのルールが適用されます。
Traccar
Studio に表示された URL とシークレットを使って、Traccar サーバーの設定ファイル traccar.xml に次の行を追加し、Traccar を再起動します。
<entry key='forward.enable'>true</entry>
<entry key='forward.url'>https://api.kaleidr.com/live-api/v1/ingest/YOUR_CONNECTOR_ID/traccar</entry>
<entry key='forward.json'>true</entry>
<entry key='forward.header'>X-Kaleidr-Connector-Secret: YOUR_CONNECTOR_SECRET</entry>
Traccar のデバイスは、一意の ID（外部 ID）または名前で車両と照合されます。Traccar が無効とした位置は破棄されます。
Webhook
1 回のリクエストで最大 100 地点を、コネクターのシークレットで署名して取り込み URL に送りま す。
import { createHmac } from 'node:crypto';
const body = JSON.stringify({
positions: [
{ vehicle: 'TRUCK-1', lat: 40.7411, lng: -73.9897, heading: 90, speed: 8.3, accuracy: 12,
recorded_at: '2026-10-22T15:04:05Z' },
],
});
const t = Math.floor(Date.now() / 1000);
const v1 = createHmac('sha256', process.env.KALEIDR_CONNECTOR_SECRET).update(`${t}.${body}`).digest('hex');
await fetch('https://api.kaleidr.com/live-api/v1/ingest/YOUR_CONNECTOR_ID/webhook', {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'Kaleidr-Signature': `t=${t},v1=${v1}` },
body,
});
Kaleidr-Signatureはt=<unix seconds>,v1=<hex HMAC-SHA256(secret, "<t>.<raw body>")>で、予約の Webhook と同じ方式を逆方向に使います。tは Kaleidr の時計と 5 分以内の差である必要があり、署名は送信するバイト列そのものに対して計算します。vehicleは 照合方法 に従った車両の外部 ID または名前です。speedは秒速（メートル）、accuracyはメートル、recorded_atは RFC 3339 または 1970 年からのミリ秒です。- 署名が正しくない場合は 401
signature_invalidで拒否されます。
シフト
シフトは、車両を表示してよい時間です。車両ごとに開いているシフトは最大 1 つで、長さは最大 16 時間です。シフトは次の 4 つのいずれかで開始・終了します。
| 開始のきっかけ | 終了 |
|---|---|
| ドライバーモードの シフト開始 | シフト終了、または 16 時間後 |
| チェックイン | 停留所の時間帯の終了から 30 分後、本日は終了、または 16 時間後 |
| Studio で車両の シフト開始 | Studio の シフト終了、または 16 時間後 |
| シフトモード が 予定時間 のフリートでの、車両のシフト時間 | その時間の終わり |
- シフト外には、何も公開も保存もされません。 どのシフトにも含まれない時刻に記録された位置は、届いた時点で破棄されます。使用状況 のために、破棄した件数だけを残します。
- シフトを終了すると、 次回の更新で車両は地図から消えます。
- コネクターとトラッカーは常に報告するので、シフトが判断の基準になります。 手動 のフリートでは、ドライバー、チェックイン、Studio のいずれかが開始したシフトが開いている間だけ位置が通ります。予定時間 のフリートでは、車両のシフト時間がシフトを開始・終了します。
- デバイスを外すと、そのデバイスが開始したシフトは終了します。
公開精度
フリートのページの プライバシーと表示 で、訪問者に車両をどの精度で見せるかを設定します。
| 公開精 度 | 訪問者に見えるもの | 進行方向と速度 |
|---|---|---|
| 正確 | 約 1 メートル単位の位置 | 表示 |
| 通り（約 100 m）（既定） | 約 100 メートル単位に丸めた位置 | 表示 |
| エリア（約 1 km） | 約 1 キロメートル単位に丸めた位置 | 非表示 |
- 停留所でチェックインした車両は、停留所自体の位置に表示されます。
- 古いと表示するまで（30〜900 秒、既定は 120）：これより長く報告がない車両には 5 分前に確認 と表示されます。
- 非表示にするまで（60〜3,600 秒、既定は 900）：これより長く報告がない車両は表示されません。
- 訪問者に見えるのは、各車両の名前、種類、色、説明、状態、丸めた位置、最後の報告からの経過時間と、エリア（約 1 km） 以外での進行方向と速度だけです。デバイス、外部 ID、履歴が公開されることはありません。
履歴と保存期間
履歴 で、各車両の 1 日分の軌跡を完全な精度で確認できます。履歴には 30 秒ごと（プランの更新間隔の方が長い場合はその間隔ごと）に最大 1 地点が残り、さらに最後に残した地点から 200 メートル以上離れた地点も残ります。地点はプランの履歴日数を過ぎると削除され、90 日を超えて残ることはありません。
- 履歴を 消去（オーナーと管理者）は、車両のすべての位置と終了したシフトを一度に削除します。
- 車両やフリートを削除すると、 その履歴も一緒に削除されます。デバイスのペアリングを解除しても、車両の履歴は残ります。
- 履歴日数の少ないプランでは、次回の日次クリーンアップで超過分の履歴が削除されます。
ドライバーは Kaleidr アカウントではありません。ここでは、入力したデバイス名以外に個人を特定するものはありません。
到着時間の推定
ライブのレイアウトは、車両が次の停留所まで、または 自分のところまでどのくらい？ と尋ねた訪問者のところまで、どのくらいかかるかを表示します。こうした時間はすべて 推定 です。
- 道路距離と標準的な速度から算出します。交通状況は含まれず、 車両の実際のルートは異なる場合があります。
- 訪問者に見える位置、つまりフリートの公開精度での位置から計算します。
- 約 12 分 のように所要時間として表示し、到着時刻としては表示しません。道路ルートがない場合は 推定なし です。
- 訪問者自身の位置はこの推定にのみ使い、保存もログ記録もしません。
- 道路ルートは OpenStreetMap のデータから作成しており、© OpenStreetMap contributors、ODbL に基づきます。
推定は、訪問者 1 人あたり 1 分に 20 回、地図 1 つあたり 1 日 2,000 回までです。Kaleidr AI の使用量には数えられません。
Kaleidr の地図のみ
ライブの車両は、Kaleidr 独自のベースマップを使う地図に描画されます。埋め込みのすべての viewer と Studio です。Kaleidr Map は、他の提供元の地図を表示している間はフリートの車両を描画しません。車両の位置が外部の地図提供元に送られることはありません。
上限
| 上限 | Free | Pro | Enterprise |
|---|---|---|---|
| 組織全体の有効な車両数 | 2 | 25 | 契約で設定 |
| 位置の履歴日数 | 1 | 30 | 90 |
| 車両の地点間の最短間隔 | 30 秒 | 10 秒 | 5 秒 |
| コネクター | なし | 3 | 契約で設定 |
1 つのフリートに入れられる車両は最大 500 台です。上限は新しい作業を止めるだけです。上限を超えている組織は、プランの日数を超える履歴と、プランを超えるコネクター（一時停止されます）を除き、今あるものを保持します。
フリートのページの 使用状況 には今日の件数が表示されます。受け付けた位置、破棄した位置とその理由、訪問者による閲覧 、推定の回数です。