OBU接收SPAT

name

否

String

参数说明：红绿灯消息名称。

最小长度：0

最大长度：256

content

是

表2 ObuReceivedSpatData

参数说明：红绿灯消息内容，该参数值为JSON字符串。

intersections

是

Array of 表3 ObuReceivedIntersectionStateDTO object

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

数组长度：0 - 32

time_stamp

否

String

平台推送消息的UTC时间。

格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'，如"2021-12-18T07:20:51.683Z"。

最大长度：256

name

否

String

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

最小长度：1

最大长度：63

intersection_id

是

表4 ObuReceivedNodeReferenceId object

参数说明：节点属性ID。

status

否

表5 ObuReceivedIntersectionStatusObjDTO object

路口信号机的工作状态指示。

time_stamp

否

String

参数说明：构造消息的UTC时间。

格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'，如"2021-12-18T07:20:51.683Z"。

最大长度：256

time_confidence

否

Integer

参数说明：数值描述了95%置信水平的时间精度。时间精度说明参见“API参考 > 附录 > 参数说明列表 > 时间精度”。

最小值：0

最大值：39

phases

是

Array of 表6 OBUReceivedPhaseDTO object

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

数组长度：1 - 16

region

否

Integer

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

最小值：0

最大值：65535

node_id

是

Integer

参数说明：节点编号。

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

最小值：0

最大值：65535

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信息。

phase_id

是

Integer

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

最小值：0

最大值：255

phase_states

是

Array of 表7 ObuReceivedPhaseStateDTO object

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

数组长度：1 - 16

light_state

是

Integer

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

取值范围：

• 0：不可用
• 1：黑色
• 2：红色闪烁
• 3：红色
• 4：绿色闪烁
• 5：通行允许相位（通行绿）
• 6：通行保护相位（保护绿）
• 7：黄色
• 8：黄色闪烁

最小值：0

最大值：8

timing

否

表8 ObuReceivedTimeChangeDetailsDTO object

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

counting

否

表9 ObuReceivedTimeCountingDownDTO object

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

utc_timing

否

表10 ObuReceivedUTCTimingDTO object

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

start_time

否

Integer

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

取值范围：0~65534。数值36000表示大于1小时的时间长度。数值65535表示无效数值。

最小值：0

最大值：65535

likely_end_time

否

Integer

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

取值范围：0~65534。数值36000表示大于1小时的时间长度。数值65535表示无效数值。

最小值：0

最大值：65535

start_time

是

表11 ObuReceivedTimeMark object

参数说明：表示该相位状态下一次开始（距离当前时刻）的时间，或者预测开始的时间。如果当前正值该相位状态，则该数值为0。

min_end_time

否

表11 ObuReceivedTimeMark object

参数说明：如果当前正值该相位状态，则此数值表示当前状态距现在的最短结束时间；如果信号灯相位并未处在该状态，则此数值表示距下一个该相位状态的最短结束时长。

max_end_time

否

表11 ObuReceivedTimeMark object

参数说明：如果当前正值该相位状态，则此数值表示当前状态距现在的最大结束时间；如果信号灯相位并未处在该状态，则此数值表示距下一个该相位状态的最大结束时长。

likely_end_time

是

表11 ObuReceivedTimeMark object

参数说明：如果该信号灯相位是固定时长，则该数值就表示当前状态距现在的准确结束时间。如果信号灯当前相位是非固定配时（感应配时、手动控制等），则该数值表示预测的结束时间，且预测时间必须在minEndTime和maxEndTime之间，可能由历史数据或一些事件触发等来进行预测。如果信号灯没有处在该状态，则此数值表示下一个该相位状态的（固定或预测）时长。

time_confidence

否

Integer

参数说明: 上述likely_end_time预测时间的置信度水平。单位为0.5%。

最小值：0

最大值：200

next_start_time

否

表11 ObuReceivedTimeMark object

参数说明：表示该相位状态从likely_end_time时间点到第二次再出现的估计时长。与start_time不同的是，start_time表示最近一次该相位状态的开始时间，next_start_time则表示第一次结束后，直至该相位状态第二次出现的时间间隔。通常在一些经济驾驶模式（ECO Drive)等相关的应用中。

next_duration

否

表11 ObuReceivedTimeMark object

参数说明：表示该相位状态第二次出现时的估计持续时长。与next_start_time配合使用，通常在一些经济驾驶模式（ECO Drive)等相关的应用中。

start_utc_time

是

表11 ObuReceivedTimeMark object

参数说明：表示该相位状态下一次开始的时刻，或者预测开始的时刻。如果当前该相位状态已开始（未结束），则该数值为当前状态开始的时刻。

min_end_utc_time

否

表11 ObuReceivedTimeMark object

参数说明：如果当前正值该相位状态，则此数值表示当前状态最小结束时刻；如果信号灯相位并未处在该状态，则此数值表示距下一个该相位状态的最小结束时刻。

max_end_utc_time

否

表11 ObuReceivedTimeMark object

参数说明：如果当前正值该相位状态，则此数值表示当前状态最大结束时刻；如果信号灯相位并未处在该状态，则此数值表示距下一个该相位状态的最大结束时刻。

likely_end_utc_time

是

表11 ObuReceivedTimeMark object

参数说明：如果该信号灯相位是固定时长，则该数值就表示当前状态准确结束时刻。如果信号灯当前相位是非固定配时（感应配时、手动控制等），则该数值表示预测的结束时刻，且预测时刻必须在min_end_time和max_end_time之间，可能由历史数据或一些事件触发等来进行预测。如果信号灯没有处在该状态，则此数值表示下一个该相位状态的（固定或预测）结束时刻。

time_confidence

否

Integer

参数说明：上述likely_end_utc_time预测时间的置信度水平。单位为0.5%。

最小值：0

最大值：200

next_start_utc_time

否

表11 ObuReceivedTimeMark object

参数说明：表示该相位状态从likely_end_utc_time时间点到第二次再出现的估计时长。与start_utc_time不同的是，start_utc_time表示最近一次该相位状态的开始时刻，next_start_utc_time则表示第一次结束后，第二次开始的时刻。通常在一些经济驾驶模式（ECO Drive)等相关的应用中。

next_end_utc_time

否

表11 ObuReceivedTimeMark object

参数说明：如果当前该相位状态已开始（未结束），则该数值表示该相位状态下一次开始后再结束的估计时刻；如果当前该相位状态未开始，则表示该相位状态第二次开始后再结束的估计时刻。与next_start_utc_time配合使用，通常在一些经济驾驶模式（ECO Drive)等相关的应用中。

time_mark

是

Integer

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

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

最小值：0

最大值：36001