路网数字化服务 DRIS-路侧即时交通信息(rsi):Message参数

时间:2024-01-02 08:31:51

Message参数

表1 请求Body参数

参数

是否必选

参数类型

描述

body

OpenV2XRSITopicBodyDTO object

参数说明:即时事件消息。来源于边缘感知计算单元分析生成的即时事件。

header

OpenRSITopicHeaderDTO object

参数说明:路侧交通消息的附加描述。

表2 OpenV2XRSITopicBodyDTO

参数

是否必选

参数类型

描述

rsi_source

RSISource object

参数说明:消息来源。

time_stamp

String

参数说明:采集数据的UTC时间。格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z',如2021-12-18T07:20:51.683Z。rsu上报的rsi不推送该字段。

最小长度:0

最大长度:63

rtss

Array of RTSData objects

参数说明:道路交通标志。

数组长度:1 - 16

rtes

Array of RTEData objects

参数说明:道路交通事件。

数组长度:1 - 8

表3 RSISource

参数

是否必选

参数类型

描述

rsi_source_type

String

参数说明:来源的具体类型描述。

取值范围

  • rsu:RSU上报数据

  • obu:车载终端上报数据

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

  • v2xServer:平台上报数据

  • internet:互联网数据

  • meteorological:气象数据

  • government:政府数据

  • police:警方数据

  • unknown:未知数据

  • camera:摄像头

  • sne: sne上报

枚举值:

  • rsu

  • obu

  • detection

  • v2xServer

  • internet

  • meteorological

  • government

  • police

  • unknown

  • camera

  • sne

rsi_source_id

String

参数说明:信息来源的唯一标识码ID。

最小长度:1

最大长度:255

esn

String

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

表4 RTSData

参数

是否必选

参数类型

描述

rts_id

Integer

参数说明:RTS的本地id。

最小值:0

最大值:255

sign_type

Integer

参数说明:道路交通标志类型,参考国标GB 5768.2-2009

最小值:1

最大值:520

cross_id

String

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

最小长度:0

最大长度:64

sign_position

Position3D object

参数说明:位置信息。

sign_description

String

参数说明:道路交通标志的附加说明。

最小长度:0

最大长度:255

time_details

RSITimeDetails object

参数说明:定义道路交通事件和道路交通标志信息的生效时间属性。

sign_priority

Integer

参数说明:道路交通标志紧急程度。数字越大,级别越高。

最小值:0

最大值:7

reference_paths

Array of ReferencePath objects

参数说明:道路交通事件的关联路径。

数组长度:1 - 8

reference_links

Array of ReferenceLink objects

参数说明:道路交通事件的关联路段集合。

数组长度:1 - 16

表5 RTEData

参数

是否必选

参数类型

描述

event_id

String

参数说明:唯一的事件标识ID。

最小长度:0

最大长度:36

rte_id

Integer

参数说明:道路交通事件的本地id。

最小值:0

最大值:255

cross_id

String

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

最小长度:0

最大长度:64

event_type

Integer

参数说明:GB/T 29100-2012定义的事件类型。

最小值:0

最大值:65535

event_source

String

参数说明:来源的具体类型描述。

取值范围

  • rsu:RSU上报数据

  • obu:车载终端上报数据

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

  • v2xServer:平台上报数据

  • internet:互联网数据

  • meteorological:气象数据

  • government:政府数据

  • police:警方数据

  • unknown:未知数据

  • camera:摄像头

-sne: sne上报

枚举值:

  • rsu

  • obu

  • detection

  • v2xServer

  • internet

  • meteorological

  • government

  • police

  • unknown

  • camera

  • sne

event_position

Position3D object

参数说明:位置信息。

event_radius

Integer

参数说明:事件半径,单位分米。

最小值:0

最大值:1000

event_description

String

参数说明:道路交通事件的描述信息。

最小长度:0

最大长度:255

time_details

RSITimeDetails object

参数说明:定义道路交通事件和道路交通标志信息的生效时间属性。

event_priority

Integer

参数说明:道路交通事件的紧急程度。数字越大,级别越高。

最小值:0

最大值:7

reference_paths

Array of ReferencePath objects

参数说明:道路交通事件的关联路径。

数组长度:1 - 8

reference_links

Array of ReferenceLink objects

参数说明:道路交通事件的关联路段集合。

数组长度:1 - 16

event_confidence

Integer

参数说明:道路交通事件的信息来源提供的事件置信度水平,帮助接收端判断是否相信该事件信息,单位为0.5%。

最小值:0

最大值:200

event_ex_info

EdgeEventExInfo object

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

表6 Position3D

参数

是否必选

参数类型

描述

lat

Object

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

最小值:-90

最大值:90.0000001

lon

Object

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

最小值:-179.9999999

最大值:180.0000001

ele

Object

参数说明:定义车辆海拔高程,可选,单位为分米。数值-4096 表示无效数值。

最小值:-4096

最大值:61439

表7 RSITimeDetails

参数

是否必选

参数类型

描述

start_time

Integer

参数说明:数值用来表示当前年份,已经过去的总分钟数(UTC时间)。

最小值:0

最大值:527040

end_time

Integer

参数说明:数值用来表示当前年份,已经过去的总分钟数(UTC时间)。

最小值:0

最大值:527040

end_time_confidence

Integer

参数说明:数值描述了95%置信水平的结束时间置信度。该精度理论上只考虑了当前计时系统本身传感器的误差。参考 时间精度参数说明

最小值:0

最大值:39

表8 ReferencePath

参数

是否必选

参数类型

描述

active_path

