查询历史交通事件列表
功能介绍
查询历史交通事件列表
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v1/{project_id}/history-traffic-events
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数说明：项目ID。获取方法请参见“API参考 > 附录 > 获取项目ID”。 取值范围：仅支持数字，a到f的小写字母组合，长度32。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
参数说明：分页查询时的页码。 |
|
limit |
否 |
Integer |
参数说明：分页查询时每页显示的记录数。 |
|
from_date |
否 |
Long |
参数说明：查询此时间后达到平台的消息，十位Unix时间戳，秒级，例如：1575446506。 |
|
to_date |
否 |
Long |
参数说明：查询此时间前达到平台的消息，十位Unix时间戳，秒级，例如：1576396905。 |
|
event_id |
否 |
String |
参数说明：事件id |
|
event_class |
否 |
String |
参数说明：事件的分类，event_type存在时，event_class必选。 取值范围：
|
|
event_type |
否 |
String |
参数说明：事件类型。参考“API参考 > 附录 > 参数说明列表 > 国标交通标志编码/国标交通事件编码”。 |
|
event_source |
否 |
String |
参数说明：事件来源，默认值v2xServer。 取值范围：
|
|
plate_no |
否 |
String |
参数说明：车牌号。 取值范围：长度最大64，支持中文、阿拉伯文、字母、数字、下划线（_）、横杠（-）、阿拉伯字符的组合。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Instance-Id |
否 |
String |
参数说明：实例ID。DRIS物理实例的唯一标识，获取方法请参见“API参考 > 附录 > 获取Instance-Id”。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 |
|
X-Auth-Token |
否 |
String |
参数说明：用户Token，Token认证鉴权时必选。通过调用IAM服务 “获取IAM用户Token”接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见“API参考 > API > 应用侧API参考 > 如何调用API > 认证鉴权 > Token认证”。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
count |
Long |
参数说明：条件查询返回的总条数。 |
|
events |
Array of HistoryTrafficEventDTO objects |
参数说明：事件列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
event_id |
String |
参数说明：事件ID，由平台生成。 |
|
event_source_type |
String |
参数说明：事件来源类型列表，支持事件来源。 取值范围：
|
|
event_source_id |
String |
参数说明：事件来源ID。 |
|
esn |
String |
参数说明：设备编码。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。 |
|
area_code |
Integer |
参数说明：区域码。 |
|
event_class |
String |
参数说明：事件的分类。 取值范围：
|
|
event_type |
Integer |
参数说明：事件类型。参考“API参考 > 附录 > 参数说明列表 > 国标交通标志编码/国标交通事件编码”。 |
|
cross_id |
String |
参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。 |
|
event_description |
String |
参数说明：交通事件描述。 |
|
event_level |
Integer |
参数说明：事件级别(1-5) 由低到高的事件严重程度。 |
|
event_params |
Map<String,String> |
参数说明：事件参数，用户自定义。 |
|
event_position |
Position3D object |
参数说明：事件发生位置经纬度。 |
|
event_position_name |
String |
参数说明：事件位置名称。 |
|
reference_paths |
Array of ReferencePath objects |
参数说明：事件的关联路径。 |
|
note |
String |
参数说明：用户备注信息。 |
|
event_status |
String |
参数说明：事件的状态。 取值范围：
|
|
event_confidence |
Integer |
参数说明：事件可信度。 |
|
event_ex_info |
EventExInfo object |
参数说明：交通事件扩展信息。 |
|
rsu_id |
Array of strings |
参数说明：事件关联的rsuID。 |
|
start_time |
String |
参数说明：事件的开始时间。 格式：yyyy-MM-dd''T''HH:mm:ss''Z''。 例如 2020-09-01T01:37:01Z。 |
|
end_time |
String |
参数说明：事件的结束时间。 格式：yyyy-MM-dd''T''HH:mm:ss''Z''。 例如 2020-09-01T01:37:01Z。 |
|
created_time |
String |
参数说明：事件的创建时间。 格式：yyyy-MM-dd''T''HH:mm:ss''Z''。 例如 2020-09-01T01:37:01Z。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
active_path |
Array of Position3D objects |
参数说明：事件的有效路径 |
|
path_radius |
Integer |
参数说明：事件的影响区域半径，可选，单位为分米。用半径表示影响区域边界离中心线的垂直距离，反映该区域的宽度以覆盖实际路段。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
lat |
Number |
参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。 |
|
lon |
Number |
参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。 |
|
ele |
Number |
参数说明：定义海拔高程，可选，单位为分米。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
participants |
Array of EventParticipant objects |
参数说明：识别出交通事件时所对应的交通参与者。 |
|
congestion_info |
CongestionInfo object |
参数说明：拥堵事件时携带的信息。 |
|
data_source |
DataSourceInfo object |
数据来源 |
|
camera_list |
Array of CameraInfo objects |
参数说明：拍摄到事件的摄像头信息。 |
|
records |
Array of EventRecordInfo objects |
参数说明：记录列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
ptc_type |
String |
参数说明：交通参与者的具体类型描述。 取值范围：
|
|
plate_no |
String |
参数说明：车牌号。 |
|
speed |
Integer |
参数说明：对应车辆被检测到超速或者慢行时的速度小。单位为0.02米每秒。值为8191时代表无效数值。 |
|
vehicle_class |
Integer |
参数说明：车辆类型。参考“API参考 > 附录 > 参数说明列表 > 车辆基本类型”。 |
|
gat_vehicle_class |
String |
参数说明：机动车车辆类型。参考“API参考 > 附录 > 参数说明列表 > 机动车车辆类型”。 |
|
track_id |
Long |
参数说明：感知设备识别的id，具体表示为机动车轨迹ID。 |
|
lane_no |
Integer |
参数说明：车辆所处车道。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。 |
|
target_rects |
Array of TargetRect objects |
参数说明：目标检测框信息列表。 |
|
start_time |
Long |
参数说明: 本次事件中，车辆检测到事件行为的最初时间；格式：1970开始的毫秒时间。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
camera_code |
String |
参数说明：摄像头编码。 |
|
camera_ip |
String |
参数说明：摄像头IP地址。 |
|
target_pos |
TargetPos object |
参数说明：目标检测框万分比坐标。 |
|
time_stamp_diff |
Long |
参数说明：与SnapTime的时间差值：当前检测框所在相机的时间戳减去雷视拟合轨迹中的SnapTime的差值。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
left_top_x |
Long |
参数说明：目标区域框左上X坐标。 |
|
left_top_y |
Long |
参数说明：目标区域框左上Y坐标。 |
|
right_bottom_x |
Long |
参数说明：目标区域框右下X坐标。 |
|
right_bottom_y |
Long |
参数说明：目标区域框右下Y坐标。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
level |
Integer |
参数说明：拥堵级别。 取值范围：
|
|
length |
Integer |
参数说明：拥堵长度，单位为米（m）。 |
|
speed |
Double |
参数说明：拥堵路段平均车速，单位：km/h。 |
|
start_time |
Long |
参数说明：拥堵开始时间；格式：1970开始的毫秒时间 |
|
start_point |
Position3D object |
参数说明：拥堵的起点经纬度。 |
|
end_point |
Position3D object |
参数说明：拥堵的终点经纬度。 |
|
congestion_lanes_info |
Array of CongestionLanesInfo objects |
参数说明：车道拥堵信息。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
laneid |
Integer |
参数说明：车辆所处车道。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。 |
|
level |
Integer |
参数说明：拥堵级别。 取值范围：
|
|
length |
Integer |
参数说明：拥堵长度，单位为米（m）。 |
|
speed |
Double |
参数说明：车道拥堵路段平均车速，单位：km/h。 |
|
start_time |
Long |
参数说明：车道拥堵开始时间；格式：1970开始的毫秒时间 |
|
start_point |
Position3D object |
参数说明：拥堵的起点经纬度。 |
|
end_point |
Position3D object |
参数说明：拥堵的终点经纬度。 |
请求示例
GET https://{endpoint}/v1/{project_id}/history-traffic-events?limit={limit}&offset={offset}&from_date={from_date}&to_date={to_date}&event_class={event_class}&event_type={event_type}&event_source={event_source}&event_id={event_id}
Content-Type:application/json
X-Auth-Token:********
Instance-Id:********响应示例
状态码： 200
OK
{
"count" : 1,
"events" : [ {
"event_id" : 11111,
"event_source_type" : "RSU",
"event_source_id" : 2,
"esn" : "2102312ETX10K7000037",
"area_code" : 568,
"event_class" : "AbnormalTraffic",
"event_type" : 100,
"cross_id" : 1111,
"event_description" : "交通事故",
"event_level" : 1,
"event_params" : {
"speed" : "60"
},
"event_position" : {
"lat" : 40.1234567,
"lon" : 116.1234567,
"ele" : 1000
},
"event_position_name" : "深圳深南大道",
"reference_paths" : [ {
"active_path" : [ {
"lat" : 40.1234567,
"lon" : 116.1234567,
"ele" : 1000
} ],
"path_radius" : 100
} ],
"note" : "交通事件信息",
"event_status" : "Invalid",
"event_confidence" : 1,
"event_ex_info" : {
"participants" : [ {
"ptc_type" : "unknown",
"plate_no" : "粤B12345",
"speed" : 3000,
"vehicle_class" : 54,
"gat_vehicle_class" : "k33",
"track_id" : 123456789,
"lane_no" : 1,
"target_rects" : [ {
"camera_code" : "abcd",
"camera_ip" : "127.0.0.1",
"target_pos" : [ {
"left_top_x" : 10,
"left_top_y" : 10,
"right_bottom_x" : 5,
"right_bottom_y" : 5
} ],
"time_stamp_diff" : 1664507548437
} ],
"start_time" : 1664507548437
} ],
"congestion_info" : {
"level" : 0,
"length" : 200,
"start_point" : {
"lat" : 40.1234567,
"lon" : 116.1234567,
"ele" : 1000
},
"end_point" : {
"lat" : 40.1234567,
"lon" : 116.1234567,
"ele" : 1000
},
"speed" : 10,
"start_time" : 1664507548437,
"congestion_lanes_info" : [ {
"laneid" : 1,
"level" : 0,
"length" : 200,
"speed" : 10,
"start_time" : 1664507548437,
"start_point" : {
"lat" : 40.1234567,
"lon" : 116.1234567,
"ele" : 1000
},
"end_point" : {
"lat" : 40.1234567,
"lon" : 116.1234567,
"ele" : 1000
}
} ]
},
"data_source" : {
"radar" : [ 0 ],
"camera" : [ 1 ]
},
"camera_list" : [ {
"id" : 0,
"ip" : "127.0.0.1"
} ],
"records" : [ {
"type" : "video",
"url" : "https://aaa.bbb.ccc/v1"
} ]
},
"rsu_id" : [ "b58efc27-a6e5-4bca-9d12-c76ecfe3f102" ],
"start_time" : "2019-08-28T16:32:24Z",
"end_time" : "2019-08-28T16:32:24Z"
} ]
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not Allowed |
|
409 |
Conflict |
|
429 |
Too Many Requests |
|
500 |
Internal Server Error |
错误码
请参见错误码。
