Map Format

MOSS designed a two-level road network data structure.

Intermediate GeoJSON format

The first level uses the (GeoJSON) standard, which can be readily converted from publicly available data sources.

RoadNet

RoadNet data consists of two types of geometric elements below.

LineString, corresponding to road in map
MultiPoint, corresponding to junction in map

`LineString` type field description

Example

{
    "type": "Feature",
    "id": 25409666,
    "geometry": {
        "type": "LineString",
        "coordinates": [
            [
                113.902208,
                22.590202
            ],
            [
                113.894869,
                22.59406
            ]
        ]
    },
    "properties": {
        "id": 25409666,
        "lanes": 3,
        "highway": "motorway_link",
        "max_speed": 8.333333333333334,
        "name": "",
        "turn": ["ALS","S","SR"], # Around, Left, Staright | Staright | Staright, Right
        "width": 3.2
    }
}

field	type	description
geometry.coordinates	list[list[float64]]	The latitude and longitude coordinates of the `road` in WGS84 format
properties.id	int	The original id of the `road`, which is usually different from the id in the generated map
properties.lanes	int	The number of `lanes` on this `road`
properties.highway	string	Road level from OpenStreetMap (https://wiki.openstreetmap.org/wiki/Key:highway)
properties.max_speed	float64	The speed limit on this `road` in meters per second
properties.name	string	Name of this `road`
properties.turn	list[string]	Optional field: A string representing the allowed turn types for each `lane`, in order from left to right along the direction of the `road`. A: Left turn, S: Straight, L: Right turn. A `lane` can have multiple turn types allowed, e.g. "SL" means the `lane` can be used for either a straight or a left turn. Allowable turn types are: A (left turn), S (straight), L (right turn)
properties.width, properties.lanewidth	float64	Width (in meters) of each `lane` on this `road`
properties.walk_lane_width	float64	Optional field: Walk lane width (in meters) of each `lane` on this `road`
properties.walk_lane_offset	float64	Optional field: The default offset between sidewalk and the `lane` centerlines is the average between sidewalk and lane width, this offset is adjusted from the original centerlines, so the real offset will be: (width+walk_lane_width)*0.5+walk_lane_offset (m)

`MultiPoint` type field description

Example

{
  "type": "Feature",
    "id": 50000000013,
    "geometry": {
      "type": "MultiPoint",
      "coordinates": [
          [
            113.906995,
            22.552684
          ]
        ]
  },
      "properties": {
        "id": 50000000013,
        "in_ways": [
          974379908
        ],
        "out_ways": [
          25436150,
          953806719
        ]
  }
}

field	type	description
geometry.coordinates	list[list[float64]]	The latitude and longitude coordinates of the `junction` in WGS84 format
properties.id	int	The original id of the `junction`, which is usually different from the id in the generated map
properties.in_ways	list[int]	The original ids of all `roads` entering this `junction`
properties.out_ways	list[int]	The original ids of all `roads` exiting this `junction`

AOIs

field	type	description
geometry.coordinates	list[list[list[float64]]]	The latitude and longitude coordinates of the `AOI` exterior in WGS84 format
properties.id	int	The original id of the `AOI`, which is usually different from the id in the generated map
properties.osm_tags	list[dict]	The tags corresponding to the OSM (OpenStreetMap) data for the Area of Interest (AOI) may have a length greater than 1, as the AOI could be a result of merging multiple smaller AOIs. Currently, only five fields within the tags are processed: 1. `landuse`, `leisure`, `amenity`, `building`: These are used to determine the land use type of the AOI. For a simple manual annotation of the AOI type, choose from the following options: - `"landuse":"residential"` - Residential land, - `"landuse":"education"` - Educational and research land, - `"landuse":"commercial"` - Commercial and service facilities land, - `"landuse":"industrial"` - Industrial land, - `"building":"government"` - Administrative and office land, - `"landuse":"other"` - Other land uses 2. `name`: This is used to obtain the name of the AOI. For specific values of these fields and their corresponding meanings, please refer to the OpenStreetMap Wiki at https://wiki.openstreetmap.org/wiki/Key:{key_name}, replacing `{key_name}` with the respective tag key (e.g., 'landuse', 'leisure', etc.).

Example

{
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              31.129645,
              29.976933
            ],
            [
              31.130864,
              29.976937
            ],
            [
              31.131819,
              29.97694
            ],
            [
              31.131828,
              29.975046
            ],
            [
              31.129654,
              29.975039
            ]
          ]
        ]
      },
      "properties": {
        "id": 0,
        "osm_tags": [
          {
            "landuse":"retail",
            "name:en": "Pyramid of Khafre",
            "name:zh": "卡夫拉金字塔",
          }
        ]
      }
}

