本文档介绍人流热度图估计CountCrowd的语法及示例。

功能描述

人流热度图估计利用热度图对图片中的人数进行估算。

应用场景

  • 人流密集场所人数统计:在举办某些人流密度较高的活动时,例如庙会、烟火表演、演唱会等,通过实时图像可以估算出现场人数,为现场安保提供数据支撑。
  • 商场货品陈列:通过统计叠加一段时间内的人流热度图,可以获悉哪些区域有更多人流经过,推断客户对哪些商品更感兴趣,为商品陈列做参考,以获得更高客单价。

特色优势

支持高密集人群数量统计:面对较高的密集人群,一般的视觉检测算法已经无法统计人数。而人流热度图估计算法,支持在高密集人群中统计大概人数。

前提条件

请确保您已开通人脸人体服务,若未开通服务请立即开通

输入限制

  • 图片格式:JPG、JPEG、PNG、BMP。
  • 图片大小:图片大小不超过3M。
  • 图片分辨率:分辨率要求大于32×32像素,小于4096×4096像素。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CountCrowd

系统规定参数。取值:CountCrowd。

ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/October/CountCrowd1.jpg

图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

IsShow Boolean true

是否返回热度图。

  • true:返回。
  • false:不返回。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

HotMap String http://vibktprfx-prod-prod-aic-iv-cn-shanghai.oss-cn-shanghai.aliyuncs.com/crowd-counting%2F54ef06866834412984754eec9e84b3cf.jpg?OSSAccessKeyId=LTAI4G4YbtUh1c7BhUoTTAzS&Expires=160336****&Signature=BHP0442VLtN50EFPBdd5Vrjj1%2B****

热度图的URL地址,3600秒有效。

说明 当请求参数 IsShowtrue时返回该参数。
PeopleNumber Integer 66

图片中估计的人数。

RequestId String 11B52F13-59C3-4785-B6A3-45A1DA9FF2AA

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CountCrowd
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/October/CountCrowd1.jpg
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>11B52F13-59C3-4785-B6A3-45A1DA9FF2AA</RequestId>
<Data>
    <HotMap>http://vibktprfx-prod-prod-aic-iv-cn-shanghai.oss-cn-shanghai.aliyuncs.com/crowd-counting%2F54ef06866834412984754eec9e84b3cf.jpg?OSSAccessKeyId=LTAI4G4YbtUh1c7BhUoTTAzS&amp;Expires=160336****&amp;Signature=BHP0442VLtN50EFPBdd5Vrjj1%2B****</HotMap>
    <PeopleNumber>66</PeopleNumber>
</Data>

JSON 格式

{
    "RequestId": "11B52F13-59C3-4785-B6A3-45A1DA9FF2AA",
    "Data": {
        "HotMap": "http://vibktprfx-prod-prod-aic-iv-cn-shanghai.oss-cn-shanghai.aliyuncs.com/crowd-counting%2F54ef06866834412984754eec9e84b3cf.jpg?OSSAccessKeyId=LTAI4G4YbtUh1c7BhUoTTAzS&amp;Expires=160336****&amp;Signature=BHP0442VLtN50EFPBdd5Vrjj1%2B****",
        "PeopleNumber": 66
    }
}

错误码

关于人流热度图估计的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。