首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >智能视觉人流量统计API-多人客流监测分析-全域人数统计接口功能介绍

智能视觉人流量统计API-多人客流监测分析-全域人数统计接口功能介绍

原创
作者头像
聚美智数
发布2026-07-14 15:47:10
发布2026-07-14 15:47:10
550
举报

前言

依托高精度人体视觉识别技术,可对监控画面进行实时人体检测与精准人流量统计,支持多人重叠、人体遮挡、高低俯拍、多角度人脸、大幅动作等复杂实景场景。系统可实时输出画面内人体数量、人员坐标位置等数据,有效解决传统人流量统计漏检、误检、抗干扰差的问题,具备强适配性与高稳定性,可全天候自动完成人员进出、区域驻留人数统计,为各场景客流监管、数据分析、智能运维提供精准的数据支撑。

在下面的这些场景中,使用接口简化人力行为,自动识别流量。

  1. 商业商场、门店客流统计与运营分析
  2. 园区、写字楼楼宇人员进出管控
  3. 校园、场馆人员容量监测管理
  4. 地铁、车站交通枢纽客流监测
  5. 景区、展馆文旅场所客流管控
  6. 城市公共区域安全客流监测预警

静态版API介绍

请求说明

名称

类型

必须

说明

image

String

图片base64

url

String

图片地址

area

String

特定区域坐标选择,支持多个多边形区域。如输入超过10个区域,截取前10个区域进行识别。例如:x1,y1,x2,y2,x3,y3…xn,yn同一个区域内的坐标使用英文逗号“,”分隔,默认尾点和首点相连做闭合,例:”1,1,620,1,620,620,1,620”多个区域使用英文分号“;”分隔。例如:1,1,1,720,100,720…100,1;200,1,200,720…300,720,300,1;…注意:area区域坐标从(1,1)开始,坐标大于或等于原图大小,以及x、y坐标未成对出现都是错误的注意:设置了多个区域时,任意一个坐标设置错误,则认为area参数错误、失效。注意:若此参数为空或无此参数、或area参数设置错误时,默认识别整张图片中的人数。

show

String

是否输出渲染的图片,默认false不返回,选true时返回渲染后的图片(base64)。若此字段为无效值或为空则默认false

返回样例

代码语言:javascript
复制
{
  "code": 200, // 返回码,详见返回码说明
  "msg": "成功",  // 返回码对应描述
  "taskNo": "65605503936940344488", // 本次请求号
  "charge": false, // 计费标志
  "data": {
    "areaCounts": [ //每一个区域框中人数,仅当area参数有效时才会返回,否则该字段不返回。
      1,
      5,
      8
    ],
    "personNum":"1", //识别出的人体数目;若多个区域之间有重合,则是所有区域的并集人体数目。
    "image":"/aj/4MHo...FS2P/9=" //渲染后的图片base64字符串,不包含图片头
  }
}

动态版API介绍

请求说明

名称

类型

必须

说明

image

String

图片base64

url

String

图片地址

area

String

特定区域坐标选择,支持多个多边形区域。如输入超过10个区域,截取前10个区域进行识别。例如:x1,y1,x2,y2,x3,y3…xn,yn同一个区域内的坐标使用英文逗号“,”分隔,默认尾点和首点相连做闭合,例:”1,1,620,1,620,620,1,620”多个区域使用英文分号“;”分隔。例如:1,1,1,720,100,720…100,1;200,1,200,720…300,720,300,1;…注意:area区域坐标从(1,1)开始,坐标大于或等于原图大小,以及x、y坐标未成对出现都是错误的注意:设置了多个区域时,任意一个坐标设置错误,则认为area参数错误、失效。注意:若此参数为空或无此参数、或area参数设置错误时,默认识别整张图片中的人数。

show

String

是否输出渲染的图片,默认false不返回,选true时返回渲染后的图片(base64)。若此字段为无效值或为空则默认false

返回样例

代码语言:javascript
复制
{
  "code": 200, // 返回码,详见返回码说明
  "msg": "成功",  // 返回码对应描述
  "taskNo": "65605503936940344488", // 本次请求号
  "charge": false, // 计费标志
  "data": {
    "personNum": "1", //识别出的人体数目
    "personInfo"://每个框的具体信息
    [
      {
        "ID":3,//人体的ID编号,ID的取值逻辑为:每个case从1开始,不同人体向上递增但不一定连续
        "location"://跟踪到的人体框位置
        {
          "left": 100,//人体框左坐标
          "top": 200,//人体框顶坐标
          "width": 200,//人体框宽度
          "height": 400//人体框高度
        }
      },
      {
        "ID": 5,
        "location":
        {
          "left": 400,
          "top": 200,
          "width": 200,
          "height": 400
        }
      }
    ],
    "personCount"://进出区域的人流统计
    {
      "in":0,//当前帧进入区域的瞬时人数;如需计算一段时间内进入区域的累计人数,可根据连续帧图片的返回结果计算。
      "out":1//当前帧离开区域的瞬时人数;如需计算一段时间内进入区域的累计人数,可根据连续帧图片的返回结果计算。
    }
  }
}

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 前言
  • 静态版API介绍
    • 请求说明
    • 返回样例
  • 动态版API介绍
    • 请求说明
    • 返回样例
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档