Protocol Documentation

当前的模拟时间，单位为秒 current simulation clock, in seconds

AOI ID

POI ID，需要是aoi_id的子poi，否则该值无效 POI ID, needs to be a sub-poi of aoi_id, otherwise the value is invalid

车道id Lane ID

s是车道上的点到车道起点的距离 s is the distance from the point on the lane to the starting point of the lane

最小经度 minimum longitude

最小纬度 minimum latitude

最大经度 maximu longitude

最大纬度 minimum longitude

经度 longitude

纬度 latitude

高程（单位：米） elevation (unit: meters)

地图坐标AOI（必须提供其中之一） Map coordinates AOI (one of these must be provided)

地图坐标Lane+S（必须提供其中之一） Map coordinates Lane+S (one of these must be provided)

WGS84经纬度坐标 WGS84 longitute and latitude coordinates

XY坐标 XY coordinates

x坐标，单位米，对应经度 x coordinate, in meters, corresponding to longitude

y坐标，单位米，对应纬度 y coordinate, in meters, corresponding to latitude

z坐标，单位米，对应高程 z coordinate, in meters, corresponding to elevation

父节点

子节点

节点经纬度位置

节点所在aoi

基站频段id

室内外基站类型

三级级损伤信息

损坏数量

损坏占比

通信需求总量（单位：Bytes）

通信真实总量（单位：Bytes）

通信中断人数

通信满足人数

通信不满足人数

有通信需求的人数

基站需求流量（单位：Bytes）

基站真实流量（单位：Bytes）

基站用户数

基站是否过载

不满足通信需求用户数

满足通信需求用户数

通信中断用户数

有通信需求人数

基站发射功率

电池剩余可用时间（单位：秒）（仅当gateway状态为“电池供电”时启用）

通信需求速率（单位：Bytes/s）

通信真实速率（单位：Bytes/s）

信号强度（单位：dBm）

连接基站

信道分配

接收发射功率（单位：dBm）

信号强度（单位：dBm）

基站ID

基站频段

满足通信需求用户数

未能满足通信需求的用户数

通信中断的用户数

有通信需求的用户数

需求总流量（单位：Bytes）

真实总流量（单位：Bytes）

总基站数

正常基站数

损坏基站数

断电基站数

过载基站数

总网关数

正常网关数

损坏网关数

断电网关数

过载网关数

直流电网关数

基站耗电量(单位：kW·h)

设备状态

五环区域信号强度热力图（500m网格形式呈现）

国贸区域信号强度热力图（50m网格形式呈现）

TODO(张钧): 基站和人的连接怎么表示？ 人相关的数据

AOI相关的数据

统计值

数据库名

集合名

人

组织列表

员工ID

薪水

货物类型

货物名称

货物数量

货物价格（允许暂未定价）

岗位名称

岗位所需员工数量

岗位薪水

组织ID

组织所在的POI ID

员工列表（初始化时由Orgs列表提供，单向绑定到person上）

岗位列表

资金

货物

功能列表 buy: 购买货物 apply: 申请岗位 ...

与person id一致

起始资金

所在组织ID（初始化时不提供，由组织中的员工列表设定）

待查询的组织的ID列表（为空时查询所有组织）

组织的经济情况

待修改的组织员工变动

待修改的组织

新增的员工

删除的员工

修改薪水的员工

修改后的组织的经济情况

待修改的组织货物变动

待修改的组织

货物变动 按照(type, name)相等来判断是否为同一种货物 货物数量为增量，正数表示增加，负数表示减少 price如果未设定则沿用原来的价格，否则使用新的价格

修改后的组织的经济情况

待修改的组织岗位变动

待修改的组织

岗位变动 按照name相等来判断是否为同一种岗位 岗位数量为增量，正数表示增加，负数表示减少 salary如果未设定则沿用原来的薪水，否则使用新的薪水

修改后的组织的经济情况

待修改的组织资金变动

待修改的组织

正数表示增加，负数表示减少

修改后的组织的经济情况

