文档首页> 路网数字化服务 DRIS> API参考> API> 应用侧API参考> 历史交通消息管理> 查询历史交通事件列表
更新时间：2023-12-29 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

参数说明：分页查询时的页码。

最小值：0

最大值：199

缺省值：0

limit

否

Integer

参数说明：分页查询时每页显示的记录数。

最小值：1

最大值：50

缺省值：10

from_date

否

Long

参数说明：查询此时间后达到平台的消息，十位Unix时间戳，秒级，例如：1575446506。

最小值：0

最大值：9999999999

to_date

否

Long

参数说明：查询此时间前达到平台的消息，十位Unix时间戳，秒级，例如：1576396905。

最小值：0

最大值：9999999999

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的来源

缺省值：v2xServer

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认证”。

最小长度：1

最大长度：20000

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

count

Long

参数说明：条件查询返回的总条数。

最小值：0

最大值：2147483647

events

Array of HistoryTrafficEventDTO objects

参数说明：事件列表。

数组长度：0 - 256
表5 HistoryTrafficEventDTO

参数

参数类型

描述

event_id

String

参数说明：事件ID，由平台生成。

最小长度：0

最大长度：256

event_source_type

String

参数说明：事件来源类型列表,支持事件来源。

取值范围：

  • unknown：未知数据

  • police：警方数据

  • government：政府数据

  • meteorological：气象数据

  • internet：互联网数据

  • detection：检测器检测到的数据

  • v2xServer：平台上报数据

  • rsu：RSU上报数据

  • obu：车载终端上报数据

  • sne: 无线sne

最小长度：0

最大长度：36

event_source_id

String

参数说明：事件来源ID。

最小长度：0

最大长度：256

esn

String

参数说明：设备编码。 取值范围：长度不超过64，只允许字母、数字、以及_等字符的组合。

area_code

Integer

参数说明：区域码。

最小值：0

最大值：2147483647

event_class

String

参数说明：事件的分类。

取值范围：

  • AbnormalTraffic：异常路况

  • AbnormalVehicle：异常车况

  • AdverseWeather：恶劣天气

  • TrafficSign：标志标牌

event_type

Integer

参数说明：事件类型。参考“API参考 > 附录 > 参数说明列表 > 国标交通标志编码/国标交通事件编码”。

最小值：0

最大值：2000

cross_id

String

参数说明：路口id，对应到一组雷视拟合设备，检测一个特定的路口或者路段。

最小长度：0

最大长度：64

event_description

String

参数说明：交通事件描述。

最小长度：0

最大长度：256

event_level

Integer

参数说明：事件级别(1-5) 由低到高的事件严重程度。

最小值：0

最大值：7

event_params

Map<String,String>

参数说明：事件参数，用户自定义。

event_position

Position3D object

参数说明：事件发生位置经纬度。

event_position_name

String

参数说明：事件位置名称。

最小长度：0

最大长度：256

reference_paths

Array of ReferencePath objects

参数说明：事件的关联路径。

数组长度：0 - 100

note

String

参数说明：用户备注信息。

最小长度：0

最大长度：256

event_status

String

参数说明：事件的状态。

取值范围：

  • Invalid：过期事件，事件发生的时间段在当前时间之前。

  • Active：活动事件，事件正在发生，当前时间处于事件发生时间段内。

  • Future：未来事件，在当前时间之后才会发生的事件。

event_confidence

Integer

参数说明：事件可信度。

最小值：0

最大值：1000

event_ex_info

EventExInfo object

参数说明：交通事件扩展信息。

rsu_id

Array of strings

参数说明：事件关联的rsuID。

最小长度：0

最大长度：256

数组长度：0 - 256

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

参数说明：事件的有效路径

数组长度：0 - 256

path_radius

Integer

参数说明：事件的影响区域半径，可选，单位为分米。用半径表示影响区域边界离中心线的垂直距离，反映该区域的宽度以覆盖实际路段。

最小值：0

最大值：100000
表7 Position3D

参数

参数类型

描述

lat

Object

参数说明：定义纬度数值，北纬为正，南纬为负，单位°，精度小数点后7位。

最小值：-90

最大值：90

lon

Object

参数说明：定义经度数值。东经为正，西经为负，单位°，精度小数点后7位。

最小值：-180

最大值：180

ele

Object

参数说明：定义海拔高程，可选，单位为分米。

最小值：-4095

最大值：61439
表8 EventExInfo

参数

参数类型

描述

participants

Array of EventParticipant objects

参数说明：识别出交通事件时所对应的交通参与者。

数组长度：0 - 20

congestion_info

CongestionInfo object

参数说明：拥堵事件时携带的信息。

data_source

DataSourceInfo object

数据来源

camera_list

Array of CameraInfo objects

参数说明：拍摄到事件的摄像头信息。

数组长度：0 - 10
表9 EventParticipant

参数

参数类型

描述

ptc_type

String

参数说明：交通参与者的具体类型描述。

取值范围：

  • unknown：未知

  • motor：机动车

  • non-motor：非机动车

  • pedestrian：行人

