文档首页/ 行业视频管理服务 IVM/ API参考/ 行业数据流管理/ 智能统计/ 查询人流统计日周月年信息
更新时间：2024-05-21 GMT+08:00
查看PDF
分享

查询人流统计日周月年信息

功能介绍

查询人流统计信息（数据来源为过线统计算法），仅支持好望设备

URI

GET /v1/{user_id}/statistics/people

表1 路径参数

参数

是否必选

参数类型

描述

user_id

是

String

用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节
表2 Query参数

参数

是否必选

参数类型

描述

channel_id

是

String

通道ID：

好望设备：取值范围[0,999]

device_id

是

String

设备ID：

好望设备：大小写字母、数字组成，长度范围[8,32]，可在设备外壳或者设备web页面上获取

end_date

否

String

结束时间：日期格式为yyyyMMdd

type为DAY或者YEAR时不用填写

type为WEEK或者MONTH时不填默认取start_date值

type为CUSTOMIZE时必填

start_date

是

String

开始时间：日期格式为yyyyMMdd

type为DAY时，查询start_date当天人流信息

type为WEEK时，查询start_date当周人流信息

type为MONTH时，查询start_date当月人流信息

type为YEAR时，查询start_date当年人流信息

type

是

String

报表类型：枚举类型

枚举值：

  • DAY 日统计

  • WEEK 周统计，需注意的是，如果start_date和end_date的日期跨度大于等于7天，会以MONTH 模式处理和返回数据

  • MONTH 月统计，需注意的是，如果start_date和end_date的日期跨度小于7天，会以WEEK 模式处理和返回数据

  • YEAR 年统计

  • CUSTOMIZE 自定义统计，预留，暂不使用

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Access-Token

是

String

用户认证AccessToken：从获取用户北向接口认证AccessToken中获取

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

in

Array of integers

进入人数列表

type是DAY时返回是当天24小时的人流流入统计数据

type是WEEK时返回是当周7天的人流流入统计数据

type是MONTH时返回是当月天数的人流流入统计数据

type是YEAR时返回是当年12个月的人流流入统计数据

out

Array of integers

离开人数列表

type是DAY时返回是当天24小时的人流流出统计数据

type是WEEK时返回是当周7天的人流流出统计数据

type是MONTH时返回是当月天数的人流流出统计数据

type是YEAR时返回是当年12个月的人流流出统计数据

请求示例

查询人流统计日月周年信息

GET /v1/2562572829***/statistics/people?channel_id=0&device_id=0&start_date=20200101&end_date=20200101&type=YEAR

响应示例

状态码： 200

OK

{
  "in" : [ 100, 200, 100, 100, 100, 100, 200, 100, 100, 100, 100, 100 ],
  "out" : [ 100, 200, 200, 100, 100, 100, 200, 100, 100, 100, 100, 100 ]
}

状态码

请参见状态码

错误码

请参见错误码

父主题： 智能统计

相关文档