行人区域进入检测DetectPedestrianIntrusion的语法及示例_视觉智能开放平台(VIAPI)-阿里云帮助中心

服务说明

由于产品业务调整，行人区域进入检测服务将于2025年08月14日起停止新用户开通调用，历史开通过该服务的老用户可继续调用，2025年10月14日后该服务将下架，不再支持新老用户调用，请尽早寻找替代方案。如果对行人区域进入检测API服务使用有疑问，可通过搜索钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。

功能描述

行人区域进入检测能力基于深度学习算法，检测视频监测周界或区域是否有人员入侵。

说明

您可以进入在线咨询获取在线人工帮助。
阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。

应用场景

厂区安全监测：监测保密区域、危险区域是否有人员进入，保证工厂生产安全。
轨道交通安全：监测轨道交通的轨道等关键区域是否有人员进入，保障运行安全。

特色优势

支持多角度视角：支持多种摄像头安装角度，各种人员朝向，都能有效检测出行人。
避免非人误报：基于深度学习算法，有效区分行人和其他物体，避免非人员传入误报。

输入限制

图像格式：JPG、JPEG、BMP、PNG。
图像大小：不超过10 MB。
图像像素：小于4096×4096像素。
URL地址中不能包含中文字符。

说明当图像分辨率超过最大限制时，请先将图片进行缩放，调整图片大小，具体请参见图片缩放。

计费说明

行人区域进入检测能力目前处于公测期，可免费调用。

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DetectPedestrianIntrusion	系统规定参数。取值：DetectPedestrianIntrusion。
ImageURL	String	是	http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectPedestrianIntrusion/DetectPedestrianIntrusion2.jpg	图像URL地址。推荐使用上海地域的OSS链接，对于文件在本地或者非上海地域OSS链接的情况，请参见文件URL处理。
DetectRegion	Array	是		区域信息。
Rect	Object	否		矩形区域。当RegionType为rectangle时必填。
Left	Long	否	0	矩形区域的左上角横轴坐标。
Top	Long	否	0	矩形区域的左上角纵轴坐标。
Right	Long	否	300	矩形区域的右下角横轴坐标。
Bottom	Long	否	300	矩形区域的右下角纵轴坐标。
Line	Object	否		周界/界线。当RegionType为line时必填。
X1	Long	否	0	线段的开始顶点的横轴坐标。
Y1	Long	否	0	线段的开始顶点的纵轴坐标。
X2	Long	否	300	线段的结束顶点的横轴坐标。
Y2	Long	否	300	线段的结束顶点的纵轴坐标。
RegionType	String	是	rectangle	区域类型。 line：周界/界线，为一条线段。 rectangle：矩形区域，为一个矩形。

返回数据

名称	类型	示例值	描述
RequestId	String	AA2539F7-D139-458C-A9BA-3321318D6BC4	请求ID。
Data	Object		返回的结果数据内容。
ImageWidth	Long	899	输入图片的宽度。
ImageHeight	Long	599	输入图片的高度。
Elements	Array of Elements		人体检测框的集合。
Score	Long	0.950289249420166	检测框的置信度，范围为`[0,1]`。
Type	String	person	检测框对应的人体，取值为person。
IsIntrude	Boolean	false	判断该人体是否入侵给定的区域或界线。 true：入侵给定区域或界限。 false：未入侵给定区域或界限。
Box	Object		检测框坐标。
Left	Long	175	矩形区域的左上角横轴坐标。
Top	Long	153	矩形区域的左上角纵轴坐标。
Right	Long	418	矩形区域的右下角横轴坐标。
Bottom	Long	551	矩形区域的右下角纵轴坐标。
BoxId	Long	0	检测框的ID。

SDK参考

阿里云视觉AI人脸人体类目下的行人区域进入检测能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。

示例

请求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=DetectPedestrianIntrusion    //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectPedestrianIntrusion/DetectPedestrianIntrusion2.jpg
&DetectRegion=[{"Rect":{"Left":0,"Top":0,"Right":300,"Bottom":300},"Line":{"X1":0,"Y1":0,"X2":300,"Y2":300}}]
&RegionType=rectangle
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>AA2539F7-D139-458C-A9BA-3321318D6BC4</RequestId>
<Data>
    <ImageHeight>599</ImageHeight>
    <ImageWidth>899</ImageWidth>
    <Elements>
        <Elements>
            <BoxId>0</BoxId>
            <Score>0.950289249420166</Score>
            <Type>person</Type>
            <IsIntrude>false</IsIntrude>
            <Box>
                <Left>175</Left>
                <Top>153</Top>
                <Right>418</Right>
                <Bottom>551</Bottom>
            </Box>
        </Elements>
    </Elements>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "AA2539F7-D139-458C-A9BA-3321318D6BC4",
  "Data" : {
    "ImageHeight" : 599,
    "ImageWidth" : 899,
    "Elements" : {
      "Elements" : {
        "BoxId" : 0,
        "Score" : 0.950289249420166,
        "Type" : "person",
        "IsIntrude" : false,
        "Box" : {
          "Left" : 175,
          "Top" : 153,
          "Right" : 418,
          "Bottom" : 551
        }
      }
    }
  }
}

错误码

关于行人区域进入检测的错误码，详情请参见常见错误码。

安全声明

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