文档简介：
接口描述
传入单帧图像，检测图片中所有车辆，返回每辆车的类型和坐标位置，可识别小汽车、卡车、巴士、三轮车、两轮车、车牌，并针对车辆识别24种外观属性，包括：是否有车窗雨眉、是否有车顶架、副驾驶是否有人、车身颜色、特种车类型、渣土车满载等。
当前主要适用于普通监控场景，如道路、停车场等，无人机高空拍摄的图片，因车辆目标较小，识别效果可能欠佳，后续会扩展支持超高空拍摄场景，如有该场景的需求，请通过QQ群或提交工单，详细沟通测试情况。
普通监控场景示例图片：
在线调试
您可以在 示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法：POST
请求URL：https://aip.baidubce.com/rest/2.0/image-classify/v2/vehicle_attr
URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token，参考“Access Token获取” |
Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数，参数详情如下：
请求参数
| 参数 | 是否必选 | 类型 | 取值范围 | 说明 |
|---|---|---|---|---|
| image | 和url二选一 | string | 0-255彩色图像（base64编码） | 图像数据，Base64编码字符串，不超过4M。最短边至少50px，最长边最多4096px。支持图片格式：jpg/bmp/png。 注意：图片的base64编码是不包含图片头的，如（data:image/jpg;base64,） |
| url | 和image二选一 | string | - | 图片完整URL，URL长度不超过1024字节，URL对应的图片base64编码后大小不超过4M，最短边至少50px，最长边最大4096px，支持jpg/png/bmp格式，当image字段存在时url字段失效。 |
| type | 否 | string | 是否选定某些属性输出对应的信息，可从24种输出属性中任选若干，用英文逗号分隔（例如top_holder,skylight,window_rain_eyebrow）。默认输出全部属性 |
附：type字段说明
| ID | type | 说明 | 类别数 | 类别 |
|---|---|---|---|---|
| 0 | top_holder | 是否有车顶架 | 2 | 是否有车顶架 |
| 1 | skylight | 是否有天窗 | 2 | 无天窗、有天窗 |
| 2 | window_rain_eyebrow | 是否有车窗雨眉 | 2 | 无车窗雨眉、有车窗雨眉 |
| 3 | vehicle_front_item_placeitems | 是否有车前摆放物 | 2 | 无车前摆放物、有车前摆放物 |
| 4 | vehicle_front_item_pendant | 是否有后视镜挂件 | 2 | 无后视镜挂件、有后视镜挂件 |
| 5 | has_copilot | 副驾驶位是否有人 | 2 | 副驾驶无人、副驾驶有人 |
| 6 | safety_belt_copilot | 副驾驶安全带是否系带 | 2 | 副驾驶未系安全带、副驾驶系安全带 |
| 7 | safety_belt_pilot | 驾驶员安全带是否系带 | 2 | 驾驶员安全带是否系带 |
| 8 | sunvisor_pilot | 驾驶员遮阳板是否放下 | 2 | 驾驶员遮阳板未放下、驾驶员遮阳板放下 |
| 9 | sunvisor_copilot | 副驾驶遮阳板是否放下 | 2 | 副驾驶遮阳板未放下、副驾驶遮阳板放下 |
| 10 | direction | 车辆行驶方向 | 4 | 车辆正向行驶、车辆背向行驶、车辆左侧行驶、车辆右侧行驶 |
| 11 | has_plate | 是否无牌车 | 2 | 有车牌、无车牌 |
| 12 | plate_stained | 是否污损车牌 | 2 | 车牌无污损、车牌污损 |
| 13 | dangerous_vehicle | 是否为危化品车 | 2 | 非危险品车、危险品车 |
| 14 | slag_vehicle | 是否为渣土车 | 2 | 非渣土车、渣土车 |
| 15 | slag_vehicle_cover | 渣土车是否盖板 | 2 | 渣土车未盖板、渣土车苫盖 |
| 16 | vehicle_inspection | 是否有年检标 | 2 | 无年检标、有年检标 |
| 17 | vehicle_color | 车身颜色 | 12 |
车身颜色白色; 车身颜色灰色; 车身颜色黄色; 车身颜色粉色; 车身颜色红色; 车身颜色紫色; 车身颜色绿色; 车身颜色蓝色; 车身颜色棕色; 车身颜色黑色; 车身颜色橙色; 车身颜色混色 |
| 18 | special_vehicle | 特种车类型 | 9 | 普通车、警车、消防车、救护车、施工工程车、工程抢险车、洒水车、搅拌车、校车 |
| 19 | vehicle_shielding | 遮挡 | 3 | 无遮挡、0-50%遮挡、50-100%遮挡 |
| 20 | slag_full_loaded | 渣土车满载 | 2 | 渣土车未满载、渣土车满载 |
| 21 | slag_refit | 渣土车改装 | 2 | 渣土车未改装、渣土车改装 |
| 22 | plate_cover | 车牌遮挡 | 2 | 车牌未遮挡、车牌遮挡 |
| 23 | vehicle_class | 车辆类型识别 | 3 | 两轮车(主要是摩托)、三轮车、四轮车 |
请求代码示例
提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。
提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。
curl -i -k 'https://aip.baidubce.com/rest/2.0/image-classify/v2/vehicle_attr?access_token=
【调用鉴权接口获取的token】' --data 'image=【图片Base64编码，需UrlEncode】' -H 'Content-Type:application/x-www-form-urlencoded'
返回说明
返回参数 以type选定top_holder为例：
| 字段 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| vehicle_info | 是 | object数组 | 每个框的具体信息 |
| vehicle_num | 是 | int | 检测到的车辆框数目 |
| +location | 是 | object | 检测到的车辆框位置 |
| ++left | 是 | int | 检测框左坐标 |
| ++top | 是 | int | 检测框顶坐标 |
| ++width | 是 | int | 检测框宽度 |
| ++height | 是 | int | 检测框高度 |
| ++cls | 是 | int |
检测主体类型，返回int类型的id，id对应内容如下： 1:小汽车(car)； 2:卡车(truck)； 3:巴士(bus)； 4:二轮车-主要为摩托车，含自行车(motorbike)； 5:三轮车(tricycle)； 6:车牌(carplate)； -1:图片中未检测到车辆(无检测结果) |
| ++score | 是 | float | 车辆置信度 |
| +attributes | 是 | object数组 | 车辆属性内容（这里仅列举其中一个进行说明，全部24个属性见属性字段说明） |
| ++top_holder | 否 | object | 车顶架 |
| ++++name | 否 | string | 无车顶架、有车顶架 |
| ++++score | 否 | float | 对应概率分数 |
返回示例
未检测到任何车辆：
{
"log_id": 1522102386508316465,
"vehicle_info": [
{
"attributes": {},
"location": {
"score": 0,
"top": 0,
"left": 0,
"width": 0,
"cls": -1,
"height": 0
}
}
],
"vehicle_num": 0
}
检测到2辆小汽车：
{
"log_id": 1522103149454741267,
"vehicle_info": [
{
"attributes": {
"vehicle_color": {
"score": 0.9207834601402283,
"name": "车身颜色白色"
},
"slag_full_loaded": {
"score": 0.9757698774337769,
"name": "渣土车未满载"
},
"safety_belt_copilot": {
"score": 0.9999989867210388,
"name": "副驾驶系安全带"
},
"vehicle_front_item_placeitems": {
"score": 0.7926750183105469,
"name": "有车前摆放物"
},
"vehicle_inspection": {
"score": 0.5232551693916321,
"name": "有年检标"
},
"skylight": {
"score": 0.7827605605125427,
"name": "无天窗"
},
"dangerous_vehicle": {
"score": 0.9992908239364624,
"name": "非危险品车"
},
"vehicle_shielding": {
"score": 0.9654262661933899,
"name": "无遮挡"
},
"sunvisor_copilot": {
"score": 0.9938165545463562,
"name": "副驾驶遮阳板未放下"
},
"safety_belt_pilot": {
"score": 0.5320025682449341,
"name": "驾驶员未系安全带"
},
"window_rain_eyebrow": {
"score": 0.9973089694976807,
"name": "无车窗雨眉"
},
"sunvisor_pilot": {
"score": 0.9889488220214844,
"name": "驾驶员遮阳板未放下"
},
"plate_stained": {
"score": 0.9904413223266602,
"name": "车牌无污损"
},
"slag_vehicle": {
"score": 0.9885181784629822,
"name": "非渣土车"
},
"vehicle_front_item_pendant": {
"score": 0.9655022621154785,
"name": "无后视镜挂件"
},
"has_plate": {
"score": 0.7274292707443237,
"name": "有车牌"
},
"vehicle_class": {
"score": 0.8929595947265625,
"name": "四轮车"
},
"special_vehicle": {
"score": 0.8439596891403198,
"name": "普通车"
},
"plate_cover": {
"score": 0.9869874715805054,
"name": "车牌未遮挡"
},
"top_holder": {
"score": 0.9910229444503784,
"name": "无车顶架"
},
"slag_vehicle_cover": {
"score": 0.5242087244987488,
"name": "渣土车未盖板"
},
"slag_refit": {
"score": 0.9636361598968506,
"name": "渣土车未改装"
},
"has_copilot": {
"score": 0.9043570756912231,
"name": "副驾驶无人"
},
"direction": {
"score": 0.8187354803085327,
"name": "车辆正向行驶"
}
},
"location": {
"score": 0.9702600240707397,
"top": 170,
"left": 419,
"width": 80,
"cls": 1,
"height": 86
}
},
{
"attributes": {
"vehicle_color": {
"score": 0.9032244086265564,
"name": "车身颜色黄色"
},
"slag_full_loaded": {
"score": 0.9681426882743835,
"name": "渣土车未满载"
},
"safety_belt_copilot": {
"score": 0.9999989867210388,
"name": "副驾驶系安全带"
},
"vehicle_front_item_placeitems": {
"score": 0.7316561937332153,
"name": "有车前摆放物"
},
"vehicle_inspection": {
"score": 0.6960608959197998,
"name": "有年检标"
},
"skylight": {
"score": 0.9296075105667114,
"name": "无天窗"
},
"dangerous_vehicle": {
"score": 0.9980440139770508,
"name": "非危险品车"
},
"vehicle_shielding": {
"score": 0.9729943871498108,
"name": "无遮挡"
},
"sunvisor_copilot": {
"score": 0.9857694506645203,
"name": "副驾驶遮阳板未放下"
},
"safety_belt_pilot": {
"score": 0.6393722891807556,
"name": "驾驶员未系安全带"
},
"window_rain_eyebrow": {
"score": 0.9806464910507202,
"name": "无车窗雨眉"
},
"sunvisor_pilot": {
"score": 0.7367949485778809,
"name": "驾驶员遮阳板未放下"
},
"plate_stained": {
"score": 0.9940692186355591,
"name": "车牌无污损"
},
"slag_vehicle": {
"score": 0.986552894115448,
"name": "非渣土车"
},
"vehicle_front_item_pendant": {
"score": 0.9854007363319397,
"name": "无后视镜挂件"
},
"has_plate": {
"score": 0.9633370637893677,
"name": "有车牌"
},
"vehicle_class": {
"score": 0.9078437685966492,
"name": "四轮车"
},
"special_vehicle": {
"score": 0.8234432339668274,
"name": "校车"
},
"plate_cover": {
"score": 0.9921958446502686,
"name": "车牌未遮挡"
},
"top_holder": {
"score": 0.98869788646698,
"name": "无车顶架"
},
"slag_vehicle_cover": {
"score": 0.7752302885055542,
"name": "渣土车未盖板"
},
"slag_refit": {
"score": 0.9444331526756287,
"name": "渣土车未改装"
},
"has_copilot": {
"score": 0.9544827342033386,
"name": "副驾驶无人"
},
"direction": {
"score": 0.8230369091033936,
"name": "车辆正向行驶"
}
},
"location": {
"score": 0.9173700213432312,
"top": 136,
"left": 281,
"width": 125,
"cls": 1,
"height": 102
}
}
],
"vehicle_num": 2
}