待查询的人的ID列表（为空时查询所有人）

人的经济情况

待修改的人员资金变动

待修改的人员id

资金变动（正数表示增加，负数表示减少）

修改后的人的经济情况

电网节点状态

当前节点的邻居节点的id

在其它关联的网络中如水网使用时，可使用外部id 对于负载，该值表示其在对应模拟中的id

对于电力设施，该值表示所在aoi id

对于10kv变压器组，该值表示变压器组中变压器的数量

描述最大压力信控的可行相位，由每个lane的灯控情况组成，lane与Junction.lane_ids一一对应 Describes the feasible phase for max pressure algorithm, consisting of the lighting control situation for each lane in the junction, nd the lane corresponds one-to-one with junction.lane_ids

相位持续时间，单位秒 Phase duration in seconds

描述该相位下每个lane的灯控情况，lane与Junction.lane_ids一一对应 The lighting control situation of each lane in this phase, and the lane corresponds one-to-one with junction.lane_ids

所在路口id ID of the junction where the traffic light is at

相位循环的一个循环周期 One cycle of phase cycling

Aoi ID（从5_0000_0000开始） Aoi ID (starting from 5_0000_0000)

Aoi名字 Aoi name

Deprecated. Aoi类型 Aoi type

Aoi与行车路网的连接点 Connection point between Aoi and driving lanes

Aoi与步行路网的连接点 Connection point between Aoi and walking lanes

Aoi原始位置（如果只有一个值，则为Aoi所在的点，否则为Aoi多边形的边界） Aoi original position (if there is only one value, it is the point where Aoi is located, otherwise it is the boundary of the Aoi polygon)

Aoi与行车路网连接时在自身边界上的连接点, 与driving_positions按索引一一对应 The connection point on its own boundary when Aoi is connected to the driving lanes corresponds one-to-one with driving_positions by index.

Aoi与步行路网连接时在自身边界上的连接点, 与walking_positions按索引一一对应 The connection point on its own boundary when Aoi is connected to the walking lanes corresponds one-to-one with walking_positions by index.

Aoi面积, 若是Poi则无此字段 Aoi area, if it is Poi, there is no such field

Deprecated. 土地利用分类，若是Poi则无此字段 Land use type, if it is Poi, there is no such field 弃用 deprecated

城市建设用地分类，参照执行标准GB 50137-2011（https://www.planning.org.cn/law/uploads/2013/1383993139.pdf） Urban Land use type, refer to the national standard GB 50137-2011

Aoi包含的Poi Pois contained in Aoi

地图名称 Map name

地图创建时间 Map creation time

最大纬度对应的y坐标 y coordinate corresponding to the maximum latitude

最小纬度对应的y坐标 y coordinate corresponding to the minimum latitude

最大经度对应的x坐标 x coordinate corresponding to the maximum longitude

最小经度对应的x坐标 x coordinate corresponding to the minimum longitude

PROJ.4 投影字符串，用以支持xy坐标到其他坐标系的转换 PROJ.4 projection string to support the conversion of xy coordinates to other coordinate systems

在x方向划分TAZ的步长 Step size of the TAZ in the x-direction

在y方向划分TAZ的步长 Step size of the TAZ in the y-direction

路口id（从3_0000_0000开始） Junction id (starting from 3_0000_0000)

属于该路口Junction的所有车道/人行道等lane All driving/walking lanes belonging to this junction.

属于该路口Junction的所有行车车道组 All driving lane groups belonging to this junction

所有可用信号灯相位 All available phases for max pressure algorithm

默认固定相位信号灯 Default fixed phases traffic light

该车道组的入口道路 The entrance road to this lane group

该车道组的入口角度（弧度制） The entrance angle of this lane group (in radians)

该车道组的出口道路 The exit road for this lane group

该车道组的出口角度（弧度制） The exit angle of this lane group (in radians)

该车道组包含的车道 Lanes in the group

该车道组的转向属性 The turn type of this lane group

车道id（从0开始） lane id (starts from 0)

