流媒体查询API

更新时间：2019-12-11

查询设备指定时间段内的文件信息

接口描述：本接口可根据时间段、存储位置、报警类型、视频通道、码流查询指定设备的音频视频信息

注意事项

本接口是用于指定设备进行查询。

未购买车联网服务将无法进行查询操作
未激活的设备无法查询音频视频信息

请求结构

POST /v1/video/query/media/{vehicleId}
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-25T404:02:05Z
{
  "startTime": startTime,
  "endTime" : endTime,
  "statusList" : statusList,
  "alarmTypeList": alarmTypeList,
  "channelList": channelList,
  "streamType": streamType
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
vehicleId	String	是	URL参数	设备ID
startTime	long	是	RequestBody参数	时间戳，开始时间，ms为单位
endTime	long	是	RequestBody参数	时间戳，结束时间，ms为单位。开始时间-结束时间，精确为分钟级。如01:00:02 182-01:06:03 198，则查找01:00:00-01:06:59时间段内的视频文件。
statusList	List<Integer>	否	RequestBody参数	存储位置列表，0：终端，1：云端。不指定或者空列表表示不作为筛选条件
alarmTypeList	List<String>	否	RequestBody参数	报警类型
channelList	List<Integer>	否	RequestBody参数	通道号列表，空list或者不填表示不作为筛选条件
streamType	String	否	RequestBody参数	码流类型，ALL,MAIN_STREAM,SUB_STREAM。默认值为ALL

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
vehicleId	String	车辆ID
vehicleName	String	车辆别名
groupName	String	设备分组
videoInfoList	List<MediaInfo>	视频信息列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误（该车辆ID不存在or该车辆未激活or无此类型or结束时间必须大于开始时间）	400	请求参数有误（该车辆ID不存在or该车辆未激活or无此类型or结束时间必须大于开始时间）
InvalidAlarmType	非法报警类型（无此类型）	400	非法报警类型（无此类型）
IvcNotEnable	未购买车联网服务	400	未购买车联网服务
ServerInternalError	内部服务器错误，请稍后重试	500	内部服务器错误，请稍后重试

请求示例

POST /v1/video/query/media/QGON_10000
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-11-25T404:02:05Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json
x-bce-date: 2019-11-25T404:02:05Z
{
  "startTime":1575547309000, 
  "endTime":1575547369000,  
  "statusList": [0],                 
  "alarmTypeList":["SMOKING"],        
  "channelList":[1,2,3],             
  "streamType":"MAIN_STREAM"         
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Mon, 25 Nov 2019 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
       "vehicleId":"QGON_10000",
       "vehicleName":"沪A10000",
       "groupName":"默认分组",
       "videoInfoList": [
        {
           "mediaUuid":"2e415445f2e74cc3ab00043def558a84", 
           "channelNum":0,
           "startTime": 1575547309000,
           "endTime": 1575547369000,
           "fileName":"test.mp4",
           "fileSize":8,
           "alarmTypes":["SMOKING"],      
           "status":"TERMINAL",        
           "mediaType":"VIDEO",       
           "streamType":"MAIN_STREAM", 
           "duration":60000             
        }
    ]
 }

按照文件名称检索多媒体

接口描述：本接口用于查询设备的指定文件的视频信息

注意事项

本接口是用于按照文件名称检索多媒体信息

未购买车联网服务将无法进行查询操作
未激活的设备无法查询音频视频信息
指定查询流媒体信息的设备ID不存在，查询失败

请求结构

GET /v1/video/query/media/{vehicleId}/filename?fileName={fileName}
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-25T404:02:05Z

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
vehicleId	String	是	URL参数	设备ID
fileName	String	是	Query参数	文件名

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
mediaUuid	String	视频Uuid
vehicleId	String	车辆ID
vehicleName	String	车辆名称
channelNum	int	通道号
startTime	long	时间戳，开始时间，ms
endTime	long	时间戳，结束时间，ms
fileName	String	视频文件名称
fileSize	int	视频文件大小，单位字节
alarmTypes	List<String>	报警类型
status	String	存储位置，0：终端，1：云端
mediaType	String	媒体类型，BOTH：音视频，VIDEO：视频，AUDIO：音频
streamType	String	码流，ALL,MAIN_STREAM,SUB_STREAM。默认值为ALL
groupName	String	设备组名称
duration	long	时长，ms

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误（该车辆ID不存在or该车辆未激活）	400	请求参数有误（该车辆ID不存在or该车辆未激活）
IvcNotEnable	未购买车联网服务	400	未购买车联网服务
ServerInternalError	内部服务器错误，请稍后重试	500	内部服务器错误，请稍后重试

请求示例

GET /v1/video/query/media/QGON_10000/filename?fileName=test.mp4
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-11-25T404:02:05Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json
x-bce-date: 2019-11-25T404:02:05Z

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Mon, 25 Nov 2019 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
        "mediaUuid":"ec0c60a6ab7540939ab40e12a994a8c3",
        "vehicleId":"QGON_10000",
        "vehicleName":"沪A10000",
        "channelNum":2,
        "startTime": 1575547309000,
        "endTime": 1575547369000,
        "fileName":"test.mp4",
        "fileSize":8,
        "alarmTypes":["SMOKING"],
        "status":"TERMINAL",
        "mediaType":"VIDEO",
        "streamType":"MAIN_STREAM",
        "groupName":"默认分组",
        "duration":60000
 }

