人流量统计
更新时间：2025-08-05
对于输入的一张图片（可正常解码，且长宽比适宜），识别和统计图像当中的人体个数（静态统计，暂不支持追踪和去重）。
适用于3米以上的中远距离俯拍，以头部为主要识别目标统计人数，无需正脸、全身照，适应各类人流密集场景（如：机场、车展、景区、广场等）；默认识别整图中的人数，支持指定不规则区域的人数统计，同时可输出渲染图片。
摄像头硬件选型无特殊要求，分辨率建议720p以上，更低分辨率的图片也能识别，只是效果可能有差异。暂不适用夜间红外监控图片，后续会考虑扩展。
渲染图示意如下：
注：接口默认返回整张图片中的人数，如需统计特定框选区域的人数，请使用area参数添加识别区域坐标信息。
Json::Value result;
std::string image;
aip::get_file_content("/assets/sample.jpg", &image);
// 调用人流量统计
result = client.body_num(image, aip::null);
// 如果有可选参数
std::map<std::string, std::string> options;
options["area"] = "x1,y1,x2,y2,x3,y3...xn,yn";
options["show"] = "false";
// 带参数调用人流量统计
result = client.body_num(image, options);人流量统计 请求参数详情
| 参数名称 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| image | 是 | std::string | 图片数据的二进制字符串，可以使用aip::get_file_content函数获取 |
| area | 否 | std::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 | 否 | std::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="
}