云服务 API 参考行业场景垂直行业解决方案电量统计用电统计查询指定维度节点能源数据时间趋势

查询指定维度节点能源数据时间趋势

更新时间：2023-06-21 07:13:04下载pdf

本文介绍查询指定维度节点能源数据时间趋势的 API。

接口描述

查询一定时间范围内，资产下或者自定义维度下的能源统计数据，包括水、电、气的使用、生成或转储统计数据。

接口地址

GET: /v1.0/iot-03/energy/{energy_type}/statistics

请求参数

参数名	类型	参数位置	是否必填	说明
energy_type	String	uri	true	能源类型，仅支持电: electricity
energy_action	String	query	true	能源行为，仅支持消耗: consume
dimension_code	String	query	true	维度 Code，支持 asset（资产）或其它自定义维度 Code
node_ids	String	query	true	指定维度节点 ID，最多支持 10 个节点
statistics_type	String	query	true	统计粒度， month：月，格式为 yyyyMM，最大跨度12个月，只能查询最近一年的数据 day：天，格式为 yyyyMMdd，最大跨度7天，只能查询最近 90 天的数据 hour：小时，格式为 yyyyMMddHH，最大跨度 24 小时，只能查询最近 7 天的数据
start_time	String	query	true	开始时间
end_time	String	query	true	结束时间

返回参数

参数名	类型	说明
result	List

result 说明

参数名	类型	说明
node_id	String	维度节点
items	List	能源数据时间趋势

items 说明

参数名	类型	说明
time	String	时间
value	Float	能源数据

请求示例

GET: /v1.0/iot-03/energy/electricity/statistics?energy_action=consume&dimension_code=asset&node_ids=138803317715****&statistics_type=hour&start_time=2021080422&end_time=2021080423

返回示例

{
    "result": [
        {
            "items": [
                {
                    "time": "2021080400",
                    "value": 10
                },
                {
                    "time": "2021080401",
                    "value": 20
                }
            ],
            "node_id": "123432"
        },
        {
            "items": [
                {
                    "time": "2021080400",
                    "value": 10
                },
                {
                    "time": "2021080401",
                    "value": 20
                }
            ],
            "node_id": "2423232"
        }
    ],
    "t": 1624525873263,
    "success": true
}

错误码

参考错误码。

上一篇用电统计