地图数据结构

etag

是

String

参数说明：Map消息的etag，格式为：地图来源_格式标准_标准对应的版本_扩展说明_时间。仅允许数字、大小写字母及下划线（_）的组合。

mapParts

是

Array of UploadMapPart objects

参数说明：高精地图的区域列表。

referencePoints

是

Array of UploadMapReferencePoint objects

当前区域的分割参考点，即当前区域地图数据需下发的目标设备

nodes

是

Array of UploadMapNode objects

基于V2X MAP消息集定义的node节点，单一分片地图暂定最大63个node

partNo

否

Integer

参数说明：地图分片编号。当“referencePoints”中的“deviceType”为“OBU”时为必须填。

最小值：1

最大值：65535

deviceType

是

String

参考点设备的设备类型。

deviceId

是

String

参考点设备的设备id, 若设备类型为RSU则为rsu_id，若设备类型为Edge则为v2x_edge_id，若设备类型为OBU则为"all"。设备id为36位小写字母、数字及中划线（-）的组合"，或者是"all"。

name

否

String

参数说明：节点属性名称。仅允许小写字母、大写字母、数字、下划线（_）及中划线（-）的组合。

最小长度：1

最大长度：256

id

是

UploadMapNodeReferenceId object

参数说明：地图节点ID。

refPos

是

UploadMapPosition3D object

参数说明：位置信息。

inLinks

否

Array of UploadMapLink objects

参数说明：节点上下游路段集合。

zone

否

Array of UploadMapZone objects

参数说明：特殊区域，如导流线，禁停区等。

lat

是

Number

参数说明：定义纬度数值，北纬为正，南纬为负，单位为：1°，精确到小数点后7位；

最小值：-90

最大值：90

lon

是

Number

参数说明定义经度数值。东经为正，西经为负，单位为：1°，精确到小数点后7位；

最小值：-180

最大值：180

ele

否

Number

参数说明：定义车辆海拔高程，可选，单位为分米。数值-4096 表示无效数值。

最小值：-4096

最大值：61439

name

否

String

参数说明：路段名称。仅允许小写字母、大写字母、数字、下划线（_）及中划线（-）的组合。

最小长度：1

最大长度：256

upstreamNodeId

是

UploadMapNodeReferenceId object

参数说明：地图节点ID。

speedLimits

否

Array of UploadMapSpeedLimit objects

参数说明：限速列表，最大9个。

linkWidth

是

Integer

参数说明：车道宽度，单位cm。

最小值：0

最大值：400

points

否

Array of UploadMapPosition3D objects

参数说明：路段中心点，数量范围（2~31）。

movements

否

Array of UploadMapMovement objects

参数说明：下游信息，最大32个。

lanes

是

Array of UploadMapLane objects

参数说明：路段包含的车道，最大32个。

stopLine

否

Array of UploadMapPosition3D objects

参数说明：道路停止线，一般在红绿灯路口定义多个坐标点连接成为一条线，通常为两点连接为一条直线，也可以是一条折线，数量范围（2-32）。

remoteIntersection

是

UploadMapNodeReferenceId object

参数说明：地图节点ID。

phaseId

否

Integer

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

最小值：0

最大值：255

laneId

是

Integer

参数说明：车道ID。车道定义在每一条有向路段上，同一条有向路段上的每个车道，都拥有一个单独的ID。以该车道行驶方向为参考，自左向右从1开始编号

最小值：0

最大值：20

laneWidth

是

Integer

参数说明：车道宽度，单位cm。

最小值：0

最大值：400

laneAttributes

是

UploadMapLaneAttributes object

参数说明：定义车道属性。包括车道共享情况以及车道本身所属的类别特性。

maneuvers

否

Array of strings

参数说明：车道所允许的行驶方向。

取值范围：

• straightAllowed：允许直行

• leftAllowed：允许左转向

• rightAllowed：允许右转向

• uTurnAllowed：允许掉头转向

• leftTurnOnRedAllowed：红灯情况下允许左转向

• rightTurnOnRedAllowed：红灯情况下允许右转向

• laneChangeAllowed：允许变道

• noStoppingAllowed：不允许停车

• yieldAllWaysRequired：非保护车道状态，如永久黄灯状态

• goWithHalt：停车，再前行

• caution：小心前行

connectsTo

否

Array of UploadMapConnection objects

参数说明：车道与下游路段车道的连接关系列表。

speedLimits

否

Array of UploadMapSpeedLimit objects

参数说明：限速列表，最大9个。

points

是

Array of UploadMapPosition3D objects

参数说明：车道中间点列表。

parkingSlots

否

Array of UploadMapParkingSlot objects

参数说明：路边停车位。

shareWith

否

