履歴照会とトレンドグラフ

用途に応じて照会方法を選びます。少量の生データ明細は調査に、時間区間ごとのトレンドは変化の把握に使用し、大量のデータは非同期エクスポートで処理します。

照会方法

目的	方法	説明
元のサンプルを確認	履歴明細	ポイントと時間範囲を指定してページ単位で照会
トレンドを比較	グラフ照会	時間バケットを自動選択し、返却ポイント数を制限
統計をカスタマイズ	集約照会	複数ポイントに統計方法と時間粒度を個別設定
大量の明細を保存	履歴エクスポート	バックグラウンドで CSV または ZIP を生成

収集、集約、共有の履歴をトレンド分析に利用できます。共有ポイントはデバイスコードと dataKey の両方を指定し、異なるデバイスの同名ポイントを混同しないようにしてください。

トレンドグラフのデータ処理

• 粒度を自動選択するか、時間単位と間隔を手動指定できます。
• 平均、最大、最小、件数、先頭値、末尾値などの統計に対応します。データ型に応じて選択してください。
• 指定タイムゾーンに合わせて時間バケットを区切り、日ごと・時間ごとの変化を比較しやすくします。
• サンプルのない区間は空値のまま保持します。グラフではゼロとして描かず、欠損箇所を切れ目で表示してください。
• 非数値データの平均計算は適しません。件数、先頭値、末尾値を使用してください。API が返すデータ警告をグラフとともに表示してください。

積算電力量は、先頭と末尾の差および計器のリセットを考慮して分析し、積算指示値をそのまま合計しないでください。

API の例

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[] ごとに成功・失敗を返すため、グラフ API の応答構造と同じものとして扱わないでください。

履歴グラフ Skill でも照会・分析できます。長期保存が必要な場合は 定期アーカイブ を設定してください。