人流量统计算子
更新时间: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 | 流出人流量 |