Array of Position3D objects

参数说明:与当前情况关联的有效点集。

数组长度:1 - 8

path_radius

Integer

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

最小值:0

最大值:200

表10 NodeReferenceID

参数

是否必选

参数类型

描述

region

Integer

参数说明:所在区域的编号,数值 0 仅用于测试。

最小值:0

最大值:65535

node_id

Integer

参数说明:节点编号,路网最基本的构成即节点和节点之间连接的路段。节点可以是路口,也可以是一条 路的端点。一个节点的ID在同一个区域内是唯一的。数值 0~255 预留为测试使用。

最小值:0

最大值:65535

表11 ReferenceLanes

参数

是否必选

参数类型

描述

reserve0

Boolean

参数说明:保留参数。

缺省值:false

lane1

Boolean

参数说明:左侧第1车道。

缺省值:false

lane2

Boolean

参数说明:左侧第2车道。

缺省值:false

lane3

Boolean

参数说明:左侧第3车道。

缺省值:false

lane4

Boolean

参数说明:左侧第4车道。

缺省值:false

lane5

Boolean

参数说明:左侧第5车道。

缺省值:false

lane6

Boolean

参数说明:左侧第6车道。

缺省值:false

lane7

Boolean

参数说明:左侧第7车道。

缺省值:false

lane8

Boolean

参数说明:左侧第8车道。

缺省值:false

lane9

Boolean

参数说明:左侧第9车道。

缺省值:false

lane10

Boolean

参数说明:左侧第10车道。

缺省值:false

lane11

Boolean

参数说明:左侧第11车道。

缺省值:false

lane12

Boolean

参数说明:左侧第12车道。

缺省值:false

lane13

Boolean

参数说明:左侧第13车道。

缺省值:false

lane14

Boolean

参数说明:左侧第14车道。

缺省值:false

lane15

Boolean

参数说明:左侧第15车道。

缺省值:false

表12 EdgeEventExInfo

参数

是否必选

参数类型

描述

camera_list

Array of EdgeCameraInfo objects

拍摄到事件的摄像头信息;

数组长度:0 - 10

participants

Array of EdgeEventParticipant objects

识别出交通事件时所对应的交通参与者

数组长度:0 - 20

congestion_info

EdgeCongestionInfo object

拥堵事件时,携带的信息

data_source

EdgeDataSourceInfo object

数据来源

表13 EdgeCameraInfo

参数

是否必选

参数类型

描述

id

Integer

SNE的摄像头id,编号从0开始

最小值:0

最大值:128

ip

String

摄像头ip

最小长度:0

最大长度:15

表14 EdgeEventParticipant

参数

是否必选

参数类型

描述

ptc_type

String

交通参与者的具体类型描述,枚举

枚举值:

  • unknown

  • motor

  • non-motor

  • pedestrian

plate_no

String

参数说明:车牌号

取值范围:长度不超过10,大写字母、数字、中文、阿拉伯文的组合。

speed

Integer

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

最小值:0

最大值:8191

vehicle_class

Integer

车辆类型,参考RSM中的车辆类型定义

最小值:0

最大值:255

track_id

Long

感知设备识别的id,具体表示为机动车轨迹ID

最小值:0

最大值:9223372036854775807

lane_no

Integer

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

最小值:-32

最大值:32

gat_vehicle_class

String

参数说明: 国标车辆类型,参考国标

target_rects

Array of TargetRect objects

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

数组长度:0 - 10

start_time

Long

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

最小值:0

最大值:9223372036854775807

表15 TargetRect

参数

是否必选

参数类型

描述

camera_code

String

参数说明:摄像头编码。

最小长度:0

最大长度:32

camera_ip

String

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

最小长度:0

最大长度:32

target_pos

TargetPos object

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

time_stamp_diff

Long

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

表16 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

表17 EdgeCongestionInfo

参数

是否必选

参数类型

描述

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

ReportedPosition3D object

拥堵的起点经纬度

end_point

ReportedPosition3D object

拥堵的终点经纬度

congestion_lanes_info

Array of CongestionLanesInfo objects

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

数组长度:0 - 100

表18 CongestionLanesInfo

参数

是否必选

参数类型

描述

laneid

Integer

参数说明:车辆所处车道。对于桩号递增的道路方向,其车道号为正数。对于桩号递减的道路方向,其车道号为负数。按照行驶方向,从左到右,从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

ReportedPosition3D object

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

end_point

ReportedPosition3D object

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

表19 ReportedPosition3D

参数

是否必选

参数类型

描述

lat

Object

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

最小值:-90

最大值:90.0000001

lon

Object

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

最小值:-179.9999999

最大值:180.0000001

ele

Object

参数说明:定义车辆海拔高程,可选,单位为分米。数值-4096 表示无效数值。

最小值:-4096

最大值:61439

表20 EdgeDataSourceInfo

参数

是否必选

参数类型

描述

radar

Array of integers

雷达id

最小值:0

最大值:2147483647

数组长度:0 - 4

camera

Array of integers

摄像头id

最小值:0

最大值:2147483647

数组长度:0 - 4

表21 OpenRSITopicHeaderDTO

参数

是否必选

参数类型

描述

instance_id

String

参数说明:实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id

取值范围:仅支持数字,小写字母和横杠(-)的组合,长度36。

event

String

参数说明:操作描述。"

取值范围

  • MODIFIED:修改

  • ADDED:新增

  • DELETED:删除

枚举值:

  • MODIFIED

  • ADDED

  • DELETED

support.huaweicloud.com/api-v2x/v2x_04_0135.html