度行·智能车辆云DuGo

    流媒体查询API

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

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

    注意事项

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

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

    请求结构

    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远程升级服务