红绿灯信息（spat）
功能介绍
RSU上报spat消息到平台，平台经过处理后将该消息推送到对应的数据转发配置通道。
信号灯消息，包含了一个或多个路口信号灯的当前状态信息。结合MAP消息，为车辆提供实时的前方信号灯相位信息。
TOPIC
v2x-v1-spat
如果新增数据转发配置时填写了topic_prefix参数，则推送的topic：{topic_prefix}v2x-v1-spat。例如topic前缀为test，推送的topic：testv2x-v1-spat。
Message参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
body |
是 |
OpenV2XSPATTopicBodyDTO object |
参数说明：信号灯消息。 |
|
header |
是 |
OpenSPATTopicHeaderDTO object |
参数说明：信号灯消息的附加信息。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
spat_source_type |
是 |
String |
参数说明：来源的具体类型。 枚举值： |
|
spat_source_id |
否 |
String |
参数说明：来源的唯一标识码ID。 最小长度：0 最大长度：255 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
参数说明：信号灯各道路方向的灯态列表。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 PhaseStateDTO objects |
参数说明：一个信号灯的一个相位状态列表。列表中每一个相位状态物理上对应了一种相位灯色，其属性包括了该状态的实时计时信息。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
light_state |
是 |
Integer |
参数说明：定义信号灯相位的灯色状态。支持GB14886规定的红绿黄三种信号灯灯色，以及亮灯、 闪烁和熄灭三种状态。 取值范围： 最小值：0 最大值：8 |
|
timing |
否 |
TimeChangeDetailsDTO object |
参数说明：定义一个信号灯相位的计时状态。提供了两种可选的计时状态格式，一种是倒计时形式，另一种是UTC世界标准时间的形式。在实际使用时，由路侧设施根据实际情况选用。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
counting |
否 |
TimeCountingDownDTO object |
参数说明：用倒计时形式，描述一个信号灯相位状态的完整计时状态。 |
|
utc_timing |
否 |
UTCTimingDTO object |
参数说明：用UTC世界标准时间形式，描述一个信号灯相位状态的完整计时状态。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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表示无效数值。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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表示无效数值。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
time_mark |
是 |
Integer |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。 最小值：0 最大值：36001 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
instance_id |
是 |
String |
参数说明：实例ID。dris物理实例的唯一标识。获取方法参见获取Instance-Id。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 |
|
event |
是 |
String |
参数说明：操作描述。" 取值范围： 枚举值： |
Message示例
{
"header" : {
"instance_id" : "f24b3b95-4a2a-4f6f-a80c-855156b50af7",
"event" : "ADDED"
},
"body" : {
"spat_source" : {
"spat_source_type" : "rsu",
"spat_source_id" : "RSU0123456789"
},
"intersections" : [ {
"intersection_id" : {
"region" : 1,
"node_id" : 301
},
"intersection_status_object" : {
"manual_control_is_enabled" : true,
"stop_time_is_activated" : false,
"failure_flash" : false,
"preempt_is_active" : false,
"signal_priority_is_active" : false,
"fixed_time_operation" : false,
"traffic_dependent_operation" : false,
"standby_operation" : false,
"failure_mode" : false,
"controller_off" : false,
"recent_map_message_update" : false,
"recent_change_in_map_assigned_lanes_ids_used" : false,
"no_valid_map_is_available_at_this_time" : false,
"no_valid_spat_is_available_at_this_time" : false
},
"time_stamp" : "2015-12-12T12:12:12.126Z",
"time_confidence" : 5,
"phases" : 5
} ],
"time_stamp" : "2015-12-12T12:12:12.126Z",
"name" : "12345"
}
}
