控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT

功能描述

车辆车牌检测功能为同步请求方式,您可以通过本接口检测图片中的车辆,识别出车辆的品牌、颜色、位置、车牌位置等信息。该接口属于 GET 请求。

费用说明

限制说明

  • 图片支持格式: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-image
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>

目录