车道类型 lane type

车道转向 lane turn type

限速 (m/s) max speed (m/s)

中心线长度（单位：米） centerline length (in meters)

车道宽度（单位：米） lane width (in meters)

车道中心线（车辆/行车轨迹线） Lane center line (vehicle/driving line)

Deprecated. 车道左边界线 Lane left boundary line 弃用 deprecated

Deprecated. 车道右边界线 Lane right boundary line 弃用 deprecated

Lanes can drive / walk from 对于Junction内的车道至多1个前驱 For lanes within junction, there is at most 1 predecessor 对于LANE_TYPE_DRIVING，连接类型必为LANE_CONNECTION_TYPE_TAIL For LANE_TYPE_DRIVING, the connection type must be LANE_CONNECTION_TYPE_TAIL 对于LANE_TYPE_WALKING连接类型，两种都有可能 For LANE_TYPE_WALKING, both connection types are possible

Lanes can drive / walk to 对于Junction内的车道至多1个后继 For lanes within junction, there is at most 1 successor 对于LANE_TYPE_DRIVING，连接类型必为LANE_CONNECTION_TYPE_HEAD For LANE_TYPE_DRIVING, the connection type must be LANE_CONNECTION_TYPE_HEAD 对于LANE_TYPE_WALKING连接类型，两种都有可能 For LANE_TYPE_WALKING, both connection types are possible

左侧相邻车道（按从近到远排列） Adjacent lanes on the left (arranged from nearest to far)

右侧相邻车道（按从近到远排列） Adjacent lanes on the right (arranged from nearest to far)

所属的道路road id或路口junction id The road id or junction id it belongs to

车道之间的冲突点（仅在Junction内有效），保证按照self_s从小到大排序 Conflict points between lanes (valid only within Junction), guaranteed to be sorted from small to large according to self_s

连接到该车道的所有AOI All AOIs connected to this lane

所连接的车道Lane的ID ID of the connected lane

连接类型 Connection type

冲突点在本车道上的坐标 Coordinates of the conflict point on this lane

冲突点在冲突车道上的坐标 Coordinates of the conflict point on the conflicted lane

本车道是否有优先通行权 Whether this lane has priority

下一条路的id ID of the next road

我们假定能去往对应道路的车道id范围是连续的，用[a,b]表示 We assume that the range of lane IDs of the next road is continuous, represented by [a, b]

记录去往目标next_road的可行lane集合 set of feasible lanes for going to the next_road

Poi id(从7_0000_0000开始) Poi id (starting from 7_0000_0000)

Poi名称 Poi name

Poi分类编码 Poi category code

Poi原始位置 Poi original position

Poi所属的Aoi Aoi to which the Poi belongs

Poi的容量（能同时容纳的人数），若无则表示无人数限制 The capacity of Poi (the number of people it can accommodate at the same time), if none, it means there is no limit on the number of people

Poi所能提供的功能 The functions the Poi can offer

折线上的点 Points of the polyline

支线ID Subline ID

支线名字 Subline name

该条支线沿途的所有车站AOI，按支线前进顺序排列 All stations along this subline, in the order of advancement of the subline."

依次连接两个相邻车站的road ids Road IDs between two adjacent stations.

支线类型 Type of subline

所属线路名称 Name of the belonging line

发车时刻表 departure schedule

预计算公共交通权重 Precalculate public transport costs

道路id（从2_0000_0000开始） Road ID (starting from 2_0000_0000)

道路名字 road name

属于该道路Road的所有车道/人行道等lane All lanes/sidewalks belonging to the road lane_id是按从最左侧车道到最右侧车道(从前进方向来看)的顺序给出的 lane_ids are given in order from the leftmost lane to the rightmost lane (viewed from the forward direction)

对于包含动态车道的道路，需要通过这一项来指定所有的候选方案 For roads containing dynamic lanes, this is required to specify all candidates

始发站发车时间 Departure time from the departure station

到达沿途站点预计时间 Estimated time to arrive at stops along the way

模拟器gRPC监听地址

