流媒体查询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 | 碰撞 |