本文为您介绍车辆拥堵检测DetectVehicleICongestion的语法及示例。

功能描述

车辆拥堵检测根据图片中的车辆,判断是否发生拥堵。

应用场景

  • 停车场拥堵检测:通过停车场摄像头间隔时间内捕捉的两张图像,检测车辆以及相对位置,判断是否发生拥堵。
  • 道路拥堵检测:通过道路监控间隔时间内捕捉的前后图像,检测车辆以及相对位置,判断是否发生拥堵。

特色优势

检测数据量少:无需较大数据量的视频,仅通过检测两张图片,即可判断是否发生拥堵。

前提条件

请确保您已开通目标检测服务,若未开通服务请立即开通

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP。
  • 图像大小:不超过500KB。
  • 图像分辨率:大于20×20像素,小于800×800像素,长宽比小于等于2。
  • URL地址中不能包含中文字符。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/zhangchaorun/test-yace/capture_images_000069.jpg

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

RoadRegions Array

多个区域。

RoadRegion Array

任意四边形的四个顶点的坐标X和Y,格式为[x1,y1,x2,y2,x3,y3,x4,y4]

Point Object

四边形的顶点坐标。

X Long 400

坐标点的X值。

Y Long 400

坐标点的Y值。

PreRegionIntersectFeatures Array

前一帧画面与各个指定区域相交集的车辆检测框对应的车辆特征。

Features Array of String AEAMQQAAAA****ABhC

Base64编码的字符串。

返回数据

名称 类型 示例值 描述
RequestId String 4CA8C0D1-DFC6-4967-8417-ED2B00815BC1

请求ID。

Data object

返回的结果数据内容。

Elements Array of Element

车辆检测框的集合。

Boxes Array of Boxes

检测框坐标,格式为[left, top, right, bottom]

Left Long 341

矩形区域的左上角横轴坐标。

Top Long 434

矩形区域的左上角纵轴坐标。

Right Long 589

矩形区域的右下角横轴坐标。

Bottom Long 576

矩形区域的右下角纵轴坐标。

Score Float 0.962890625

检测框的置信度,范围为[0,1]

TypeName String vehicle

检测框对应的物体。取值仅为vehicle

RegionIntersectFeatures Array of RegionIntersectFeatures

与各个指定区域相交集的车辆检测框对应的车辆特征。

Features Array of String AEAMQQAAAA****ABhC

此Base64编码用于匹配两帧之间的车辆是否为同一车辆。

RegionIntersectMatched Array of RegionIntersectMatched

判断当前帧的RegionIntersectFeatures与PreRegionIntersectFeatures中哪一个特征是匹配的。

Ids Array of Long [-1,-1,-1]

当两帧之间的两个车辆是匹配时,说明该车辆在两帧之间的时间内存在滞留或拥堵现象。

说明 -1代表没有匹配的特征,如果匹配将显示对应检测框ID。例如,车辆检测框ID为[1,2,3],RegionIntersectMatched显示为[-1,-1,-1],则表示三个区域均没有匹配,RegionIntersectMatched显示为[-1,2,3],则表示区域1未匹配,区域2和3匹配。
RegionIntersects Array of RegionIntersects

与各个指定区域相交集的车辆检测框对应的车辆特征。

Ids Array of Long [1,2,3]

检测框ID。

示例

请求示例

http(s)://[Endpoint]/?ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/zhangchaorun/test-yace/capture_images_000069.jpg
&RoadRegions=[{"RoadRegion":[{"Point":{"X":400,"Y":400}}]}]
&PreRegionIntersectFeatures=[{"Features":["AEAMQQAAAA****ABhC"]}]
&公共请求参数

正常返回示例

XML格式

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

<RequestId>2F7DC10D-D4A8-47A9-A7B1-77FCA242A1F2</RequestId>
<Data>
    <RegionIntersectFeatures>
        <Features>AEAMQQAAAA****ABhC</Features>
        <Features>AEAMQQAAAA****AKRC</Features>
        <Features>AEAMQQAAAA****AFRD</Features>
    </RegionIntersectFeatures>
    <RegionIntersects>
        <Ids>1</Ids>
        <Ids>2</Ids>
        <Ids>3</Ids>
    </RegionIntersects>
    <RegionIntersectMatched>
        <Ids>-1</Ids>
        <Ids>-1</Ids>
        <Ids>-1</Ids>
    </RegionIntersectMatched>
    <Elements>
        <TypeName>vehicle</TypeName>
        <Score>0.962890625</Score>
        <Boxes>
            <Left>341</Left>
            <Top>434</Top>
            <Right>589</Right>
            <Bottom>576</Bottom>
        </Boxes>
    </Elements>
    <Elements>
        <TypeName>vehicle</TypeName>
        <Score>0.9619140625</Score>
        <Boxes>
            <Left>304</Left>
            <Top>228</Top>
            <Right>525</Right>
            <Bottom>440</Bottom>
        </Boxes>
    </Elements>
    <Elements>
        <TypeName>vehicle</TypeName>
        <Score>0.83203125</Score>
        <Boxes>
            <Left>0</Left>
            <Top>24</Top>
            <Right>68</Right>
            <Bottom>106</Bottom>
        </Boxes>
    </Elements>
    <Elements>
        <TypeName>vehicle</TypeName>
        <Score>0.53125</Score>
        <Boxes>
            <Left>0</Left>
            <Top>0</Top>
            <Right>58</Right>
            <Bottom>38</Bottom>
        </Boxes>
    </Elements>
</Data>

JSON格式

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

{
  "RequestId" : "2F7DC10D-D4A8-47A9-A7B1-77FCA242A1F2",
  "Data" : {
    "RegionIntersectFeatures" : {
      "Features" : [ "AEAMQQAAAA****ABhC", "AEAMQQAAAA****AKRC", "AEAMQQAAAA****AFRD" ]
    },
    "RegionIntersects" : {
      "Ids" : [ 1, 2, 3 ]
    },
    "RegionIntersectMatched" : {
      "Ids" : [ -1, -1, -1 ]
    },
    "Elements" : [ {
      "TypeName" : "vehicle",
      "Score" : 0.962890625,
      "Boxes" : {
        "Left" : 341,
        "Top" : 434,
        "Right" : 589,
        "Bottom" : 576
      }
    }, {
      "TypeName" : "vehicle",
      "Score" : 0.9619140625,
      "Boxes" : {
        "Left" : 304,
        "Top" : 228,
        "Right" : 525,
        "Bottom" : 440
      }
    }, {
      "TypeName" : "vehicle",
      "Score" : 0.83203125,
      "Boxes" : {
        "Left" : 0,
        "Top" : 24,
        "Right" : 68,
        "Bottom" : 106
      }
    }, {
      "TypeName" : "vehicle",
      "Score" : 0.53125,
      "Boxes" : {
        "Left" : 0,
        "Top" : 0,
        "Right" : 58,
        "Bottom" : 38
      }
    } ]
  }
}

错误码

关于车辆拥堵检测的错误码,详情请参见常见错误码

SDK参考

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

安全声明

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