本文档介绍机动车检测DetectVehicle的语法及示例。

功能描述

DetectVehicle可以检测图像中的机动车主体,返回该机动车主体的区域位置,坐标信息。

前提条件

请确保您已开通目标检测服务,详情请参见服务开通

输入限制

  • 请求格式:JPEG、JPG、PNG、BMP。
  • 图像大小:图像大小不超过3M。
  • 图像分辨率:不限制图片分辨率,但图片分辨率太高可能会导致API识别超时,超时时间为5秒。
  • 图片URL地址中不能包含中文字符。

调试

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

请求参数

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

要执行的操作。取值:DetectVehicle。

ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/7%E6%B1%BD%E8%BD%A6%E5%9B%BE%E7%89%87cljc.jpg

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

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。

DetectObjectInfoList Array

机动车检测框的集合。

Boxes List 0

检测框坐标,格式为[left, top, right, bottom]。例如[877, 95, 1021,177 ]

Id Integer 1

检测框的ID。

Score Float 0.897

检测框的分数,范围为0~1。

Type String vehicle

检测框对应的物体,值为vehicle代表机动车。

Height Integer 436

图片的高度。

Width Integer 612

图片的宽度。

RequestId String 77BB1EB9-1707-4423-8391-CDAE6D29F9D5

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DetectVehicle
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/7%E6%B1%BD%E8%BD%A6%E5%9B%BE%E7%89%87cljc.jpg
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>77BB1EB9-1707-4423-8391-CDAE6D29F9D5</RequestId>
<Data>
    <DetectObjectInfoList>
        <Score>0.897</Score>
        <Type>vehicle</Type>
        <Id>1</Id>
        <Boxes>26</Boxes>
        <Boxes>17</Boxes>
        <Boxes>604</Boxes>
        <Boxes>335</Boxes>
    </DetectObjectInfoList>
    <Height>436</Height>
    <Width>612</Width>
</Data>

JSON 格式

{
	"RequestId": "77BB1EB9-1707-4423-8391-CDAE6D29F9D5",
	"Data": {
		"DetectObjectInfoList": [
			{
				"Score": 0.897,
				"Type": "vehicle",
				"Id": 1,
				"Boxes": [
					26,
					17,
					604,
					335
				]
			}
		],
		"Height": 436,
		"Width": 612
	}
}

错误码

关于机动车检测的错误码,详情请参见常见错误码

SDK参考

单击SDK简介查看SDK信息。