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 |
参数说明：路口信号机的工作状态指示。例如：如果参数含义表示'停止计时状态激活'和'用于硬件故障检测'，那么二进制为0110000000000000，对应十进制为24576，该参数值填写24576。 二进制第x位数字为1对应的含义： 最小值：0 最大值：16383 |
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 最大值：1999999999 |
likelyEndTime |
否 |
Integer |
参数说明：可能结束时间，毫秒时间戳。 最小值：0 最大值：1999999999 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
startTime |
是 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
minEndTime |
否 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
maxEndTime |
否 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
likelyEndTime |
是 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
timeConfidence |
否 |
Integer |
参数说明：定义置信度。单位为0.5%。 最小值：0 最大值：200 |
nextStartTime |
否 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
nextDuration |
否 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
startUtcTime |
是 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
minEndUtcTime |
否 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
maxEndUtcTime |
否 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
likelyEndUtcTime |
是 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
timeConfidence |
否 |
Integer |
参数说明：定义置信度。单位为0.5%。 最小值：0 最大值：200 |
nextStartUtcTime |
否 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：0~35999。数值36000表示大于1小时的时间长度。数值36001表示无效数值。" |
nextEndUtcTime |
否 |
ReportedTimeMark object |
参数说明：以0.1秒为单位，定义一小时中的时间。可以表示当前小时中的时刻，也可以表示长度不超过1小时的时间段，单位为0.1秒。 取值范围：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"
}
