历史查询与趋势图

按用途选择查询方式：少量原始明细用于排查，分桶趋势用于看变化，大量数据交给异步导出。

查询方式

需求	方式	说明
查看原始采样	历史明细	按点位和时间范围分页查询
比较趋势	图表查询	自动选择时间桶，限制返回点数
自定义统计	聚合查询	多个点位分别设置统计方式和时间粒度
保存大量明细	历史导出	后台生成 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 查询和分析。需要长期保存数据时，配置周期归档。