Array of strings

参数说明：定义车道被共享的情况。在已有的车道属性定义基础上，该数据表示此车道还会有其他的交通参与者出现，并可能拥有相同的路权。

取值范围:

• overlappingLaneDescriptionProvided：当存在其他车道时，描述重叠共享车道的路径。不适用简单交叉车道。

• multipleLanesTreatedAsOneLane：当车道对象的路径和宽度细节表示多个车道的情况下，使用该参数判断是否为多个车道。各种模式和交通类型都可以共享该车道。

• otherNonMotor：其他非机动车类型的共享车道情况。

• individualMotorizedVehicle：个人机动车共享车道情况。

• bus：公交车共享车道情况。

• taxi：出租车共享车道情况。

• pedestrians：人群共享车道情况。

• cyclistVehicle：自行车共享车道情况。

• trackedVehicle：履带车共享车道情况。

• pedestrian：行人共享车道情况。

laneType

是

UploadMapLaneTypeAttributes object

参数说明：道路属性，根据道路类型定义其具体的属性。该属性包含多个子属性，对于一条车道，只有一个属性会生效，正常情况下只携带一个子属性。如果携带了多个子属性，属于异常情况，取第一个携带的子属性。

leftBoundary

是

UploadMapLaneBoundary object

参数说明：定义车道线属性。

rightBoundary

是

UploadMapLaneBoundary object

参数说明：定义车道线属性。

hovTimes

否

Array of UploadMapHovTime objects

参数说明：hov（多成员车道，High-Occupancy Vehicle Lane）生效时间。

busTimes

否

Array of UploadMapBusTime objects

参数说明：公交车道生效时间生效时间。

prohibitInfos

否

Array of UploadMapProhibitInfo objects

参数说明：禁行信息。

vehicle

否

Array of strings

参数说明：表达车道相关属性。最大个数：16

取值范围:

• revocable

• ramp

• hovLaneOnly

• busOnly

• taxiOnly

• publicUseOnly

• emergency

• permissionOnRequest

crosswalk

否

Array of strings

参数说明：表达车道相关属性。最大个数：16

取值范围:

• revocable

• bicyleAllowed

• xWalkFlyOver

• fixedCycleTime

• biDirectionalCycleTimes

• hasPushWalkButton

• audioSupport

• rfSignalRequestPresent

• unsignalizedSegmentsPresent

bikeLane

否

Array of strings

参数说明：表达车道相关属性。最大个数：16

取值范围:

• revocable

• pedestrianAllowed

• bikeFlyOver

• fixedCycleTime

• biDirectionalCycleTimes

• isolatedByBarrier

• unsignalizedSegmentsPresent

sidewalk

否

Array of strings

参数说明：表达车道相关属性。最大个数：16

取值范围:

• revocable

• bicyleAllowed

• sidewalkFlyOver

• walkBikes

median

否

Array of strings

参数说明：表达车道相关属性。最大个数：16

取值范围:

• revocable

• median

• whiteLineHashing

• stripedLines

• doubleStripedLines

• trafficCones

• constructionBarrier

• trafficChannels

• lowCurbs

• highCurbs

striping

否

Array of strings

参数说明：表达车道相关属性。最大个数：16

取值范围:

• revocable

• drawOnLeft

• drawOnRight

• connectingLanesLeft

• connectingLanesRight

• connectingLanesAhead

trackedVehicle

否

Array of strings

参数说明：表达车道相关属性。最大个数：16

取值范围:

• revocable

• commuterRailRoad

• lightRailRoad

• heavyRailRoad

• otherRailType

parking

否

Array of strings

参数说明：表达车道相关属性。最大个数：16

取值范围:

• revocable

• parallelParking

• headInParking

• notParkZone

• parkingForBus

• parkingForTaxi

• noPublicParking

type

是

String

参数说明：车道线类型。

取值范围：

• singleSolidLine: 单实线

• doubleSolidLine: 双实线

• singleDashedLine: 单虚线

• doubleDashedLine: 双虚线

• dashedSolidLine: 虚实线（内虚，外实）

• solidDashedLine: 实虚线（内实，外虚）

• curbside: 路牙

• railing: 栏杆

• wall: 墙

color

否

String

参数说明：车道线颜色。

取值范围：

• white: 白色

• yellow: 黄色

width

否

Integer

参数说明：车道线宽度，单位：厘米

最小值：0

最大值：100

startTime

是

Integer

参数说明：生效开始时间，定义为一天的分钟数。

最小值：0

最大值：1440

endTime

是

Integer

参数说明：生效结束时间，定义为一天的分钟数。

最小值：0

最大值：1440

validType

否

String

参数说明：生效日期类型。

取值范围：

