履歴
履歴
概要
移動局の動態履歴を検索・表示・ダウンロードする機能。3つのタブで構成されており、「履歴検索」は常時表示、「一括ダウンロード」と「ジオフェンス履歴」はオプション機能の有効状態によって表示が切り替わる。
アクセス権限：全ユーザー（オプション機能による表示制限あり）。サイドバー「履歴」から遷移。
URL
ホーム画面（/home）内のタブパネルとして表示される。独立したURLは持たない。
画面構成
タブ構成
| タブ名 | 表示条件 |
|---|---|
| 履歴検索 | 常時 |
| 一括ダウンロード | オプション機能「一括ダウンロード」が有効な場合のみ |
| ジオフェンス履歴 | オプション機能「ジオフェンス」が有効な場合のみ |
履歴検索タブ
移動局を指定して期間・間隔を条件に動態履歴を検索し、地図上にアニメーション表示および一覧表示する。
検索フォーム
検索条件は折りたたみ/展開ボタン（「検索条件」ラベル＋展開アイコン）で表示を切り替えられる。
移動局
| 項目 | 型 | 説明 |
|---|---|---|
| 移動局 | オートコンプリート | 単一選択。移動局が未選択の場合、検索ボタンは無効 |
- 移動局ポップアップの「履歴ページ」から遷移した場合、移動局が自動セットされて検索が自動実行される
期間
| 項目 | 型 | 制約 | 説明 |
|---|---|---|---|
| 開始日 | DatePicker | データ保持期間内の日付のみ選択可（未来日不可） | |
| 開始時 | セレクト | 0〜23 | |
| 開始分 | セレクト | 0〜59 | |
| 終了区分 | セレクト | 当日 / 翌日 | 開始日からの相対日付 |
| 終了時 | セレクト | 0〜23 | |
| 終了分 | セレクト | 0〜59 |
終了時刻の制約： - 終了区分が「当日」の場合: 終了時刻 ≥ 開始時刻 - 終了区分が「翌日」の場合: 終了時刻 ≤ 開始時刻（24時間以内に収める）
履歴間隔
| 選択肢 | 値（秒） |
|---|---|
| すべて | 0 |
| 10秒 | 10 |
| 20秒 | 20 |
| 30秒 | 30 |
| 1分 | 60 |
| 3分（デフォルト） | 180 |
| 5分 | 300 |
| 10分 | 600 |
| 30分 | 1800 |
| 60分 | 3600 |
| 90分 | 5400 |
| 180分 | 10800 |
デフォルト値は 180（3分）。
ボタン
| ボタン | 表示条件 | 動作 |
|---|---|---|
| 検索 | 常時 | 移動局が未選択の場合は disabled。条件に従い動態履歴を取得して一覧表示 |
検索結果一覧
ヘッダー
| 要素 | 説明 |
|---|---|
| タイトル | 「履歴検索の結果」 |
| CSVダウンロードボタン | クリックで動態履歴 CSV を出力（後述） |
| 印刷ボタン | クリックで印刷画面へ遷移 |
| 並び順セレクト | 「新しい順」「古い順」。アニメーション中は disabled |
表示オプション
| 要素 | 説明 |
|---|---|
| 履歴間のライン表示チェックボックス | ON/OFF で履歴点間の結線を地図上に表示 |
| 線の太さセレクト | 1〜5px |
履歴行の表示項目
| 列 | 内容 |
|---|---|
| 状態アイコン | 動態状態に対応するアイコン |
| 日時 | 月日:時:分:秒 |
| 速度 | 速度値（地図設定に従い km/h または mph） |
| 走行距離 | 前回履歴からの走行距離 |
| ACC状態 | ACC ON / OFF |
| ジオイベント種別 | 入域・退域などのジオフェンスイベント（該当する場合のみ） |
| 状態名 | 動態状態名称 |
| 住所 | 「...」クリックで詳細住所 API を取得して表示。取得中は「取得中...」と表示 |
行の選択動作: - 選択行は緑の左ボーダー＋水色背景でハイライト - 地図上の該当地点へ自動センタリング
ページネーション
1ページあたり一定件数を表示。
アニメーション操作
検索結果表示後、地図上の履歴点をアニメーション再生できる。
| ボタン | アイコン | 動作 |
|---|---|---|
| 再生 | ▶ | アニメーション開始 |
| 2倍速 | ⏩ | 2倍速で再生 |
| 次へ | ⏏（回転） | 1ステップ進む |
| 一時停止 | ⏸ | 再生を一時停止 |
| 中止 | ⏹ | アニメーションを中止して初期状態へ |
アニメーション中は並び順セレクトが disabled になる。
CSVダウンロード
| 要素 | 内容 |
|---|---|
| ダイアログタイトル | 「動態履歴」 |
| 「中断」ボタン | クリックでダウンロードを中断 |
ダウンロード中は進行ダイアログを表示。完了後にファイルが自動保存される。
エラーメッセージ（履歴検索）
| 条件 | メッセージ |
|---|---|
| 検索結果が0件 | 条件に一致する動態履歴が存在しませんでした。 |
| 取得失敗 | 動態履歴取得に失敗しました |
一括ダウンロードタブ
オプション機能「一括ダウンロード」が有効な場合のみ表示。複数の移動局を対象に期間・出力条件を指定して動態履歴 CSV を一括ダウンロードする。
一括ダウンロードフォーム
ファイル名
| 項目 | 型 | 初期値 | 説明 |
|---|---|---|---|
| ファイル名 | テキスト | 動態履歴_YYYYMMDD（当日付） |
任意のファイル名を入力。未入力では「一括ダウンロード」ボタンが disabled |
期間
| 項目 | 型 | 説明 |
|---|---|---|
| 開始日時 | DatePicker＋時分セレクト | |
| 終了日時 | DatePicker＋時分セレクト |
移動局
- オートコンプリートによる複数選択（チェックボックス付き）
- 未入力時は「選択できる移動局が存在しません」と表示
- 特殊選択肢（グレー背景）:
- すべて: 全移動局を一括選択/解除
- 表示移動局のすべてを対象: 検索テキストでフィルタリングされた表示中の移動局を一括選択/解除
- 選択済みの移動局はチップで表示され、縦スクロール対応エリアに収まる
出力イベント
チェックボックスで出力するイベント種別を選択する。
| 項目 | 表示条件 |
|---|---|
| すべて（一括選択） | 常時 |
| 開/閉局（ACC） | 常時 |
| 4つボタン | オプション機能「4つボタン」が有効な場合のみ |
| 緊急スイッチ | オプション機能「緊急スイッチ」が有効な場合のみ |
| タクシーメータ | オプション機能「タクシーメーター」が有効な場合のみ |
| 業務ボタン | オプション機能「業務ボタン」が有効な場合のみ |
| ドア開/閉 | オプション機能「ドアセンサー」が有効な場合のみ |
| イベント以外（Others） | 常時 |
出力項目
マルチセレクトドロップダウンで出力する列を選択する。選択済み項目はドラッグ&ドロップで列順を変更できる。
| 項目 | 表示条件 |
|---|---|
| 日時 | 常時 |
| 車番 | 常時 |
| 移動局名称 | 常時 |
| 方位 | 常時 |
| 方位名 | 常時 |
| 速度 | 常時 |
| 開閉局状態値 | 常時 |
| 開閉局状態名 | 常時 |
| 緯度（日本測地） | 常時 |
| 緯度（世界測地） | 常時 |
| 経度（日本測地） | 常時 |
| 経度（世界測地） | 常時 |
| 住所 | 常時 |
| 4ボタン状態値 | オプション機能「4つボタン」が有効な場合のみ |
| 4ボタン状態名 | オプション機能「4つボタン」が有効な場合のみ |
| 10キー状態値 | オプション機能「業務ボタン」が有効な場合のみ |
| 10キー状態名 | オプション機能「業務ボタン」が有効な場合のみ |
| 緊急スイッチ状態値 | オプション機能「緊急スイッチ」が有効な場合のみ |
| 緊急スイッチ状態名 | オプション機能「緊急スイッチ」が有効な場合のみ |
| ドア開閉状態値 | オプション機能「ドアセンサー」が有効な場合のみ |
| ドア開閉状態名 | オプション機能「ドアセンサー」が有効な場合のみ |
| タクシーメーター状態値 | オプション機能「タクシーメーター」が有効な場合のみ |
| タクシーメーター状態名 | オプション機能「タクシーメーター」が有効な場合のみ |
一括ダウンロードボタン
| 状態 | 条件 |
|---|---|
| disabled | ファイル名・移動局・出力イベント・出力項目のいずれかが未入力/未選択 |
| ローディング中 | ダウンロード実行中（二重クリック防止） |
クリック後、動態履歴データを取得してCSVとして自動ダウンロードする。処理はサーバー側のダウンロード履歴に記録される。
エラー時のトースト:
| 条件 | メッセージ |
|---|---|
| 検索結果が0件 | 履歴はありません。 |
| システムエラー | システムエラーです。 |
| その他のエラー | サーバーからのエラーメッセージを表示 |
ダウンロード履歴
「履歴」ボタン（右上、緑の枠線付きアウトラインボタン）をクリックするとダウンロード履歴ダイアログが表示される。
| 列名 | 内容 |
|---|---|
| 開始時間 | ダウンロード開始日時（YYYY/MM/DD HH:mm:ss） |
| 終了時間 | ダウンロード終了日時。未完了の場合は「NO DATE」 |
| ファイル名 | 指定したファイル名 |
| ステータス | 実行中 / 完了 / エラー（エラーは赤字表示） |
| 理由 | ステータス詳細（エラー原因など） |
「閉じる」ボタンでダイアログを閉じる。
ジオフェンス履歴タブ
オプション機能「ジオフェンス」が有効な場合のみ表示。移動局の目印への入退出履歴を CSV でダウンロードする。
タブ名はオプション設定のラベルに応じて変化する（例：「ジオフェンス履歴」など）。
ジオフェンス履歴フォーム
| 項目 | 型 | 説明 |
|---|---|---|
| 目印 | マルチセレクトドロップダウン（チェックボックス付き） | ジオフェンスが設定された目印を一覧表示。削除済みの目印は「[削除済]」と表示 |
| 開始日時 | DatePicker＋時分 | |
| 終了日時 | DatePicker＋時分 | |
| 移動局 | マルチセレクトドロップダウン（チェックボックス付き） |
目印ドロップダウンの特殊動作: - 「すべて」選択肢で全目印を一括選択/解除 - 目印はドラッグ&ドロップで並び順を変更可能（変更順が CSV の出力順に反映される） - 未入力時はローディングスピナーを表示
ダウンロードボタンの有効条件: 目印と移動局の両方が1件以上選択されていること。
CSVダウンロード（ジオフェンス履歴）
「ダウンロード」ボタンクリックでジオフェンス履歴を取得し、CSV として自動ダウンロードする。
CSV 列:
日時,車番,移動局名,目印名称,半径,種別
ファイル名: 入退出履歴_YYYYMMDDHHmmss（ダウンロード実行日時）
データが0件の場合はヘッダー行のみのCSVを出力する。