混雑予測のしくみとデータ要件

日々更新している混雑度は、利用者向けページの「本日の混雑予測」グラフと「一週間の混雑傾向」ヒートマップの材料になります。この記事では、予測がどう作られるか・いつ反映されるか・どうすれば早く表示できるかを説明します。

予測の作られ方

項目	内容
集計元	直近 28 日分の混雑度の記録(手動更新・機器連携・過去補完のすべて)
計算方法	曜日 × 時間帯ごとの中央値(「よくある値」)
更新タイミング	1 日 1 回、毎朝 5 時(日本時間)
表示される時間帯	営業スケジュール上の営業時間内のみ

予測に採用された記録の数によって、利用者向けの表示が変わります。件数は「日付 × 時間帯」の組で数えます — 同じ時間帯に何度更新しても 1 件で、休業日や営業時間外の記録は数えません。

予測に採用された記録数(直近 28 日)	表示
200 件以上	予測グラフ・ヒートマップとも通常表示
50〜199 件	「参考値」のバッジ付きで表示
50 件未満	グラフに「データ収集中のため精度が低い場合があります」の注意が付き、ヒートマップは表示されません(「十分なデータが集まるまでお待ちください」)

予測の表示は利用者向けの機能のため、管理画面には専用の画面はありません。次のどちらかで確認できます。

状況	対処
「混雑傾向はデータが蓄積されると表示されます」のまま	まだ予測が一度も計算されていません。混雑度の更新を続けるか、過去補完でデータを入れて翌朝を待ってください
予測と実際がずれている	予測は過去 4 週間の「よくある値」です。天候やイベントによる変動は反映されません。更新の頻度を上げると精度が育ちます
週間傾向に表示されない時間帯がある	ヒートマップは週次ルールの営業時間の範囲だけを表示します。営業時間を変更した場合は翌朝の再計算後に反映されます