• allDate: 所有日期

• holiday: 节假日

• exceptHoliday: 节假日除外

• weekend: 周末

• exceptWeekend: 周末除外

startTime

是

Integer

参数说明：生效开始时间，定义为一天的分钟数。

最小值：0

最大值：1440

endTime

是

Integer

参数说明：生效结束时间，定义为一天的分钟数。

最小值：0

最大值：1440

validType

否

String

参数说明：生效日期类型。

取值范围：

• allDate: 所有日期

• holiday: 节假日

• exceptHoliday: 节假日除外

• weekend: 周末

• exceptWeekend: 周末除外

startTime

是

Integer

参数说明：生效开始时间，定义为一天的分钟数。

最小值：0

最大值：1440

endTime

是

Integer

参数说明：生效结束时间，定义为一天的分钟数。

最小值：0

最大值：1440

vehicleType

是

Integer

参数说明：车辆类型，参考车辆基本类型。

最小值：0

最大值：100

validType

否

String

参数说明：生效日期类型。

取值范围：

• allDate: 所有日期

• holiday: 节假日

• exceptHoliday: 节假日除外

• weekend: 周末

• exceptWeekend: 周末除外

remoteIntersection

是

UploadMapNodeReferenceId object

参数说明：地图节点ID。

connectingLane

否

UploadMapConnectingLane object

参数说明：用于定位上游车道转向连接的下游车道。包括下游车道 ID 以及该转向的允许行驶行为下游车道 ID 的作用范围是该车道所在的路段。

phaseId

否

Integer

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

最小值：0

最大值：255

region

否

Integer

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

最小值：0

最大值：65535

id

是

Integer

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

最小值：0

最大值：65535

laneId

是

Integer

参数说明：车道定义在每一条有向路段上，同一条有向路段上的每个车道，都拥有一个单独的ID。车道号以该车道行驶方向为参考，自左向右从1开始编号。

最小值：1

最大值：255

maneuvers

否

Array of strings

参数说明：车道所允许的行驶方向。

取值范围：

• straightAllowed：允许直行

• leftAllowed：允许左转向

• rightAllowed：允许右转向

• uTurnAllowed：允许掉头转向

• leftTurnOnRedAllowed：红灯情况下允许左转向

• rightTurnOnRedAllowed：红灯情况下允许右转向

• laneChangeAllowed：允许变道

• noStoppingAllowed：不允许停车

• yieldAllWaysRequired：非保护车道状态，如永久黄灯状态

• goWithHalt：停车，再前行

• caution：小心前行

type

是

String

参数说明：限速类型。

取值范围：

• unknown: 未知

• maxSpeedInSchoolZone: 学校区域的最大速度

• maxSpeedInSchoolZoneWhenChildrenArePresent: 学校区域存在学生时的最大速度

• maxSpeedInConstructionZone: 建筑区的最大速度

• vehicleMinSpeed: 汽车最小速度

• vehicleMaxSpeed: 汽车最大速度

• vehicleNightMaxSpeed: 汽车夜间行驶最大速度

• truckMinSpeed: 卡车最小速度

• truckMaxSpeed: 卡车最大速度

• truckMinSpeed: 卡车最小速度

• truckNightMaxSpeed: 卡车夜间行驶最大速度

• vehiclesWithTrailersMinSpeed: 拖车最小速度

• vehiclesWithTrailersMaxSpeed: 拖车最大速度

• vehiclesWithTrailersNightMaxSpeed: 拖车夜间行驶最大速度

speed

是

Integer

参数说明：限速大小，单位为0.02m/s。数值8191表示无效数值。

最小值：0

最大值：8191

polygon

是

Array of UploadMapPosition3D objects

参数说明：停车位区域边界，通过坐标点顺序连接构成的多边形，一般是四边形，最大32个点。

lat

是

Number

参数说明：定义纬度数值，北纬为正，南纬为负，单位为：1°，精确到小数点后7位；

最小值：-90

最大值：90

lon

是

Number

参数说明定义经度数值。东经为正，西经为负，单位为：1°，精确到小数点后7位；

最小值：-180

最大值：180

side

是

Integer

参数说明：停车位与lane的方位关系。左侧：left（0），右侧：right（1），不使用：not used（2）

最小值：0

最大值：2

poiId

是

Integer

参数说明：停车位id。最大为65535。

最小值：0

最大值：65535

type

是

String

参数说明: 区域类型。

取值范围:

crosswalk：人行横道

constructionIsolation：施工隔离

guideLine：导流线区域

speedBump：减速带

gridLine：方格线区域

regionalBoundary

是

Array of UploadMapPosition3D objects

参数说明：通过坐标点顺序连接构成的多边形，最大32个点。