路网数字化服务 DRIS-红绿灯信息(spat):Message参数

时间:2023-11-01 16:22:11

Message参数

表1 请求Body参数

参数

是否必选

参数类型

描述

body

OpenV2XSPATTopicBodyDTO object

参数说明:信号灯消息。

header

OpenSPATTopicHeaderDTO object

参数说明:信号灯消息的附加信息。

表2 OpenV2XSPATTopicBodyDTO

参数

是否必选

参数类型

描述

spat_source

SPATSource object

参数说明:消息来源。

intersections

Array of IntersectionStateDTO objects

参数说明:路口信号灯集合。

time_stamp

String

参数说明:平台推送消息的UTC时间。

格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。

例如2021-12-18T07:20:51.683Z。

name

String

参数说明:供理解的名称描述。

最小长度:1

最大长度:63

表3 SPATSource

参数

是否必选

参数类型

描述

spat_source_type

String

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

枚举值:

  • unknown

  • police

  • government

  • meteorological

  • internet

  • detection

  • v2xServer

  • rsu

  • obu

  • signalMachine

spat_source_id

String

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

最小长度:0

最大长度:255

表4 IntersectionStateDTO

参数

是否必选

参数类型

描述

intersection_id

NodeReferenceId object

参数说明:节点属性ID。

intersection_status_object

IntersectionStatusObject object

参数说明:路口信号机的工作状态指示。

time_stamp

String

参数说明:信号机发送信号时携带的UTC时间。

格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。

如2021-12-18T07:20:51.683Z。

time_confidence

Integer

参数说明:数值描述了95%置信水平的时间精度。参考时间精度参数说明

最小值:0

最大值:39

phases

Array of PhaseDTO objects

参数说明:信号灯各道路方向的灯态列表。

表5 NodeReferenceId

参数

是否必选

参数类型

描述

region

Integer

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

最小值:0

最大值:65535

node_id

Integer

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

最小值:0

最大值:65535

表6 IntersectionStatusObject

参数

是否必选

参数类型

描述

manual_control_is_enabled

Boolean

参数说明:手动控制状态开启。

stop_time_is_activated

Boolean

参数说明:停止计时状态激活。

failure_flash

Boolean

参数说明:用于硬件故障检测。

preempt_is_active

Boolean

参数说明:优先状态激活。

signal_priority_is_active

Boolean

参数说明:信号优先级状态激活。

fixed_time_operation

Boolean

参数说明:固定配时。

traffic_dependent_operation

Boolean

参数说明:基于交通流状态的配时。

standby_operation

Boolean

参数说明:备用操作,可部分关闭或闪烁。

failure_mode

Boolean

参数说明:故障模式。

controller_off

Boolean

参数说明:控制状态关闭。

recent_map_message_update

Boolean

参数说明:近期地图内容数据更新。

recent_change_in_map_assigned_lanes_ids_used

Boolean

参数说明:近期地图道路id数据更新。

no_valid_map_is_available_at_this_time

Boolean

参数说明:此时无有效地图。

no_valid_spat_is_available_at_this_time

Boolean

参数说明:此时无有效spat信息。

表7 PhaseDTO

参数

是否必选

参数类型

描述

phase_id

Integer

参数说明:定义信号灯相位ID。数值0表示无效ID。

最小值:0

最大值:255

phase_states

Array of PhaseStateDTO objects

参数说明:一个信号灯的一个相位状态列表。列表中每一个相位状态物理上对应了一种相位灯色,其属性包括了该状态的实时计时信息。

表8 PhaseStateDTO

参数

是否必选

参数类型

描述

light_state

Integer

参数说明:定义信号灯相位的灯色状态。支持GB14886规定的红绿黄三种信号灯灯色,以及亮灯、 闪烁和熄灭三种状态。

取值范围

  • 0:不可用

  • 1:黑色

  • 2:红色闪烁

  • 3:红色

  • 4:绿色闪烁

  • 5:通行允许相位(通行绿)

  • 6:通行保护相位(保护绿)

  • 7:黄色

  • 8:黄色闪烁

最小值:0

最大值:8

timing

TimeChangeDetailsDTO object

参数说明:定义一个信号灯相位的计时状态。提供了两种可选的计时状态格式,一种是倒计时形式,另一种是UTC世界标准时间的形式。在实际使用时,由路侧设施根据实际情况选用。

表9 TimeChangeDetailsDTO

参数

是否必选

参数类型

描述

counting

TimeCountingDownDTO object

参数说明:用倒计时形式,描述一个信号灯相位状态的完整计时状态。

utc_timing

UTCTimingDTO object

参数说明:用UTC世界标准时间形式,描述一个信号灯相位状态的完整计时状态。

表10 TimeCountingDownDTO

参数

是否必选

参数类型

描述

start_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

min_end_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

max_end_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

likely_end_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

time_confidence

Integer

参数说明:定义置信度。单位为0.5%。

最小值:0

最大值:200

next_start_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

next_duration

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

表11 UTCTimingDTO

参数

是否必选

参数类型

描述

start_utc_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

min_end_utc_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

max_end_utc_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

likely_end_utc_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

time_confidence

Integer

参数说明:定义置信度。单位为0.5%。

最小值:0

最大值:200

next_start_utc_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

next_end_utc_time

TimeMark object

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

表12 TimeMark

参数

是否必选

参数类型

描述

time_mark

Integer

参数说明:以0.1秒为单位,定义一小时中的时间。可以表示当前小时中的时刻,也可以表示长度不超过1小时的时间段,单位为0.1秒。

取值范围:0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。

最小值:0

最大值:36001

表13 OpenSPATTopicHeaderDTO

参数

是否必选

参数类型

描述

instance_id

String

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

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

event

String

参数说明:操作描述。"

取值范围

  • MODIFIED:修改

  • ADDED:新增

  • DELETED:删除

枚举值:

  • MODIFIED

  • ADDED

  • DELETED

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