人流量统计算子
更新时间:2021-01-11
人流量统计算子
统计图片中的人体个数和流动趋势,支持静态人数统计和动态人数统计和跟踪;
请求Url
POST /v1/human/traffic/detect HTTP/1.1
Request参数
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
image_base64 | 必选 | String | 图片base64编码,iamge_base64和image_url二选一即可,优先使用image_base64 |
image_url | 必选 | String | 图片url,只有当image_base64为空时才会使用image_url下载图片再base64编码,增加下载时延 |
min_score | 可选 | Double | 最小置信度,如果指定该参数,会对检测、识别结果按min_score过滤,只保留置信度大于min_score的特征结果 |
dynamic | 可选 | Boolean | 标识是静态人流量检测还是动态人流量检测,静态检测只返回人数,动态检测会跟踪图片,返回进入/离开人流量,官方建议最小2fps |
case_id | 可选 | Integer | 同一用户下用于区分不同视频流 |
area | 可选 | 二维数组 | 指定统计时的特定框选区域坐标,最多支持1个区域,如输入超过1个区域,截取第1个区域进行识别,同一个区域内的坐标用英文逗号“,”分隔,默认尾点和首点相连做闭合,示例:[[x1,y1,x2,y2,x3,y3...xn,yn]] |
说明:静态人流量统计可以不指定检测区域area,默认为图片全区域检测;动态人流量统计必须指定检测区域area;
Response参数
参数 | 类型 | 说明 |
---|---|---|
code | Integer | 0:请求成功,非0:请求失败 |
message | String | 请求成功message为空,请求失败为失败提示信息 |
data | Object | 响应对象实体,包括属性列表和属性数量 |
+items | List | 人流量列表 |
++ID | Integer | 人体标识 |
++location | Object | 位置信息 |
+++left | Integer | 位置相对左边框的坐标 |
+++top | Integer | 位置相对上边框的坐标 |
+++width | Integer | 人体宽度 |
+++height | Integer | 人体高度 |
+item_count | Integer | 识别的item个数 |
+person_count | Object | 动态人流量数据 |
++in | Integer | 流入人流量 |
++out | Integer | 流出人流量 |