RSU上报SPAT
功能介绍
RSU上报spat消息到平台。信号灯消息，包含了一个或多个路口信号机的当前状态信息。结合MAP消息，为车辆提供实时的前方信号机相位信息。
上行TOPIC
v2x/v1/rsu/{esn}/spat/up
Message参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
intersections |
是 |
Array of ReportedIntersectionStateDTO objects |
参数说明：路口信号灯消息集合。 数组长度：0 - 1000 |
|
name |
否 |
String |
参数说明：信号灯消息名称。 最小长度：1 最大长度：63 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
intersectionId |
是 |
ReportedNodeReferenceId object |
参数说明：节点属性ID。 |
|
status |
否 |
Integer |
参数说明：路口信号机的工作状态指示。以二进制表示，位数从左边高位开始为第一位，前14位分别表示不同的工作状态，15、16位默认补0，补全后共16位二进制数。例如：如果参数含义表示'停止计时状态激活'和'用于硬件故障检测'，那么二进制为0110000000000000，对应十进制为24576，该参数值填写24576。 二进制第x位数字为1对应的含义： 最小值：0 最大值：65532 |
|
timeStamp |
否 |
Long |
参数说明：构造消息的毫秒时间戳。例如：1639812051683，转换后代表北京时间2021-12-18 15:20:51。 最小值：0 |
|
timeConfidence |
否 |
Integer |
参数说明：数值描述了95%置信水平的时间精度。时间精度说明参见“API参考 > 附录 > 参数说明列表 > 时间精度”。 最小值：0 最大值：39 |
|
phases |
是 |
Array of ReportedPhaseDTO objects |
参数说明：信号机各道路方向的灯态列表。 数组长度：1 - 16 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
region |
否 |
Integer |
参数说明：所在区域在地图中的编号，数值0仅用于测试。 最小值：0 最大值：65535 |
|
id |
否 |
Integer |
参数说明：节点编号。路网最基本的构成即节点和节点之间连接的路段。节点可以是路口，也可以是一条 路的端点。一个节点的ID在同一个区域内是唯一的。 数值0~255预留为测试使用。 最小值：0 最大值：65535 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
phaseId |
是 |
Integer |
参数说明：定义信号机相位ID。数值0表示无效ID。 最小值：0 最大值：255 |
|
phaseStates |
是 |
Array of ReportedPhaseStateDTO objects |
参数说明：一个信号机的一个相位状态列表。列表中每一个相位状态物理上对应了一种相位灯色，其属性包括了该状态的实时计时信息。 数组长度：1 - 16 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
light |
是 |
String |
参数说明：定义信号机相位的灯色状态。支持GB14886规定的红绿黄三种信号机灯色，以及亮灯、 闪烁和熄灭三种状态。 取值范围： 最小值：0 最大值：8 |
|
timing |
否 |
ReportedTimeChangeDetailsDTO object |
参数说明：定义一个信号机相位的计时状态。提供了两种可选的计时状态格式，一种是倒计时形式，另一种是UTC世界标准时间的形式。在实际使用时，由路侧设施根据实际情况选用。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
counting |
否 |
ReporteTimeCountingDownDTO object |
参数说明：用倒计时形式，描述一个信号机相位状态的完整计时状态。 |
|
utcTiming |
否 |
ReportedUTCTimingDTO object |
参数说明：用UTC世界标准时间形式，描述一个信号机相位状态的完整计时状态。 |
|
startTime |
否 |
Integer |
参数说明：开始时间。以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：有效范围是0~35999。数值36000表示大于1小时的时间长度。数值 36001表示无效数值。 最小值：0 最大值：36001 |
|
likelyEndTime |
否 |
Integer |
参数说明：可能结束时间，以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：有效范围是0~35999。数值36000表示大于1小时的时间长度。数值 36001表示无效数值。 最小值：0 最大值：36001 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
startTime |
是 |
ReportedTimeMark object |
参数说明：表示该相位状态下一次开始（距离当前时刻）的时间，或者预测开始的时间。如果当前正值该相位状态，则该数值为0。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
minEndTime |
否 |
ReportedTimeMark object |
参数说明：如果当前正值该相位状态，则此数值表示当前状态距现在的最短结束时间；如果信号机相位并未处在该状态，则此数值表示距下一个该相位状态的最短结束时长。取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
maxEndTime |
否 |
ReportedTimeMark object |
参数说明：如果当前正值该相位状态，则此数值表示当前状态距现在的最大结束时间；如果信号机相位并未处在该状态，则此数值表示距下一个该相位状态的最大结束时长。取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
likelyEndTime |
是 |
ReportedTimeMark object |
参数说明：如果该信号机相位是固定时长，则该数值就表示当前状态距现在的准确结束时间。如果信号机当前相位是非固定配时（感应配时、手动控制等），则该数值表示预测的结束时间，且预测时间必须在minEndTime和maxEndTime之间，可能由历史数据或一些事件触发等来进行预测。如果信号机没有处在该状态，则此数值表示下一个该相位状态的（固定或预测）时长。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
timeConfidence |
否 |
Integer |
参数说明：上述likelyEndTime预测时间的置信度水平。单位为0.5%。 最小值：0 最大值：200 |
|
nextStartTime |
否 |
ReportedTimeMark object |
参数说明：表示该相位状态从likelyEndTime时间点到第二次再出现的估计时长。与startTime不同的是，startTime表示最近一次该相位状态的开始时间，nextStartTime则表示第一次结束后，直至该相位状态第二次出现的时间间隔。通常在一些经济驾驶模式（ECO Drive)等相关的应用中。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
nextDuration |
否 |
ReportedTimeMark object |
参数说明：表示该相位状态第二次出现时的估计持续时长。与nextStartTime配合使用，通常在一些经济驾驶模式（ECO Drive)等相关的应用中。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
startUtcTime |
是 |
ReportedTimeMark object |
参数说明：表示该相位状态下一次开始的时刻，或者预测开始的时刻。如果当前该相位状态已开始（未结束），则该数值为当前状态开始的时刻。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
minEndUtcTime |
否 |
ReportedTimeMark object |
参数说明：如果当前正值该相位状态，则此数值表示当前状态最小结束时刻；如果信号机相位并未处在该状态，则此数值表示距下一个该相位状态的最小结束时刻。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
maxEndUtcTime |
否 |
ReportedTimeMark object |
参数说明：如果当前正值该相位状态，则此数值表示当前状态最大结束时刻；如果信号机相位并未处在该状态，则此数值表示距下一个该相位状态的最大结束时刻。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
likelyEndUtcTime |
是 |
ReportedTimeMark object |
参数说明：如果该信号机相位是固定时长，则该数值就表示当前状态准确结束时刻。如果信号机当前相位是非固定配时（感应配时、手动控制等），则该数值表示预测的结束时刻，且预测时刻必须在minEndTime和maxEndTime之间，可能由历史数据或一些事件触发等来进行预测。如果信号机没有处在该状态，则此数值表示下一个该相位状态的（固定或预测）结束时刻。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
timeConfidence |
否 |
Integer |
参数说明：上述likelyEndUTCTime预测时间的置信度水平。单位为0.5%。 最小值：0 最大值：200 |
|
nextStartUtcTime |
否 |
ReportedTimeMark object |
参数说明：表示该相位状态从likelyEndUTCTime时间点到第二次再出现的估计时长。与startUTCTime不同的是，startUTCTime表示最近一次该相位状态的开始时刻，nextStartUTCTime则表示第一次结束后，第二次开始的时刻。通常在一些经济驾驶模式（ECO Drive)等相关的应用中。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
|
nextEndUtcTime |
否 |
ReportedTimeMark object |
参数说明：如果当前该相位状态已开始（未结束），则该数值表示该相位状态下一次开始后再结束的估计时刻；如果当前该相位状态未开始，则表示该相位状态第二次开始后再结束的估计时刻。与nextStartUTCTime配合使用，通常在一些经济驾驶模式（ECO Drive)等相关的应用中。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
Message示例
{
"intersections" : [ {
"intersectionId" : {
"region" : 1,
"id" : 301
},
"status" : 6,
"timeStamp" : 1639812051683,
"timeConfidence" : 5,
"phases" : [ {
"phaseId" : 11,
"phaseStates" : [ {
"light" : "3",
"timing" : {
"counting" : {
"startTime" : {
"timeMark" : 0
},
"minEndTime" : {
"timeMark" : 0
},
"maxEndTime" : {
"timeMark" : 0
},
"likelyEndTime" : {
"timeMark" : 0
},
"timeConfidence" : 180,
"nextStartTime" : {
"timeMark" : 0
},
"nextDuration" : {
"timeMark" : 0
}
},
"utcTiming" : {
"startUtcTime" : {
"timeMark" : 0
},
"minEndUtcTime" : {
"timeMark" : 0
},
"maxEndUtcTime" : {
"timeMark" : 0
},
"likelyEndUtcTime" : {
"timeMark" : 0
},
"timeConfidence" : 180,
"nextStartUtcTime" : {
"timeMark" : 0
},
"nextEndUtcTime" : {
"timeMark" : 0
}
},
"startTime" : 1234567890,
"likelyEndTime" : 1234567890
}
} ]
} ]
} ],
"name" : "12345"
}
