文档首页/ 路网数字化服务 DRIS/ API参考/ API/ 应用侧API参考/ 历史交通消息管理/ 查询历史交通事件列表

更新时间：2024-11-26 GMT+08:00

查看PDF

查询历史交通事件列表

功能介绍

查询历史交通事件列表

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/history-traffic-events

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数说明：项目ID。获取方法请参见“API参考 > 附录 > 获取项目ID”。取值范围：仅支持数字，a到f的小写字母组合，长度32。

表2 Query参数
参数	是否必选	参数类型	描述
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必选。取值范围： AbnormalTraffic：异常路况 AbnormalVehicle：异常车况 AdverseWeather：恶劣天气 TrafficSign：标志标牌
event_type	否	String	参数说明：事件类型。参考“API参考 > 附录 > 参数说明列表 > 国标交通标志编码/国标交通事件编码”。
event_source	否	String	参数说明：事件来源，默认值v2xServer。取值范围： v2xServer：来源为通过Console下发的事件 detection：来源为边缘edge上报的RSI rsu：来源为通过MQTT接入的RSU上报的RSI sne：来源为sne上报的RSI all: 所有上报RSI的来源
plate_no	否	String	参数说明：车牌号。取值范围：长度最大64，支持中文、阿拉伯文、字母、数字、下划线（_）、横杠（-）、阿拉伯字符的组合。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
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

表4 响应Body参数
参数	参数类型	描述
count	Long	参数说明：条件查询返回的总条数。
events	Array of HistoryTrafficEventDTO objects	参数说明：事件列表。

表5 HistoryTrafficEventDTO
参数	参数类型	描述
event_id	String	参数说明：事件ID，由平台生成。
event_source_type	String	参数说明：事件来源类型列表，支持事件来源。取值范围： unknown：未知数据 police：警方数据 government：政府数据 meteorological：气象数据 internet：互联网数据 detection：检测器检测到的数据 v2xServer：平台上报数据 rsu：RSU上报数据 obu：车载终端上报数据 sne: 无线sne
event_source_id	String	参数说明：事件来源ID。
esn	String	参数说明：设备编码。取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。
area_code	Integer	参数说明：区域码。
event_class	String	参数说明：事件的分类。取值范围： AbnormalTraffic：异常路况 AbnormalVehicle：异常车况 AdverseWeather：恶劣天气 TrafficSign：标志标牌
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	参数说明：事件的状态。取值范围： Invalid：过期事件，事件发生的时间段在当前时间之前。 Active：活动事件，事件正在发生，当前时间处于事件发生时间段内。 Future：未来事件，在当前时间之后才会发生的事件。
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。

表6 ReferencePath
参数	参数类型	描述
active_path	Array of Position3D objects	参数说明：事件的有效路径
path_radius	Integer	参数说明：事件的影响区域半径，可选，单位为分米。用半径表示影响区域边界离中心线的垂直距离，反映该区域的宽度以覆盖实际路段。

表7 Position3D
参数	参数类型	描述
lat	Number	参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。
lon	Number	参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。
ele	Number	参数说明：定义海拔高程，可选，单位为分米。

表8 EventExInfo
参数	参数类型	描述
participants	Array of EventParticipant objects	参数说明：识别出交通事件时所对应的交通参与者。
congestion_info	CongestionInfo object	参数说明：拥堵事件时携带的信息。
data_source	DataSourceInfo object	数据来源
camera_list	Array of CameraInfo objects	参数说明：拍摄到事件的摄像头信息。
records	Array of EventRecordInfo objects	参数说明：记录列表。

表9 EventParticipant
参数	参数类型	描述
ptc_type	String	参数说明：交通参与者的具体类型描述。取值范围： unknown：未知 motor：机动车 non-motor：非机动车 pedestrian：行人
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开始的毫秒时间。

**表10** TargetRect
参数	参数类型	描述
camera_code	String	参数说明：摄像头编码。
camera_ip	String	参数说明：摄像头IP地址。
target_pos	TargetPos object	参数说明：目标检测框万分比坐标。
time_stamp_diff	Long	参数说明：与SnapTime的时间差值：当前检测框所在相机的时间戳减去雷视拟合轨迹中的SnapTime的差值。

**表11** TargetPos
参数	参数类型	描述
left_top_x	Long	参数说明：目标区域框左上X坐标。
left_top_y	Long	参数说明：目标区域框左上Y坐标。
right_bottom_x	Long	参数说明：目标区域框右下X坐标。
right_bottom_y	Long	参数说明：目标区域框右下Y坐标。

**表12** CongestionInfo
参数	参数类型	描述
level	Integer	参数说明：拥堵级别。取值范围： 1：拥堵级别低，速度[25, 30) 单位：km/h 2：拥堵级别中，速度[15，25) 单位：km/h 3：拥堵级别高，速度[0, 15) 单位：km/h
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	参数说明：车道拥堵信息。

**表13** CongestionLanesInfo
参数	参数类型	描述
laneid	Integer	参数说明：车辆所处车道。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。
level	Integer	参数说明：拥堵级别。取值范围： 1：拥堵级别低，速度[25, 30) 单位：km/h 2：拥堵级别中，速度[15，25) 单位：km/h 3：拥堵级别高，速度[0, 15) 单位：km/h
length	Integer	参数说明：拥堵长度，单位为米（m）。
speed	Double	参数说明：车道拥堵路段平均车速，单位：km/h。
start_time	Long	参数说明：车道拥堵开始时间；格式：1970开始的毫秒时间
start_point	Position3D object	参数说明：拥堵的起点经纬度。
end_point	Position3D object	参数说明：拥堵的终点经纬度。

**表14** DataSourceInfo
参数	参数类型	描述
radar	Array of integers	雷达id
camera	Array of integers	摄像头id

**表15** CameraInfo
参数	参数类型	描述
id	Integer	参数说明：SNE的摄像头id，编号从0开始。
ip	String	参数说明：摄像头ip。

**表16** EventRecordInfo
参数	参数类型	描述
type	String	参数说明：记录类型。取值范围： picture: 图片 video: 视频
url	String	参数说明：图片或视频url。

请求示例

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

{
  "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

错误码

请参见错误码。

父主题： 历史交通消息管理

上一篇：历史交通消息管理

下一篇：查询历史交通统计信息列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

查询历史交通事件列表

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？