对象存储车辆车牌识别-API 文档-文档中心-腾讯云

功能描述
车辆车牌检测功能为同步请求方式，您可以通过本接口检测图片中的车辆，识别出车辆的品牌、颜色、位置、车牌位置等信息。该接口属于 GET 请求。
注意：
本接口属于 GET 请求，为同步请求方式，需携带签名，具体签名设置请参见 请求签名。
成功调用接口会产生 车辆车牌检测费用 和 COS 读请求费用。
如果图片属于 COS 上的低频存储类型，成功调用接口会产生 COS 低频数据取回费用。
不支持对 COS 上的归档存储类型和深度归档存储类型的图片进行处理，如果需要处理此类型图片，请先 恢复归档文件。
授权说明
授权策略中 action 设置为 ci:CreateLicensePlateJob 。查看所有 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
图片支持格式：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>
参数名称	描述	类型	是否必选
ObjectKey	对象文件名，例如：folder/document.jpg	String	是
ci-process	数据万象处理能力，车辆识别固定为 DetectCar	String	是
节点名称（关键字）	父节点	描述	类型
Response	无	保存结果的容器	Container
车辆车牌识别

本页目录：

功能描述

授权说明

服务开通

使用限制

请求

请求示例

请求参数

请求头

请求体

响应

响应头

响应体

错误码

实际案例

请求

响应