设备id

功率

三级损伤信息

损坏数量

损坏占比

设施id

True 表示恢复，False表示摧毁

用电需求不满足比例（没电100%/有电0）

用电需求不满足人数 （没电就是aoi里的人都不满足）

该aoi当前时刻的用电需求,单位为KW

电力系统向该aoi供应的电力,单位为KW

当前各类变压器的平均承受功率，单位为MW

被破坏的节点ID

由于其他节点被破坏导致停止工作的节点ID

AOI相关的数据

事件数据

居民用电需求不满足比例

居民总用电需求,MW

aoi用电需求不满足比例

不满足用电的aoi数量,个数

aoi总用电需求,MW

各类变压器当前的平均承受功率，单位为MW

实体类型

实体ID

主题

ID

主语

谓词

地点

时间

主题

事件列表

事件列表

ID

状态 status

位置（包含逻辑位置、XY位置、经纬度位置） Position (including logical position, XY position, longitude and latitude position)

speed

方向角（atan2计算得到的弧度） Direction angle (radians calculated by atan2)

活动描述 activity descriptions

长度 length

AOI ID

AOI内的人 Persons in AOI

指定AOI ID列表，如果为空，则返回所有AOI信息 List of targeted AOI IDs, if empty, returns all information of AOIs

AOI信息列表 Lis of AOIs information

Lane ID

Lane上的人/车 person/vehicle on the lane

平均速度（m/s） average speed (m/s)

是否限行 whether restricted

交通灯状态 traffic light state

经纬度范围 latitude and longitude bounding box

是否要排除车道上的人的信息 Whether to exclude information of person on the lane

Lane的信息 Lane information

指定的Lane id列表，如果为空，则返回所有Lane的信息 List of targeted lane IDs, if empty, returns all information of lanes

是否要排除车道上的人的信息 Whether to exclude information of person on the lane

Lane的信息 Lane information

Lane id

最大速度（限速），单位：m/s Maximum speed (speed limit), unit: m/s

Lane id

限行 Traffic restriction

指定查询的道路ID列表，为空代表查询所有道路 List of targeted road IDs. If empty, it means querying all roads.

是否要排除车道信息 Whether to exclude lane information

是否要排除车道上的人的信息（仅在包含车道信息时有效） Whether to exclude information about person in the lane (only valid when lane information is included)

道路信息列表 List of road information

三级损伤信息 Three-level ruin information

道路ID road ID

道路平均速度（m/s） road average speed (m/s)

道路拥堵情况 road congestion level

道路中断原因 road interruption reason

车道情况 lane state

损坏数量。Ruined number

损坏占比。Ruined ratio

信号等相关的接口精确到junction The interfaces related to signals are precise to junction

当前路口处的红绿灯 The traffic light at the junction

表示当前路口处的红绿灯处于哪一个相位 Which phase the traffic light is currently in

当前相位的剩余时间 The remaining time of the current phase

需要改变相位的路口编号 The target junction ID

指定当前路口红绿灯的相位 Specify the traffic light phase

当前相位的剩余时间 The remaining time of the current phase

需要改变的红绿灯（含路口编号） The target traffic light (including junction ID)

指定当前路口处的红绿灯的相位 Specify the phase of the traffic light

当前相位的剩余时间 The remaining time of the current phase

需要改变状态的路口编号 The target junction ID

当前路口红绿灯状态，true为通，false为断 The current traffic light status at the junction, true is on, false is off

ID

状态 status

位置（包含逻辑位置、XY位置、经纬度位置） Position (including logical position, XY position, longitude and latitude position)

speed

方向角（atan2计算得到的弧度） Direction angle (radians calculated by atan2)

活动描述 activity descriptions

长度 length

从起点到终点预计的时间(estimation time of arrival) estimation time of arrival

从起点到终点的道路序列 Road sequence from origin to destination 采用道路序列的原因是主动变道对车道级的导航需要频繁修改 The reason for using road sequences is that active lane changing requires frequent modifications to lane level navigation 优先使用road_ids，如果road_ids为空，则使用route（也可以直接忽略route） Prioritize using road_ids. If road_ids is empty, use route (or simply ignore route)

