人流量统计
更新时间:2022-01-18
对于输入的一张图片(可正常解码,且长宽比适宜),识别和统计图像当中的人体个数(静态统计,暂不支持追踪和去重)。 适用于3米以上的中远距离俯拍,以头部为主要识别目标统计人数,无需正脸、全身照,适应各类人流密集场景(如:机场、车展、景区、广场等);默认识别整图中的人数,支持指定不规则区域的人数统计,同时可输出渲染图片。
摄像头硬件选型无特殊要求,分辨率建议720p以上,更低分辨率的图片也能识别,只是效果可能有差异。暂不适用夜间红外监控图片,后续会考虑扩展。
渲染图示意如下:
注:接口默认返回整张图片中的人数,如需统计特定框选区域的人数,请使用area参数添加识别区域坐标信息。
public void BodyNumDemo() {
var image = File.ReadAllBytes("图片文件路径");
// 调用人流量统计,可能会抛出网络等异常,请使用try/catch捕获
var result = client.BodyNum(image);
Console.WriteLine(result);
// 如果有可选参数
var options = new Dictionary<string, object>{
{"area", "0,0,100,100,200,200"},
{"show", "false"}
};
// 带参数调用人流量统计
result = client.BodyNum(image, options);
Console.WriteLine(result);
}
人流量统计 请求参数详情
参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
---|---|---|---|---|
image | 是 | string | - | 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。图片的base64编码是不包含图片头的,如(data:image/jpg;base64, ),支持图片格式:jpg、bmp、png,最短边至少50px,最长边最大4096px |
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,false | 是否输出渲染的图片,默认不返回,选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="
}