有奖捉虫:云通信与企业服务文档专题,速来> HOT

功能描述

车辆车牌检测功能为同步请求方式,您可以通过本接口检测图片中的车辆,识别出车辆的品牌、颜色、位置、车牌位置等信息。该接口属于 GET 请求。
注意:
本接口属于 GET 请求,为同步请求方式,需携带签名,具体签名设置请参见 请求签名
成功调用接口会产生 车辆车牌检测费用COS 读请求费用
如果图片属于 COS 上的低频存储类型,成功调用接口会产生 COS 低频数据取回费用
不支持对 COS 上的归档存储类型和深度归档存储类型的图片进行处理,如果需要处理此类型图片,请先 恢复归档文件

授权说明

授权策略中 action 设置为 ci:CreateLicensePlateJob 。查看所有 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制
图片支持格式:PNG、JPG、JPEG。
图片大小:所下载图片经 Base64 编码后不超过4MB
图片像素:建议大于50 * 50像素,否则影响识别效果。
长宽比:建议长边与短边的比例小于5:1

请求

请求示例

GET /<ObjectKey>?ci-process=DetectCar HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明
Authorization: Auth String (详情请参见 请求签名 文档)。

请求参数

参数名称
描述
类型
是否必选
ObjectKey
对象文件名,例如:folder/document.jpg
String
ci-process
数据万象处理能力,车辆识别固定为 DetectCar
String

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求无请求体。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response>
<RequestId></RequestId>
<CarTags>
<Serial></Serial>
<Brand></Brand>
<Type></Type>
<Color><Color>
<Confidence></Confidence>
<Year></Year>
<CarLocation>
<X></X>
<Y></Y>
</CarLocation>
<PlateContent>
<Plate></Plate>
<Color>Color>
<Type></Type>
<PlateLocation>
<X></X>
<Y></Y>
</PlateLocation>
</PlateContent>
</CarTags>
</Response>
具体的数据内容如下:
节点名称(关键字)
父节点
描述
类型
Response
保存结果的容器
Container
Response 的内容:
节点名称(关键字)
父节点
描述
类型
RequestId
Response
唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId
String
CarTags
Response
车辆属性识别的结果数组,支持返回多个车辆信息
Container
CarTags 节点的内容:
节点名称(关键字)
父节点
描述
类型
Serial
CarTags
车系
String
Brand
CarTags
车辆品牌
String
Type
CarTags
车辆类型
String
Color
CarTags
车辆颜色
String
Confidence
CarTags
置信度,0 - 100
Int
Year
CarTags
年份,识别不出年份时返回0
Int
CarLocation
CarTags
车辆在图片中的坐标信息,可能返回多个坐标点的值
Container
PlateContent
CarTags
车牌信息,包含车牌号、车牌颜色、车牌位置。支持返回多个车牌
Container
CarLocation 节点的内容:
节点名称(关键字)
父节点
描述
类型
X
CarLocation
横坐标 x
Int
Y
CarLocation
纵坐标 y
Int
PlateContent 节点的内容:
节点名称(关键字)
父节点
描述
类型
Plate
PlateContent
车牌号信息
String
Color
PlateContent
车牌的颜色
String
Type
PlateContent
车牌的种类,例如普通蓝牌
String
PlateLocation
PlateContent
车牌的位置
Container
PlateLocation 节点的内容:
节点名称(关键字)
父节点
描述
类型
X
PlateLocation
定位出的车牌左上角、右上角、左下角、右下角的 X 坐标
Int
Y
PlateLocation
定位出的车牌左上角、右上角、左下角、右下角的 Y 坐标
Int

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。

实际案例

请求

GET /test.jpg?ci-process=DetectCar HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 414641
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****

<Response>
<RequestId>NjE1MzEyMDlfOTBmYTUwNjRfNzUz****</RequestId>
<CarTags>
<Serial>奔驰S级</Serial>
<Brand>奔驰</Brand>
<Type>轿车</Type>
<Color>黑</Color>
<Confidence>98</Confidence>
<Year>0</Year>
<CarLocation>
<X>8</X>
<Y>364</Y>
</CarLocation>
<CarLocation>
<X>8</X>
<Y>5</Y>
</CarLocation>
<CarLocation>
<X>637</X>
<Y>5</Y>
</CarLocation>
<CarLocation>
<X>637</X>
<Y>364</Y>
</CarLocation>
<PlateContent>
<Plate>陕ASxxxL</Plate>
<Color>蓝色</Color>
<Type>普通蓝牌</Type>
<PlateLocation>
<X>263</X>
<Y>309</Y>
</PlateLocation>
<PlateLocation>
<X>263</X>
<Y>239</Y>
</PlateLocation>
<PlateLocation>
<X>459</X>
<Y>239</Y>
</PlateLocation>
<PlateLocation>
<X>459</X>
<Y>309</Y>
</PlateLocation>
</PlateContent>
</CarTags>
<CarTags>
<Serial>五菱宏光</Serial>
<Brand>五菱</Brand>
<Type>面包车</Type>
<Color>白</Color>
<Confidence>0</Confidence>
<Year>0</Year>
<CarLocation>
<X>0</X>
<Y>228</Y>
</CarLocation>
<CarLocation>
<X>0</X>
<Y>81</Y>
</CarLocation>
<CarLocation>
<X>73</X>
<Y>81</Y>
</CarLocation>
<CarLocation>
<X>73</X>
<Y>228</Y>
</CarLocation>
</CarTags>
</Response>