从起点到终点预计的时间(estimation time of arrival) estimation time of arrival

出行方式 journey travelling mode

驾车 Routing results for driving journey

步行 Routing results of walking journey

公交 Routing results of bus journey

车道ID Lane ID

车道在各个时间片（每个5min）的速度 The speed of the lane at each time slot (5 minutes each)

从起点到终点的（Lane+方向）序列 The (Lane+direction) sequence from the origin to destination

从起点到终点预计的时间(estimation time of arrival) estimation time of arrival

Lane ID

移动方向 moving direction

出行列表 List of trips

trips的执行次数，0表示无限循环，大于0表示执行几次 The number of times trips are executed, where 0 represents infinite loops and greater than 0 represents how many times they are executed

期望的出发时间（单位: 秒） Expected departure time (in seconds)

期望的等待时间（单位：秒），如果departure_time为空则wait_time默认为0 Expected waiting time (in seconds), if departure_time is empty, wait_time defaults to 0

出行方式 trip mode

目的地，如果目的地是AOI且指定了XYPosition，则以XYPosition为室内步行的终点 destination, if the destination is AOI and XYPosition is specified, XYPosition is the end point of indoor walking

期望的出发时间（单位: 秒） Expected departure time (in seconds)

期望的等待时间（单位：秒），如果departure_time为空则wait_time默认为0 The expected waiting time (in seconds), if departure_time is empty, wait_time defaults to 0

期望的到达时间（单位: 秒） Expected arrival time (in seconds)

本次出行目的地的活动名 The activity name of the destination for this trip

本次出行对应的可视化模型（覆盖Person Attribute中的默认模型） The visual model corresponding to this trip (overriding the default model in Person Attribute)

预计算的导航结果 Pre calculated routing results

本次出行的所有停靠点 stop points of this trip

停车点AOI坐标（可选） Parking position coordinates AOI (optional)

停车点Lane+S坐标（必须提供） Parking position coordinates Lane+S (must be provided)

停车持续时间 Parking duration time (s)

单位: m/s speed: m/s

自行车模型标签 Bike model tag

公交线路ID bus line ID

公交车容量 bus capacity

公交车模型标签 bus model tag

公交车类型 type of bus

单位: m/s speed: m/s

行人模型标签 Pedestrian model tag

智能体ID agent ID

参数 attribute

初始位置 initial position

初始日程 initial schedules

车辆附加属性 vehicle addtional attribute

公交车附加属性 bus additional attribute

行人附加属性 pedestrian additional attribute

自行车附加属性 bike addition attribute

[可空] 额外的标签（例如：抢修车类型->电网） [can be empty] additional tags (e.g. repair vehicle type -> power grid)

[可空] 智能体简介 [can be empty] agent profile

工作地位置 work position

是否在SLEEP状态下也输出可视化（仅限车辆） Whether to output visualization in the SLEEP state (vehicles only)

单位: m，长度 length: m

单位: m，宽度 width: m

单位: m/s max speed: m/s

单位: m/s^2, 最大加速度（正值） max accelaration: m/s^2 (positive value)

单位: m/s^2, 最大减速度（负值） max deceleration: m/s^2 (negative value)

单位: m/s^2, 一般加速度（正值），要求小于最大加速度 usual acceleration: m/s^2 (positive value), required to be less than the max acceleration

单位: m/s^2, 一般减速度（负值），要求大于最大减速度 usual deceleration: m/s^2 (negative value), required to be greater than the max deceleration

年龄 age

教育水平 education level

性别 gender

消费水平 consumption level

房屋ID 区分不同家庭 House ID, identify which family this person belongs to

单位: m, 完成变道所需路程 Distance required to complete lane change: m

单位：米，本车距离前车的最小距离 The minimum distance between the vehicle and the vehicle in front: m

车辆模型标签 Vehicle model tag