歷史查詢與趨勢圖

按用途選擇查詢方式：少量原始明細用於排查，分桶趨勢用於看變化，大量資料交給非同步匯出。

查詢方式

需求	方式	說明
檢視原始取樣	歷史明細	按點位和時間範圍分頁查詢
比較趨勢	圖表查詢	自動選擇時間桶，限制回傳點數
自訂統計	聚合查詢	多個點位分別設定統計方式和時間粒度
儲存大量明細	歷史匯出	後端產生 CSV 或 ZIP

擷取、聚合與共享歷史可用於趨勢分析。共享點位同時指定裝置編碼和 dataKey，避免把不同裝置的同名點位混在一起。

趨勢圖怎樣處理資料

• 可自動選擇粒度，也可手動指定時間單位及間隔。
• 支援平均值、最大值、最小值、計數、首值、末值等統計，按資料型別選擇。
• 按指定時區對齊時間桶，方便比較每日或每小時變化。
• 沒有樣本的區間保留為空值，圖表應顯示斷點，避免畫成零。
• 非數值資料不適合求平均；可改用計數、首值或末值。介面會回傳資料警告，應與圖表一起展示。

累計電量應結合首末差值和表計復位情況分析，不直接累加累計讀數。

介面示例

POST /ems-data/chart/query，請求頭攜帶登入 token：

{
  "series": [{"dataKey": "demo_temperature", "statistics": ["AVG", "MAX"]}],
  "startTime": "2026-10-01T00:00:00+08:00",
  "endTime": "2026-10-02T00:00:00+08:00",
  "bucketMode": "AUTO",
  "targetPoints": 200,
  "timezone": "Asia/Shanghai"
}

結果中的 series[].statistics 包含各條統計曲線，同時回傳實際分桶間隔和 warnings。示例點位需替換為裝置上的真實點位。

歷史明細使用 POST /ems-data/history；自訂聚合使用 POST /ems-data/aggregate/query，後者按 data.items[] 分別回傳成功或失敗結果，不能當作圖表介面的回傳結構。

也可使用 歷史圖表 Skill 查詢和分析。需要長期儲存資料時，設定 週期歸檔。