云服务 API 参考行业场景垂直行业解决方案空间环境管理环境数据查询环境指标的统计数据

环境指标的统计数据

更新时间：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
}

错误码

参考错误码。

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

下一篇会议预约系统