POIs

field	type	description
geometry.coordinates	list[float64]	The latitude and longitude coordinates of the `POI` in WGS84 format
properties.id	int	The original id of the `POI`, which is usually different from the id in the generated map
properties.name	string	Name of this `POI`
properties.catg	string	Category code, defined in (https://lbs.qq.com/service/webService/webServiceGuide/webServiceAppendix)

Protobuf Map format

The second level is represented in (Protobuf) format, a compact binary format suitable for computer usage.

Header contains meta data of this map

{
  "class": "header",
  "data": {
    "name": "hangzhou",
    "date": "Fri Aug 19 15:12:01 2023",
    "north": 20047.15060441926, 
    "south": -32338.87769681991,
    "west": -18106.391120057444,
    "east": 23241.800579354865,
    "projection": "+proj=tmerc +lat_0=30.2435 +lon_0=120.1648"
  }
}

field	type	description
data.name	string	Name of this map
data.date	string	The time when this map was created
data.north, data.south, data.west,data.east	double	Bounding box of this map
data.taz_x_step, data.taz_y_step	double	Step size of the TAZ in the x and y direction
data.projection	string	Proj.4 projection string

Lane

{
  "class": "lane",
  "data": {
    "id": 0,
    "type": 1,                 
    "turn": 1,                     
    "max_speed": 11.11111111111111,  
    "length": 405.77050412705626,   
    "width": 3.2,                  
    "center_line": {                
      "nodes": [
        {
          "x": -333.409877363847,
          "y": 3892.689241038861
        },
        {
          "x": -270.3333568115683,
          "y": 3896.3202265304885
        },
        {
          "x": -150.42210531337474,
          "y": 3900.0537339189864
        },
      ]
    },
    "predecessors": [   
      {
        "id": 89785,    
        "type": 2      
      },
      {
        "id": 89788,
        "type": 2
      }
    ],
    "successors": [
      {
        "id": 89790,
        "type": 1
      },
      {
        "id": 89791,
        "type": 1
      }
    ],
    "left_lane_ids": [],    
    "right_lane_ids": [],   
    "parent_id": 200000000, 
    "overlaps": [],         
    "aoi_ids": [          
      500001796,
      500010169,
      500010170,
    ]
  }
}

field	type	description
data.id	int	Distinct id of this `lane`
data.type	int	Type of this `lane`. 0: Unspecified, 1: Driving, 2: Walking.
data.turn	int	Turn type of this `lane`. 0: Unspecified, 1: Straight, 2: Left, 3: Right, 4: Around.
data.max_speed	float	The speed limit on this `lane` in meters per second
data.length	float	The length of this `lane`
data.width	float	The width of this `lane`
data.center_line	dict[string,list[dict]]	Centerline geometry points of this `lane`
data.predecessors, data.successors	list[dict]	Predecessor/successor `lanes` of this `lane` , including id of connected `lane` and connection type, 1: connected to the head of other lane, 2: connected to the tail of other lane.
data.left_lane_ids, data.right_lane_ids	list[int]	Left/Right adjacent `lane` id in the same `road` (arranged from near to far)
data.parent_id	int	The `road` id or `junction` id to which it belongs
data.overlaps	list[dict]	Overlap points between lanes (valid only within a `junction`)
data.aoi_ids	list[int]	All `AOI` ids connected to this `lane`

Road

{
  "class": "road",
  "data": {
    "id": 200000000,
    "lane_ids": [
      0,
      63893
    ],
  }
}

field	type	description
data.id	int	Distinct id of this `road`
data.lane_ids	list[int]	The ids of all `lanes` that make up the road, arranged from left to right along the direction of the road. Driving lane first, then walking lanes.

Junction

{
  "class": "junction",
  "data": {
    "id": 300000000,
    "lane_ids": [  
      89785,
      89786,
      89787,
      89788,
      89789,
      180968,
    ]
  }
}

field	type	description
data.id	int	Distinct id of this `junction`
data.lane_ids	list[int]	The ids of all `lanes` that belonging to the junction.
data.phases	AvailablePhase	Distinct id of this `junction`
data.fixed_program	TrafficLight	The ids of all `lanes` that belonging to the junction.

Traffic Light Format

message types	field	type	description
LightState		enum	0: unspecified; 1: red light; 2: green light 3: yellow light
AvailablePhase	states	list[LightState]	the feasible phase for max pressure algorithm, consisting of lighting control situation for each lane in the junction
TrafficLight	junction_id	int	the unique junction ID
	phases	list[Phase]	the lighting control situation of each lane in this phase, and the lane corresponds one-to-one with junction.lane_ids
Phase	duration	float	the phase duration time (seconds)
	states	list[LightState]	the lighting control situation of each lane in this phase, and the lane corresponds one-to-one with junction.lane_ids

AOI

{
  "class": "aoi",
  "data": {
    "id": 500000000,
    "positions": [
      {
        "x": 871.8707642603008,
        "y": 3971.670224670372
      },
      {
        "x": 1145.657731407196,
        "y": 4268.304979330834
      },
      {
        "x": 1357.7498147156743,
        "y": 4100.025863656549
      },
      {
        "x": 871.8707642603008,
        "y": 3971.670224670372
      }
    ],
    "area": 11961.66874272599,   
    "driving_positions": [     
      {
        "lane_id": 9990,
        "s": 222.80558616295468
      }
    ],
    "driving_gates": [         
      {
        "x": 875.0335524878568,
        "y": 3972.2371491341605
      }
    ],
    "walking_positions": [  
      {
        "lane_id": 67871,
        "s": 223.98105794200876
      }
    ],
    "walking_gates": [     
      {
        "x": 878.1963407154128,
        "y": 3972.8040735979494
      }
    ],
    "poi_ids":[],
    "name": "国家大剧院",
    "urban_land_use": "A2"
  }
}

field	type	description
data.id	int	Distinct id of this `AOI`
data.area	float	Area of this `AOI`
data.positions	list[dict]	Exterior geometry points of this `AOI`
data.driving_positions, data.walking_positions	list[dict]	The position of the connection point on the `lane` (represented by `lane` id and `s`, where `s` is the distance from the starting point of `lane` to the target point along `lane`)
data.driving_gates, data.walking_gates	list[dict]	The entrances and exits connected to various lanes on the `AOI` boundary, corresponding one-to-one with the order of `driving_positions`/`walking_positions`
data.poi_ids	list[int]	All `POI` ids contained in this `AOI`
data.name	string	Name of this `AOI`
data.urban_land_use	string	Land use type, according to https://www.planning.org.cn/law/uploads/2013/1383993139.pdf

POI

{
  "class": "poi",
  "data": {
    "id": 700000000,
    "name": "悦庭迷你",
    "category": "111000",
    "position": { 
      "x": 9198.956125039857,
      "y": -15926.569325368913
    },
    "aoi_id": 500004914,
  }
}

field	type	description
data.id	int	Distinct id of this `POI`
data.name	string	Name of this `POI`
data.category	string	Category code, defined in (https://lbs.qq.com/service/webService/webServiceGuide/webServiceAppendix)
data.positions	dict[string,float]	Point coordinate of this `POI`
aoi_id	int	The id of the `AOI` which contained this `POI`

Intermediate GeoJSON format​

RoadNet​

LineString type field description​

MultiPoint type field description​

AOIs​

POIs​

Protobuf Map format​

Header​

Lane​

Road​

Junction​

Traffic Light Format​

AOI​

POI​

Intermediate GeoJSON format

RoadNet

`LineString` type field description

`MultiPoint` type field description

AOIs

POIs

Protobuf Map format

Header

Lane

Road

Junction

Traffic Light Format

AOI

POI