本文為您介紹目標檢測(objectdet)類目下的車輛擁堵檢測DetectVehicleICongestion的語法及示例。
功能描述
車輛擁堵檢測能力根據圖片中的車輛,判斷是否發生擁堵。
應用場景
- 停車場擁堵檢測:通過停車場攝像頭間隔時間內捕捉的兩張圖像,檢測車輛以及相對位置,判斷是否發生擁堵。
- 道路擁堵檢測:通過道路監控間隔時間內捕捉的前后圖像,檢測車輛以及相對位置,判斷是否發生擁堵。
特色優勢
檢測數據量少:無需較大數據量的視頻,僅通過檢測兩張圖片,即可判斷是否發生擁堵。
接入指引
1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:請確保您已開通目標檢測服務,若未開通服務請立即開通。
3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為目標檢測(objectdet)類目的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 圖像格式:JPEG、JPG、PNG、BMP。
- 圖像大小:不超過500 KB。
- 圖像分辨率:大于20×20像素,小于800×800像素,長寬比小于等于2。
- URL地址中不能包含中文字符。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
Action | String | 是 | DetectVehicleICongestion | 要執行的操作。取值:DetectVehicleICongestion。 |
ImageURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/objectdet/DetectVehicleICongestion/DetectVehicleICongestion1.jpg | 圖像URL地址。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 |
RoadRegions | Array | 是 | 多個區域。格式為RoadRegion_1, RoadRegion_2, ..., RoadRegion_N。 |
|
RoadRegion | Array | 是 | 任意四邊形的四個頂點的坐標X和Y,格式為 |
|
Point | Object | 是 | 四邊形的頂點坐標。 |
|
X | Long | 是 | 400 | 坐標點的X值。 |
Y | Long | 是 | 400 | 坐標點的Y值。 |
PreRegionIntersectFeatures | Array | 否 | 前一幀畫面與各個指定區域相交集的車輛檢測框對應的車輛特征。 |
|
Features | Array of String | 否 | AEAMQQAAAA****ABhC | Base64編碼的字符串。文件的Base64編碼處理操作,請參見文件Base64處理。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
RequestId | String | 4FC381BB-04F2-50F4-B54B-593042BCF3C6 | 請求ID。 |
Data | Object | 返回的結果數據內容。 |
|
Elements | Array of Element | 車輛檢測框的集合。 |
|
Boxes | Array of Boxes | 檢測框坐標,格式為 |
|
Left | Long | 341 | 矩形區域的左上角橫軸坐標。 |
Top | Long | 434 | 矩形區域的左上角縱軸坐標。 |
Right | Long | 589 | 矩形區域的右下角橫軸坐標。 |
Bottom | Long | 576 | 矩形區域的右下角縱軸坐標。 |
Score | Float | 0.962890625 | 檢測框的置信度,范圍為 |
TypeName | String | vehicle | 檢測框對應的物體。取值僅為 |
Id | Long | 1 | 檢測框ID。 |
RegionIntersectFeatures | Array of RegionIntersectFeatures | 與各個指定區域相交集的車輛檢測框對應的車輛特征。 |
|
Features | Array of String | AEAMQQAAAA****ABhC | 此Base64編碼用于匹配兩幀之間的車輛是否為同一車輛。文件的Base64編碼處理操作,請參見文件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":[1,3}, {"Ids":2,4} ],其中{"Ids":1,3}是與區域1相交集的車輛檢測框的ID, {"Ids":2,4}是與區域2相交集的車輛檢測框的ID。當車輛出現在給定區域內,說明存在車輛占道的情況。 除了RegionIntersects里包含的ID的檢測框外,其它的檢測框為區域外的檢測框。 |
|
Ids | Array of Long | [1,2,3] | 與各個指定區域相交集的車輛檢測框的多個ID。 例如,{"Ids":1,3}是與相應區域相交集的車輛檢測框的IDs。 |
SDK參考
阿里云視覺AI目標檢測類目下的車輛擁堵檢測能力推薦使用SDK調用,支持多種編程語言,調用時請選擇AI類目為目標檢測(objectdet)的SDK包,文件參數通過SDK調用可支持本地文件及任意URL,具體可參見SDK總覽。
示例
請求示例
http(s)://objectdet.cn-shanghai.aliyuncs.com/?Action=DetectVehicleICongestion //更多關于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/objectdet/DetectVehicleICongestion/DetectVehicleICongestion1.jpg
&RoadRegions=[{"RoadRegion":[{"Point":{"X":400,"Y":400}}]}]
&PreRegionIntersectFeatures=[{"Features":["AEAMQQAAAA****ABhC"]}]
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DetectVehicleICongestionResponse>
<RequestId>4FC381BB-04F2-50F4-B54B-593042BCF3C6</RequestId>
<Data>
<RegionIntersectFeatures>
<Features>AOAQQQBA****FRD</Features>
<Features>AEAMQQAA****KRC</Features>
<Features>AEAMQQAA****BhC</Features>
</RegionIntersectFeatures>
<RegionIntersects>
<Ids>1</Ids>
<Ids>2</Ids>
<Ids>3</Ids>
</RegionIntersects>
<Elements>
<Score>0.962890625</Score>
<TypeName>vehicle</TypeName>
<Id>0</Id>
<Boxes>
<Left>341</Left>
<Top>434</Top>
<Right>589</Right>
<Bottom>576</Bottom>
</Boxes>
</Elements>
<Elements>
<Score>0.9619140625</Score>
<TypeName>vehicle</TypeName>
<Id>1</Id>
<Boxes>
<Left>304</Left>
<Top>228</Top>
<Right>525</Right>
<Bottom>440</Bottom>
</Boxes>
</Elements>
<Elements>
<Score>0.83203125</Score>
<TypeName>vehicle</TypeName>
<Id>2</Id>
<Boxes>
<Left>0</Left>
<Top>24</Top>
<Right>68</Right>
<Bottom>106</Bottom>
</Boxes>
</Elements>
<Elements>
<Score>0.53125</Score>
<TypeName>vehicle</TypeName>
<Id>3</Id>
<Boxes>
<Left>0</Left>
<Top>0</Top>
<Right>58</Right>
<Bottom>38</Bottom>
</Boxes>
</Elements>
<RegionIntersectMatched>
<Ids>-1</Ids>
<Ids>-1</Ids>
<Ids>-1</Ids>
</RegionIntersectMatched>
</Data>
</DetectVehicleICongestionResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "4FC381BB-04F2-50F4-B54B-593042BCF3C6",
"Data" : {
"RegionIntersectFeatures" : {
"Features" : [ "AOAQQQBA****FRD", "AEAMQQAA****KRC", "AEAMQQAA****BhC" ]
},
"RegionIntersects" : {
"Ids" : [ 1, 2, 3 ]
},
"Elements" : [ {
"Score" : 0.962890625,
"TypeName" : "vehicle",
"Id" : 0,
"Boxes" : {
"Left" : 341,
"Top" : 434,
"Right" : 589,
"Bottom" : 576
}
}, {
"Score" : 0.9619140625,
"TypeName" : "vehicle",
"Id" : 1,
"Boxes" : {
"Left" : 304,
"Top" : 228,
"Right" : 525,
"Bottom" : 440
}
}, {
"Score" : 0.83203125,
"TypeName" : "vehicle",
"Id" : 2,
"Boxes" : {
"Left" : 0,
"Top" : 24,
"Right" : 68,
"Bottom" : 106
}
}, {
"Score" : 0.53125,
"TypeName" : "vehicle",
"Id" : 3,
"Boxes" : {
"Left" : 0,
"Top" : 0,
"Right" : 58,
"Bottom" : 38
}
} ],
"RegionIntersectMatched" : {
"Ids" : [ -1, -1, -1 ]
}
}
}
錯誤碼
關于車輛擁堵檢測的錯誤碼,詳情請參見常見錯誤碼。
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規。
- 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統自動清理刪除。