按报警uuid检索多媒体

接口描述：本接口用于根据报警的Uuid查询具体的多媒体信息

注意事项

本接口是用于按报警Uuid查询多媒体信息。

未购买车联网服务将无法进行查询操作
未激活的车辆无法查询音频视频信息
查询的车辆ID不存在则查询失败

请求结构

GET /v1/video/query/media/alarm-uuid?alarmUuid={alarmUuid}
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-26T409:02:05Z

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
alarmUuid	String	是	Query参数	报警Uuid

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
vehicleId	String	设备ID
vehicleName	String	车辆名称
groupName	String	设备组名称
videoInfoList	List<MediaInfo>	视频信息列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误（该车辆ID不存在or该车辆未激活）	400	请求参数有误（该车辆ID不存在or该车辆未激活）
NotExistResource	资源不存在	404	资源不存在
IvcNotEnable	未购买车联网服务	400	未购买车联网服务
ServerInternalError	内部服务器错误，请稍后重试	500	内部服务器错误，请稍后重试

请求示例

GET /v1/video/query/media/alarm-uuid?alarmUuid=3
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-11-26T404:02:05Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json
x-bce-date: 2019-11-26T404:02:05Z

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 26 Nov 2019 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS   
{
    "vehicleId":"QGON_10000"，
    "vehicleName":"沪A10000"，
    "groupName":"默认分组"，
    "videoInfoList": [
        {
             "mediaUuid":"2e415445f2e74cc3ab00043def558a84", 
             "channelNum":1,
             "statTime": 1575547309000,
             "endTime": 1575547369000,
             "fileName":"test.mp4",
             "fileSize":8,
             "alarmTypes":["SMOKING"],      
             "status":"TERMINAL",       
             "mediaType":"VIDEO",        
             "streamType":"MAIN_STREAM", 
             "duration":60000             
         }
     ]
}

按报警标识号检索多媒体信息

接口描述：本接口用于根据报警标识号、车辆ID查询多媒体信息

注意事项

本接口是用于按报警标识检索报警对应的多媒体信息

未购买车联网服务用，用户将无法进行查询操作

请求结构

GET /v1/video/query/media/{vehicleId}/alarm-ref-key?alarmRefKey={alarmRefKey}
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-26T409:02:05Z

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
vehiceld	String	是	URL参数	车辆ID
alarmRefKey	String	是	Query参数	报警标识

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
vehicleId	String	车辆ID
vehicleName	String	车辆名称
groupName	String	设备组名称
videoInfoList	List<MediaInfo>	视频信息列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误（该车辆ID不存在or该车辆未激活）	400	请求参数有误（该车辆ID不存在or该车辆未激活）
IvcNotEnable	未购买车联网服务	400	未购买车联网服务
ServerInternalError	内部服务器错误，请稍后重试	500	内部服务器错误，请稍后重试

请求示例

GET /v1/video/query/media/QGON_10000/alarm-ref-key?alarmRefKey=1565681283_16
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-11-26T404:02:05Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json
x-bce-date: 2019-11-26T404:02:05Z

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 26 Nov 2019 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS  
{
    "vehicleId":"QGON_10000"，
    "vehicleName":"沪A10000"，
    "groupName":"默认分组"，
    "videoInfoList": [
        {
             "mediaUuid":"2e415445f2e74cc3ab00043def558a84", 
             "channelNum":1,
             "statTime": 1575547309000,
             "endTime": 1575547369000,
             "fileName":"test.mp4",
             "fileSize":8,
             "alarmTypes":["SMOKING"],       
             "status":"TERMINAL",        
             "mediaType":"VIDEO",        
             "streamType":"MAIN_STREAM", 
             "duration":60000             
         }
     ]
}

根据设备ID和时间段检索报警信息

接口描述：本接口用于查看指定设备指定时间段对应的报警记录

注意事项

本接口用于指定特定的设备集并指定时间段检索报警信息

