环境指标的统计数据

更新时间：2023-06-21 07:13:06

本文介绍环境指标的统计数据的 API。

接口描述

根据资产或者自定义维度下的节点，查询一段时间内，环境指标的统计数据，包含温湿度、CO2 和甲醛等。

接口地址

GET: /v1.1/iot-03/environment-indicators/statistics

请求参数

参数名	类型	参数位置	是否必填	说明
indicator_codes	String	query	true	环境指标，单次最多10个
dimension_code	String	query	true	维度类型
node_ids	String	query	true	维度下的节点，单次最多20个
statistics_type	String	query	false	统计粒度，默认hour hour：小时粒度 day：天粒度 month：月粒度
statistics_function	String	query	false	统计函数，默认 AVG AVG：平均值 MIN：最小值 MAX：最大值
start_time	String	query	true	开始时间，格式与 statistics_type 联动 statistics_type=hour：yyyyMMddHH statistics_type=day：yyyyMMdd statistics_type=month：yyyyMM
end_time	String	query	true	结束时间，格式与 statistics_type 联动 statistics_type=hour：yyyyMMddHH statistics_type=day：yyyyMMdd statistics_type=month：yyyyMM

返回参数

参数名	类型	说明
result	EnvironmentIndicatorRes	返回结果

result 说明

参数名	类型	说明
indicators	List	环境指标数据

indicators 说明

参数名	类型	说明
code	String	指标编码
unit	String	指标值单位
data_items	List	数据时间趋势

data_items 说明

参数名	类型	说明
value	String	指标编码
time	String	时间

请求示例

GET: GET /v1.1/iot-03/environment-indicators/statistics?indicators=air_quality_value,voc_value,pm25_value

返回示例

{
    "result": {
        "indicators": [
            {
                "code": "humidity_value",
                "unit": "%",
                "data_items": [
                    {
                        "time": "2021090116",
                        "value": "5.30"
                    }
                ]
            },
            {
                "code": "temperature_value",
                "unit": "℃",
                "data_items": [
                    {
                        "time": "2021090116",
                        "value": "26.60"
                    }
                ]
            }
        ]
    },
    "t": 1630586260147,
    "success": true
}

错误码

参考错误码。

上一篇查询资产环境指标的统计数据

下一篇会议预约系统