人流量统计
更新时间:2022-01-18
对于输入的一张图片(可正常解码,且长宽比适宜),识别和统计图像当中的人体个数(静态统计,暂不支持追踪和去重)。
适用于3米以上的中远距离俯拍,以头部为主要识别目标统计人数,无需正脸、全身照,适应各类人流密集场景(如:机场、车展、景区、广场等);默认识别整图中的人数,支持指定不规则区域的人数统计,同时可输出渲染图片。
摄像头硬件选型无特殊要求,分辨率建议720p以上,更低分辨率的图片也能识别,只是效果可能有差异。暂不适用夜间红外监控图片,后续会考虑扩展。
渲染图示意如下:
注:接口默认返回整张图片中的人数,如需统计特定框选区域的人数,请使用area参数添加识别区域坐标信息。
""" 读取图片 """
def get_file_content(filePath):
with open(filePath, 'rb') as fp:
return fp.read()
image = get_file_content('example.jpg')
""" 调用人流量统计 """
client.bodyNum(image);
""" 如果有可选参数 """
options = {}
options["area"] = "x1,y1,x2,y2,x3,y3...xn,yn"
options["show"] = "false"
""" 带参数调用人流量统计 """
client.bodyNum(image, options)
人流量统计 请求参数详情
参数名称 | 是否必选 | 类型 | 说明 |
---|---|---|---|
image | 是 | string | 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式 |
area | 否 | string | 特定框选区域坐标,支持多个多边形区域,最多支持10个区域,如输入超过10个区域,截取前10个区域进行识别。 此参数为空或无此参数、或area参数设置错误时,默认识别整个图片的人数 。 area参数设置错误的示例:某个坐标超过原图大小,x、y坐标未成对出现等;注意:设置了多个区域时,任意一个坐标设置错误,则认为area参数错误、失效。 area参数设置格式: 1)多个区域用英文分号“;”分隔; 2)同一个区域内的坐标用英文逗号“,”分隔,默认尾点和首点相连做闭合。 示例: 1)单个多边形区域:x1,y1,x2,y2,x3,y3...xn,yn 2)多个多边形区域:xa1,ya1,xa2,ya2,xa3,ya3...xan,yan;xb1,yb1,xb2,yb2,xb3,yb3...xbn,ybn;.. |
show | 否 | string | 是否输出渲染的图片,默认不返回,选true时返回渲染后的图片(base64),其它无效值或为空则默认false |
人流量统计 返回数据参数详情
字段 | 是否必选 | 类型 | |
---|---|---|---|
person_num | 是 | uint64 | 识别出的人体数目;当未设置area参数时,返回的是全图人数;设置了有效的area参数时,返回的人数是所有区域的人数总和(所有区域求并集后的不规则区域覆盖的人数) |
image | 否 | string | 渲染后的图片,输入参数show=true时输出该字段 |
area_counts | 否 | array | 每一个框选区域的人数,仅当请求中有area参数且参数有效时才会返回,否则该字段不返回;成功返回示例:[5,3,8] |
人流量统计 返回示例
{
"log_id": 716033439,
"person_num": 16,
"image": "/9j/4AAoFS2P/9k="
}