指定设备可以是一个或多个
未购买车联网服务将无法查询车辆的报警信息

请求结构

POST /v1/video/query/alarm?id
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-26T409:02:05Z
{
  "vehicleIdList": vehicleIdList,
  "startTime": "startTime,
  "endTime": endTime,
  "alarmTypeList": alarmTypeList
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
vehiceldList	List<String>	是	RequestBody参数	车辆ID列表
startTime	long	是	RequestBody参数	时间戳，开始时间，ms
endTime	long	是	RequestBody参数	时间戳，结束时间，ms
alarmTypeList	List<String>	否	RequestBody参数	报警类型列表。空或不填表示不作为筛选条件

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
alarmInfoList	List<AlarmInfo>	报警信息列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误	400	请求参数有误
InvalidAlarmType	非法报警类型（无此类型）	400	非法报警类型（无此类型）
IvcNotEnable	未购买车联网服务	400	未购买车联网服务
ServerInternalError	内部服务器错误，请稍后重试	500	内部服务器错误，请稍后重试

请求示例

POST /v1/video/query/alarm?id
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-11-26T404:02:05Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json
x-bce-date: 2019-11-26T404:02:05Z
{
    "vehicleIdList":["QGON_10000"],   
    "startTime":1575547309000,                     
    "endTime":1575547369000,           
    "alarmTypeList":["SMOKING"]                
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 26 Nov 2019 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS   
{
    "alarmInfoList": [
    {
        "alarmTime":1575547309000,
        "alarmEndTime":1575547369000,
        "alarmType":"SMOKING",
        "vehicleId":"QGON_10000",
        "vehicleName":"沪A10000",
        "groupName":"默认分组",
        "longitude":120.0,
        "latitude":53.0,
        "alarmRefKey":"1565681283_16"
    }
   ]
}

根据时间段检索报警信息

接口描述：本接口用于根据时间段检索报警记录

注意事项

本接口是用于根据时间段检索报警信息。

未购买车联网服务将无法进行查询操作
输入的时间段，结束时间必须大于开始时间，且开始时间和结束时间必须小于当前时间

请求结构

POST /v1/video/query/alarm?time
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-26T409:02:05Z
{
  "startTime": startTime，
  "endTime": endTime，
  "alarmTypeList": alarmTypeList
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
startTime	long	是	RequestBody参数	时间戳，开始时间，ms
endTime	long	是	RequestBody参数	时间戳，结束时间，ms
alarmTypeList	List<String>	否	RequestBody参数	报警类型列表

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
alarmInfoList	List<AlarmInfo>	报警信息列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误（结束时间必须大于开始时间）	400	请求参数有误（结束时间必须大于开始时间）
InvalidAlarmType	非法报警类型（无此类型）	400	非法报警类型（无此类型）
IvcNotEnable	未购买车联网服务	400	未购买车联网服务
ServerInternalError	内部服务器错误，请稍后重试	500	内部服务器错误，请稍后重试

请求示例

POST /v1/video/query/alarm?time
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-11-26T404:02:05Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json
x-bce-date: 2019-11-26T404:02:05Z
{
    "startTime":1575547309000,                     
    "endTime":1575547369000,           
    "alarmTypeList":["SMOKING"]                 
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 26 Nov 2019 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS    
{
    "alarmInfoList": [
     {
        "alarmTime":1575547309000,
        "alarmEndTime":1575547369000,
        "alarmType":"SMOKING",
        "vehicleId":"QGON_10000",
        "vehicleName":"沪A10000",
        "groupName":"默认分组",
        "longitude":120.0,
        "latitude":53.0,
        "alarmRefKey":"1565681283_16"
    }
   ]
}

查询车辆指定时间段的报警和视频信息

接口描述

本接口用于根据车辆ID和时间段获取相应的报警+相关视频组合信息

单设备根据报警 + 视频|图片联合查找报警信息

注意事项

本接口用于根据设备和时间段查询报警+视频|图片

检索的报警信息是关于单个设备
查询的时间段，结束时间必须大于开始时间，且时间段不得超过最大限制

请求结构

POST /v1/video/query/alarm/video?id
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-26T409:02:05Z
{
  "vehicleId": vehicleId,
  "startTime": startTime,
  "endTime": endTime,
  "alarmTypeList": alarmTypeList
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
vehicleId	String	是	RequestBody参数	车辆ID
startTime	long	是	RequestBody参数	时间戳，开始时间，ms
endTime	long	是	RequestBody参数	时间戳，结束时间，ms
alarmTypeList	List<String>	否	RequestBody参数	报警类型列表

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
alarmVideoInfoList	List<AlarmVideoInfo>	报警信息列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误（该车辆ID不存在org该车辆未激活or结束时间必须大于开始时间or查询时间段超出限制）	400	请求参数有误（该车辆ID不存在or该车辆未激活or结束时间必须大于开始时间or查询时间段超出限制）
InvalidAlarmType	非法报警类型（无此类型）	400	非法报警类型（无此类型）
IvcNotEnable	未购买车联网服务	400	未购买车联网服务
ServerInternalError	内部服务器错误，请稍后重试	500	内部服务器错误，请稍后重试

请求示例

POST /v1/video/query/alarm/video?id
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-11-26T404:02:05Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json
x-bce-date: 2019-11-26T404:02:05Z
{
   "vehicleId":"QGON_10000", 
   "startTime":1575547309000,           
   "endTime":1575547369000,                
   "alarmTypeList":["SMOKING"]  
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 26 Nov 2019 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS   
{
   "alarmVideoInfoList": [
    {
        "longitude":120.0,
        "latitude":52.3,
        "alarmType":"SMOKING",
        "alarmUuid":"e4bef110270b4a5b98ada3945502b946",
        "alarmTime": 1575547309000,
        "alarmEndTime":1575547369000,
        "vehicleId":"QGON_10000",
        "vehicleId":"沪A10000",
        "groupName":"默认分组",
        "mediaInfoList": [
            {
                "mediaUuid":"2e415445f2e74cc3ab00043def558a84",
                "channelNum":0,
                "startTime": 1575547309000,
                "endTime": 1575547369000,
                "fileName":"test.mp4",
                "fileSize":8,
                "status":"TERMINAL",
                "mediaType":"VIDEO",
                "streamType":"MAIN_STREAM",
                "duration":60000
            }
        ]
    }
   ]
}

查询用户指定时间段的报警和视频信息

接口描述：本接口用于获取用户下指定时间段的所有报警+多媒体组合信息

注意事项

本接口是用于获取用户下指定时间段的所有报警+多媒体组合信息

查询的时间段，结束时间必须大于开始时间，且时间段不得超过最大限制

请求结构

POST /v1/video/query/alarm/video?userId
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-26T409:02:05Z
{
  "startTime": startTime,
  "endTime": endTime,
  "alarmTypeList": alarmTypeList
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
startTime	long	是	RequestBody参数	时间戳，开始时间，ms
endTime	long	是	RequestBody参数	时间戳，结束时间，ms
alarmTypeList	List<String>	否	RequestBody参数	报警类型列表

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
alarmVideoInfoList	List<AlarmVideoInfo>	报警和视频信息列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误（结束时间必须大于开始时间）	400	请求参数有误（结束时间大于开始时间）
InvalidAlarmType	非法报警类型（无此类型）	400	非法报警类型（无此类型）

请求示例

POST /v1/video/query/alarm
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-11-26T404:02:05Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json
x-bce-date: 2019-11-26T404:02:05Z
{
   "startTime":1575547309000,             
   "endTime":1575547369000,                
   "alarmTypeList":["SMOKING"]  
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 26 Nov 2019 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS 
{
   "alarmVideoInfoList": [
    {
        "longitude":120.0,
        "latitude":52.3,
        "alarmType":"SMOKING",
        "alarmUuid":"e4bef110270b4a5b98ada3945502b946",
        "alarmTime": 1575547309000,
        "alarmEndTime": 1575547369000,
        "vehicleId":"QGON_10000",
        "vehicleName": "沪A10000",
        "groupName":"默认分组",
        "mediaInfoList": [
            {
                "mediaUuid":"2e415445f2e74cc3ab00043def558a84",
                "channelNum":0,
                "startTime": 1575547309000,
                "endTime": 1575547369000,
                "fileName":"test.mp4",
                "fileSize":8,
                "status":"TERMINAL",
                "mediaType":"VIDEO",
                "streamType":"MAIN_STREAM",
                "duration":60000
            }
        ]
    }
   ]
}

查询一批设备指定时间段的报警信息

接口描述：本接口用于获取一批设备在指定时间段的报警和多媒体信息

注意事项

本接口用于根据报警+视频|图片联合查找多个设备的报警信息

返回信息是多个设备的报警信息
查询的时间段，结束时间必须大于开始时间，且时间段不得超过最大限制
未购买车联网服务的用户将无法进行查询操作

请求结构

POST /v1/video/query/alarm/video?ids
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-26T409:02:05Z
{
  "vehicleIdList": vehicleIdList,
  "startTime": "startTime,
  "endTime": endTime,
  "alarmTypeList": alarmTypeList
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
vehicleIdList	List<String>	是	RequestBody参数	车辆ID列表
startTime	long	是	RequestBody参数	时间戳，开始时间，ms
endTime	long	是	RequestBody参数	时间戳，结束时间，ms
alarmTypeList	List<String>	否	RequestBody参数	报警类型列表

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
alarmVideoInfoList	List<AlarmVideoInfo>	报警和视频信息列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误（结束时间必须大于开始时间）	400	请求参数有误（结束时间必须大于开始时间）
InvalidAlarmType	非法报警类型（无此类型）	400	非法报警类型（无此类型）
IvcNotEnable	未购买车联网服务	400	未购买车联网服务
ServerInternalError	内部服务器错误，请稍后重试	500	内部服务器错误，请稍后重试

请求示例

POST /v1/video/query/alarm/video?ids
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-11-26T404:02:05Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json
x-bce-date: 2019-11-26T404:02:05Z
{
   "vehicleIdList":["QGON_10000"], 
   "startTime":1575547309000,             
   "endTime":1575547369000,                
   "alarmTypeList":["SMOKING"]  
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 26 Nov 2019 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS   
{
   "alarmVideoInfoList": [
    {
        "longitude":120.0,
        "latitude":52.3,
        "alarmType":"SMOKING",
        "alarmUuid":"e4bef110270b4a5b98ada3945502b946",
        "alarmTime": 1575547309000,
        "alarmEndTime":1575547369000,
        "vehicleId":"QGON_10000",
        "vehicleName":"沪A10000",
        "groupName":"默认分组",
        "mediaInfoList": [
            {
                "mediaUuid":"2e415445f2e74cc3ab00043def558a84",
                "channelNum":0,
                "startTime": 1575547309000,
                "endTime": 1575547369000,
                "fileName":"test.mp4",
                "fileSize":8,
                "status":"TERMINAL",
                "mediaType":"VIDEO",
                "streamType":"MAIN_STREAM",
                "duration":60000
            }
        ]
    }
   ]
}

查询一批报警uuid对应的多媒体是否存在

接口描述：本接口用于用户下指定alarmUuidList，获取多媒体是否存在信息

注意事项

本接口是用户指定下alarmUuidList，获取多媒体是否存在信息

未激活的设备无法查询音频视频信息

请求结构

POST /v1/video/query/alarm/check-exist
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-26T409:02:05Z
{
  "alarmUuidList": alarmUuidList
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
alarmUuidList	List<String>	是	RequestBody参数	alarmUuidList，最长不超过20

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
results	List<CheckResultInfo>	多媒体信息存在与否列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误(报警Uuid长度超过最大限制长度）	400	请求参数有误（报警Uuid长度超过最大限制长度）

请求示例

POST /v1/video/query/alarm/check-exist
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-11-26T404:02:05Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json
x-bce-date: 2019-11-26T404:02:05Z
{
  "alarmUuidList":["12341", "980990u90"]             
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Tue, 26 Nov 2019 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS 
{
   "results": [
    {
        "alarmUuid":"e4bef110270b",
        "videoStatus": 1,
        "imageStatus": 1
    }
   ]
}

指定时间段的文件信息

接口描述：本接口用于根据时间段获取视频信息

用户粒度获取指定时间段的文件信息

注意事项

本接口用于根据指定时间段获取文件信息

指定的时间段跨度最多为24小时
查询的时间段，结束时间必须大于开始时间，且时间段不得超过最大限制
未购买车辆网服务的用户将无法进行查询操作

请求结构

POST /v1/video/query/mediaInfo 
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-27T09:02:05Z
{
  "startTime": startTime,
  "endTime": endTime,
  "statusList": statusList,
  "alarmTypeList": alarmTypeList,
  "channelList": channelList,
  "streamType": streamType
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
startTime	long	是	RequestBody参数	时间戳，开始时间，ms
endTime	long	是	RequestBody参数	时间戳，结束时间，ms
statusList	List<Integer>	否	RequestBody参数	存储位置列表，0：终端，1：云端。不指定或者空列表表示不做筛选
alarmTypeList	List<String>	否	RequestBody参数	报警类型
channelList	List<Integer>	否	RequestBody参数	通道号列表，1~8，空list或者不填表示不做筛选
streamType	String	否	RequestBody参数	码流，类型：ALL,MAIN_STREAM,SUB_STREAM 。默认为ALL

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
mediaInfoList	List<VehicleMediaInfo>	车辆视频列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidAlarmType	非法报警类型（无此类型）	400	非法报警类型（无此类型）
InvalidRequestParam	请求参数有误（结束时间必须大于开始时间or查询时间段超出限制）	400	请求参数有误（结束时间必须大于开始时间or查询时间超出限制）
IvcNotEnable	未购买车联网服务	400	未购买车联网服务
ServerInternalError	内部服务器错误，请稍后重试	500	内部服务器错误，请稍后重试

请求示例

POST /v1/video/query/mediaInfo
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
  "startTime": 1575547309000, 
  "endTime": 1575547369000,  
  "statusList": [0],     
  "alarmTypeList": ["SMOKING"], 
  "channelList": [1,2,3],    
  "streamType": "MAIN_STREAM"  
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
       "mediaInfoList": [
    {

        "vehicleId":"QGON_10000",
        "vehicleName":"沪A10000",
        "groupName":"默认分组"
        "mediaUuid":"2e415445f2e74", 
        "channelNum":0,
        "startTime": 1575547309000,
        "endTime": 1575547309000,
        "fileName":"test.mp4",
        "fileSize":8,
        "alarmTypes":["SMOKING"],      
        "status":"TERMINAL",        
        "mediaType":"VIDEO",        
        "streamType":"MAIN_STREAM", 
        "duration":60000             
    }
   ]
}

纠偏绑路后的车辆轨迹

接口描述：本接口用于根据时间范围返回纠偏后轨迹的坐标

注意事项

本接口用于查询含load信息的车辆轨迹

时间段选择不超过24小时。同时为了提升相应速度，同时避免轨迹点过多造成请求超时（3s）失败，建议缩短每次请求的时间区间，将一天轨迹拆分成多段进行拼接。

请求结构

POST /v1/video/query/track/gettrack?load
Host: ivc.gz.baidubce.com
Authorization: authorization string
Content-Type: application/json
x-bce-date: 2019-11-27T09:02:05Z
{
  "vehicleId": vehicleId,
  "startTime": startTime,
  "endTime": endTime,
  "isProcessed": isProcessed,
  "processOption": processOption,
  "supplementMode": supplementMode,
  "coordTypeOutput":coordTypeOutput,
  "sortType": sortType,
  "pageIndex": pageIndex,
  "pageSize": pageSize
}

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
vehicleId	String	是	RequestBody参数	车辆ID
startTime	Long	是	RequestBody参数	时间戳，开始时间，ms
endTime	Long	是	RequestBody参数	时间戳，结束时间，ms。结束时间不超过当前时间，不能早于起始时间，且与起始时间相差在24小时之内。
isProcessed	Integer	否	RequestBody参数	是否返回纠偏后轨迹。0，关闭轨迹纠偏，返回原始轨迹；1，打开轨迹纠偏，返回纠偏后轨迹。打开纠偏后，请求时间段内轨迹点数量不能超过2万，否则将返回错误。默认值为0
processOption	String	否	RequestBody参数	纠偏选项。最大长度为128，仅在is_processed=1时生效。默认值为need_denoise=1,radius_threshold=0,need_vacuate=1,need_mapmatch=0,radius_threhold=0,transport_mode=driving 取值规则为： 1.去噪，示例：need_denoise =0：不去噪need_denoise =1：去噪 2.抽稀，示例：need_vacuate =0：不抽稀need_vacuate=1：抽稀 3.绑路，示例：need_mapmatch=0：不绑路 need_mapmatch=1：绑路 4.定位精度过滤，用于过滤掉定位精度较差的轨迹点，每个轨迹点示例：radius_threshold=0：不过滤radius_threshold=20：当取值大于0的整数时，则过滤掉radius大于20的轨迹点。通常 GPS 定位精度不超过20米，Wi-Fi 定位精度不超过100米 5.交通方式，鹰眼将根据不同交通工具选择不同的纠偏策略，目前支持驾车、骑行和步行，示例：transport_mode=driving transport_mode=riding transport_mode=walking
supplementMode	String	否	RequestBody参数	里程补偿方式。最大长度为128，默认值：no_supplement。在里程计算时，两个轨迹点定位时间间隔5分钟以上，被认为是中断。中断轨迹提供以下5种里程估算方式: 1. no_supplement：不补充，中断两点间距离不记入里程。 2. straight：使用直线距离补充。 3. driving：使用最短驾车路线距离补充。 4. riding：使用最短骑行路线距离补充。 5. walking：使用最短步行路线距离补充。
coordTypeOutput	String	否	RequestBody参数	返回的坐标类型。默认值：bd09ll 。该字段用于控制返回结果中的坐标类型。可选值为：gcj02：国测局加密坐标 bd09ll：百度经纬度坐标。该参数仅对国内（包含港、澳、台）轨迹有效，海外区域轨迹均返回 wgs84坐标系
sortType	String	否	RequestBody参数	轨迹的排序规则，默认值是：asc
pageIndex	Integer	否	RequestBody参数	分页索引，取值范围为1-2^21-1，默认值为1
pageSize	Integer	否	RequestBody参数	分页大小，取值范围1-5000，默认值为100。返回结果最大个数与page_index一起计算从第几条结果返回，代表返回结果中每页有几个轨迹点

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
total	Integer	忽略掉page_index,page_size后的轨迹点数量，代表一共有多少条符合条件的轨迹点
size	Integer	符合查询条件的轨迹点数量
distance	Double	符合查询条件的所有轨迹点的总里程。注意，是有关total参数的轨迹点里程，和分页以及本页显示的size无关
tollDistance	Double	此段轨迹的收费里程数，收费道路包括高速等收费路段
startPoint	LocationPointWithLoad	起点信息
endPoint	LocationPointWithLoad	终点信息
points	List<GeoInfoWithLoad>	历史轨迹点列表

错误码

错误码	错误描述	HTTP状态码	中文解释
InvalidRequestParam	请求参数有误（查询时间段超出限制or该车辆ID不存在or该车辆未激活）	400	请求参数有误（查询时间段超出限制or该车辆ID不存在or该车辆未激活）
NotExistResource	资源不存在(该时间段未查询到轨迹）	404	资源不存在（该时间段未查询到轨迹）
IvcNotEnable	未购买车联网服务	400	未购买车联网服务
ServerInternalError	内部服务器错误，请稍后重试	500	内部服务器错误，请稍后重试

请求示例

POST /v1/video/query/track/gettrack?load
Host: ivc.gz.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
  "vehicleId": "QGON_10000",
  "startTime": 1575547309000,
  "endTime": 1575547369000,
  "isProcessed": 0,
  "processOption": "need_denoise=1,
                    radius_threshold=0, 
                    need_vacuate=1,
                    need_mapmatch=0,  
                    radius_threhold=0,
                    transport_mode=driving",
  "supplementMode": "no_supplement",
  "coordTypeOutput":"bd09ll",
  "sortType": "asc",
  "pageIndex": 1,
  "pageSize": 100
}

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
       "total": 1,
       "size": 1,
       "distance": 0.0,
       "tollDistance": 0.0,
       "startPoint": {
                       "latitude": 7.0,
                       "longitude": 62.0,
                       "load":1,
                       "coordType": "wgs84",
                       "locTime": 1575547309000
                       },
       "endPoint": {
                       "latitude": 7.0,
                       "longitude": 62.0, 
                       "load":1,
                       "coordType": "wgs84",
                       "locTime": 1575547369000
                    },
       "points": [{
                       "latitude": 7.0,
                       "longitude": 62.0,
                       "radius":0.0,
                       "speed":12.1,
                       "direction":0,
                       "height":0.0,
                       "load":1,
                       "locTime": 1575547309000
        }]
}

数据类型

流媒体查询接口对象定义

MediaInfo

参数名称	类型	描述
mediaUuid	String	视频id
channelNum	int	通道号
startTime	long	时间戳，视频开始时间，ms
endTime	long	时间戳，视频结束时间，ms
fileName	String	视频文件名称
fileSize	int	视频文件大小，单位字节
alarmTypes	List<String>	报警类型
status	String	存储位置，0：终端，1：云端
mediaType	String	媒体类型，BOTH：音视频，VIDEO：视频，AUDIO：音频
streamType	String	码流类型，ALL，MAIN_STREAM，SUB_STREAM
duration	long	时长，ms

AlarmInfo

参数名称	类型	描述
alarmTime	long	报警时间，ms
alarmEndTime	long	报警结束时间，ms。只有车距过紧和前车防碰撞有这个时间，其余报警两者时间相同
alarmType	String	报警类型
vehicleId	String	车辆ID
vehicleName	String	车辆名称
groupName	String	设备组名称
longitude	double	纬度
latitude	double	经度
alarmRefKey	String	报警标识

AlarmVideoInfo

参数名称	类型	描述
longitude	double	纬度
latitude	double	经度
alarmType	String	报警类型
alarmUuid	String	报警ID
alarmTime	long	报警时间，ms
alarmEndTime	long	报警结束时间，ms
vehicleId	String	车辆ID
vehicleName	String	车辆名称
groupName	String	设备组名称
mediaInfoList	List<VideoInfo>	报警对应的视频信息列表

VideoInfo

参数名称	类型	描述
mediaUuid	String	视频id
channelNum	int	通道号
startTime	long	时间戳，开始时间，ms
endTime	long	时间戳，结束时间，ms
fileName	String	文件名
fileSize	int	文件大小，单位字节
status	String	存储位置， 0：终端，1：云端
mediaType	String	视频类型，BOTH：音视频，VIDEO：视频，AUDIO：音频
streamType	String	码流，类型，ALL,MAIN_STREAM,SUB_STREAM。默认值为ALL
duration	long	时长，ms

CheckResultInfo

参数名称	类型	描述
alarmUuid	String	报警Uuid
videoStatus	int	0：终端，1：云端，2：不存在，只有在“云端”时可从dugo获取播放地址
imageStatus	int	0：终端，1：云端，2：不存在，只有在“云端”时可从dugo获取播放地址

TrackPointInfo

参数名称	类型	描述
longitude	double	报警纬度
latitude	double	报警经度
speed	double	速度，km/h
locTime	long	轨迹定位时间，ms

AlarmTrackInfo

参数名称	类型	描述
longitude	double	报警纬度
latitude	double	报警经度
speed	double	速度，km/h
alarmTime	long	报警时间，ms
alarmUuid	String	报警Uuid
alarmType	String	报警类型
trackMediaInfoList	List<TrackMediaInfo>	多媒体列表

TrackMediaInfo

参数名称	类型	描述
mediaUuid	String	多媒体Uuid
mediaType	String	多媒体类型，BOTH：音视频，VIDEO：视频，AUDIO：音频

VehicleMediaInfo

参数名称	类型	描述
vehicleId	String	车辆ID
vehicleName	String	车辆名称
groupName	String	设备组名称
mediaUuid	String	视频ID
channelNum	int	通道号
startTime	long	时间戳，开始时间，ms
endTime	long	时间抽，结束时间，ms
fileName	String	视频文件名称
fileSize	int	文件大小，单位字节
alarmTypes	List<String>	报警类型列表
status	String	存储位置，0：终端，1：云端
mediaType	String	视频类型，BOTH：音视频，VIDEO：视频，AUDIO：音频
streamType	String	码流，类型，ALL，MAIN_STREAM，SUB_STREAM。默认值为ALL
duration	long	时长，ms

LocationPointWithLoad

参数名称	类型	描述
latitude	Double	纬度
longitude	Double	经度
coordType	String	坐标类型，该字段仅在海外区域时返回，返回值为wgs84。当坐标位于国内时（含港、澳、台）时，返回坐标类型与请求参数coord_type_output所设一致，因此不再返回该字段
locTime	Long	定位时间，ms
load	Integer	是否载重，0：未载重，1：载重

GeoInfoWithLoad

参数名称	类型	描述
latitude	Double	纬度
longitude	Double	经度
radius	Double	定位精度，m
speed	Double	速度，km/h
direction	Integer	方向，范围为[0,359],0度为正北方向，顺时针
height	Double	高度，只在GPS定位结果时才返回，单位：m
locTime	Long	定位时设备时间，该时间为用户上传的时间，ms
load	Integer	是否载重，0：未载重，1载重

报警类型

序号	报警类型	中文描述
0	NULL	无报警
1	CLOSED_EYE	不专心驾驶及闭眼
3	SMOKING	抽烟预警
4	PHONE	打电话预警
5	GLANCE_RIGHT_LEFT	左顾右盼预警
7	YAWN	打哈欠预警
9	LEAVE	离岗预警
10	CONCEAL	遮挡预警
11	FREQUENT_LANE_CHANGE	频繁变道预警
12	LEFT_LANE_DEPARTURE	左车道偏离预警
13	RIGHT_LANE_DEPARTURE	右车道偏离预警
14	FORWARD_COLLISION	前向防碰撞预警
15	HMW	车距过近预警
16	PEDESTRIAN_COLLISION	行人防碰撞预警
17	PHOTO	定时拍照
18	RAPID_ACCELERATION	急加速
19	RAPID_DECELERATION	急减速
20	RAPID_TURN	急转弯
21	ROLLOVER	侧翻
22	COLLISION	碰撞

设备数据API

OTA远程升级服务

度行·智能车辆云 DuGo

度行·智能车辆云 DuGo

流媒体查询API

查询设备指定时间段内的文件信息

按照文件名称检索多媒体

按报警uuid检索多媒体

按报警标识号检索多媒体信息

根据设备ID和时间段检索报警信息

根据时间段检索报警信息

查询车辆指定时间段的报警和视频信息

查询用户指定时间段的报警和视频信息

查询一批设备指定时间段的报警信息

查询一批报警uuid对应的多媒体是否存在

指定时间段的文件信息

纠偏绑路后的车辆轨迹

数据类型

流媒体查询接口对象定义

MediaInfo

AlarmInfo

AlarmVideoInfo

VideoInfo

CheckResultInfo

TrackPointInfo

AlarmTrackInfo

TrackMediaInfo

VehicleMediaInfo

LocationPointWithLoad

GeoInfoWithLoad

报警类型