更新时间:2023-12-06 GMT+08:00
分享

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

功能介绍

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

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 ]
}

状态码

请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品