枚举值：

  • unknown

  • motor

  • non-motor

  • pedestrian

plate_no

String

参数说明：车牌号。

最小长度：0

最大长度：32

speed

Integer

参数说明：对应车辆被检测到超速或者慢行时的速度小。单位为0.02米每秒。值为8191时代表无效数值。

最小值：0

最大值：8191

vehicle_class

Integer

参数说明：车辆类型。参考“API参考 > 附录 > 参数说明列表 > 车辆基本类型”。

最小值：0

最大值：255

gat_vehicle_class

String

参数说明：机动车车辆类型。参考“API参考 > 附录 > 参数说明列表 > 机动车车辆类型”。

track_id

Long

参数说明：感知设备识别的id，具体表示为机动车轨迹ID。

最小值：0

最大值：9223372036854775807

lane_no

Integer

参数说明：车辆所处车道。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。

最小值：-32

最大值：32

target_rects

Array of TargetRect objects

参数说明：目标检测框信息列表。

数组长度：0 - 10

start_time

Long

参数说明: 本次事件中，车辆检测到事件行为的最初时间；格式：1970开始的毫秒时间。

最小值：0

最大值：9223372036854775807
表10 TargetRect

参数

参数类型

描述

camera_code

String

参数说明：摄像头编码。

最小长度：0

最大长度：32

camera_ip

String

参数说明：摄像头IP地址。

最小长度：0

最大长度：32

target_pos

TargetPos object

参数说明：目标检测框万分比坐标。

time_stamp_diff

Long

参数说明：与SnapTime的时间差值：当前检测框所在相机的时间戳减去雷视拟合轨迹中的SnapTime的差值。

最小值：-9223372036854775807

最大值：9223372036854775807
表11 TargetPos

参数

参数类型

描述

left_top_x

Long

参数说明：目标区域框左上X坐标。

最小值：0

最大值：2147483647

left_top_y

Long

参数说明：目标区域框左上Y坐标。

最小值：0

最大值：2147483647

right_bottom_x

Long

参数说明：目标区域框右下X坐标。

最小值：0

最大值：2147483647

right_bottom_y

Long

参数说明：目标区域框右下Y坐标。

最小值：0

最大值：2147483647
表12 CongestionInfo

参数

参数类型

描述

level

Integer

参数说明：拥堵级别。

取值范围：

  • 1：拥堵级别低，速度[25, 30) 单位：km/h

  • 2：拥堵级别中，速度[15，25) 单位：km/h

  • 3：拥堵级别高，速度[0, 15) 单位：km/h

最小值：0

最大值：3

length

Integer

参数说明：拥堵长度，单位为米（m）。

最小值：0

最大值：1000

speed

Double

参数说明：拥堵路段平均车速，单位：km/h。

最小值：0

最大值：250

start_time

Long

参数说明：拥堵开始时间；格式：1970开始的毫秒时间

最小值：0

最大值：9223372036854775807

start_point

Position3D object

参数说明：拥堵的起点经纬度。

end_point

Position3D object

参数说明：拥堵的终点经纬度。

congestion_lanes_info

Array of CongestionLanesInfo objects

参数说明：车道拥堵信息。

数组长度：0 - 100
表13 CongestionLanesInfo

参数

参数类型

描述

laneid

Integer

参数说明：车辆所处车道。如果感知设备支持覆盖双向行驶方向时，桩号递增行驶方向，车道号从左到右从1依次递增；桩号递减行驶方向，车道号从左到右从-1依次递减。如果感知设备只支持覆盖单向车道，可以不区分桩号递增或者递减行驶方向，车道号可以按照车辆行驶方向从左到右，从1开始递增。

最小值：-32

最大值：32

level

Integer

参数说明：拥堵级别。

取值范围：

  • 1：拥堵级别低，速度[25, 30) 单位：km/h

  • 2：拥堵级别中，速度[15，25) 单位：km/h

  • 3：拥堵级别高，速度[0, 15) 单位：km/h

最小值：0

最大值：3

length

Integer

参数说明：拥堵长度，单位为米（m）。

最小值：0

最大值：1000

speed

Double

参数说明：车道拥堵路段平均车速，单位：km/h。

最小值：0

最大值：250

start_time

Long

参数说明：车道拥堵开始时间；格式：1970开始的毫秒时间

最小值：0

最大值：9223372036854775807

start_point

Position3D object

参数说明：拥堵的起点经纬度。

end_point

Position3D object

参数说明：拥堵的终点经纬度。
表14 DataSourceInfo

参数

参数类型

描述

radar

Array of integers

雷达id

最小值：0

最大值：2147483647

数组长度：0 - 4

camera

Array of integers

摄像头id

最小值：0

最大值：2147483647

数组长度：0 - 4
表15 CameraInfo

参数

参数类型

描述

id

Integer

参数说明：SNE的摄像头id,编号从0开始。

最小值：0

最大值：128

ip

String

参数说明：摄像头ip。

最小长度：0

最大长度：15

请求示例

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"
      } ]
    },
    "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

错误码

请参见错误码。

分享：

    相关文档

    相关产品