# Architecture Design and Code Implementation of Road Network Path Search System

Authors: Hongmin Shen; Hongzhou Pan
Journal: Wireless Communications and Mobile Computing
 (2022)

---

## Abstract

Path search is a hot issue in computer science and artificial intelligence science. When the user enters the starting point and ending point to be queried in the road network path search system, the system will return the best path to the user. In this paper, the road network path search system that can run and calculate the optimal navigation path to the test data is developed by designing the software architecture through the comprehensive use of database design, programming language, shortest path algorithm, UML diagram, software development model, GIS system source data, and other methods. Based on the software design principles of scalability, flexibility, and pluggability, the design and code in this paper can be practically applied to various systems such as GIS, GPS, logistics robots, unmanned aerial vehicles, and autonomous vehicles to realize their road network path planning and navigation functions.


---

## Body

## 1. Introduction

The road network path search system is one of the core functions of various systems such as GIS, GPS, logistics robots, unmanned aerial vehicles, and autonomous vehicles [1]. The shortest path search algorithm includes Dijkstra algorithm, A∗ algorithm, SPFA algorithm, Bellman-Ford algorithm, Floyd-Warshall algorithm, and Johnson algorithm.Dijkstra algorithm is a typical single-source shortest path algorithm to calculate the shortest path from one point to all other points, and its main feature is that the starting point is the center and the outer layer expands until it reaches the ending point [2]. For example, this algorithm can find the shortest path between two cities if the vertices in the graph represent cities, and the weights on the edges represent the driving distance between cities.Bellman-Ford algorithm is also a single-source shortest path algorithm, which differs from the Dijkstra algorithm in that the weight of the edge can be negative [3].SPFA algorithm is a queue optimization of the Bellman-Ford algorithm, with relatively good timeliness. Unlike the Dijkstra algorithm and the Bellman-ford algorithm, the SPFA algorithm has unstable time efficiency, which means that the time required for different graphs varies greatly [4].Floyd-Warshall algorithm is an algorithm for solving the shortest path between any two points. It can correctly deal with the shortest path problem of directed graphs or negative weights [5].A∗ algorithm, like the Dijkstra algorithm, can calculate the shortest path and is a heuristic search algorithm like the Bellman-Ford algorithm [6].Johnson algorithm is a combination of the Dijkstra algorithm and Bellman-Ford algorithm and used to solve the shortest path problem in edge graphs with negative weights [7].Much work so far is focused on algorithms of the road network path search system, but the design and complete implementation of the complete system are rarely discussed. According to the software design principles, this paper designs and implements a complete road network path search system that can be applied in practice. The system design and code are suitable for practical applications of geographic information, logistics, unmanned aerial vehicles, automobiles, and other industries [8].This research is conducted based on the study on existing road network structure of various GIS, GPS, and route planning systems and the software design requirements of accuracy, robustness, flexibility, reusability, and efficiency. The research process is as follows. Firstly, the functional requirements of the system are determined. Secondly, a road network database is developed based on the function compatible with various application scenarios [2]. Thirdly, the software architecture of the path search system is designed based on the database. Fourthly, the Microsoft SQL Server is used to implement the database of system. Finally, the Microsoft C# programming language is adopted to realize the software code of each function of the system.


## 2. Architecture Design of the Road Network Path Search System

### 2.1. Function Description of Path Search System

The function of path search system is as follows: after the user inputs the starting point and the ending point of the query, the system returns the optimal path information to the user [9]. The information returned to the user includes the total length of the path and the instructions to navigate the path. The core processing flow of the program is shown in Figure 1.Figure 1
The core processing flow of the path search system.


### 2.2. Database Design of Road Network Path Search System

For different application scenarios, we design a database compatible with various road networks. The database table design of the road network path search system is as follows.


#### 2.2.1. Road Information Table

The structure of the road information table is shown in Table1 below.Table 1
Road table structure.
Column nameData typePrimary keyIs nullRoadIDintYesNoNameVarchar(50)_NoNoLengthBigintNoNoFatherRoadIDintNoNoThe road information table structure is described as follows:(i)
The data of the road table is obtained by SQL program from the road network data of the GIS system or by field measurement. The road network path search system is generally used together with the GIS system. So, the information including road ID, name, length, and father road ID of the road table can be obtained from the database table of the GIS system by SQL program(ii)
Each road ID requires a road mark that can be mapped to the map metadata(iii)
The names of road tables are distinguished by short codes of location and type. Examples of short code are as follows: Xiamen city’s short code is XM, Chengdu city’s short code is CD, and Wanda Plaza’s short code is WDPZ. The types of the road table include car, foot, logistics, fly, and robot. Based on short codes and types, the following are examples of road tables names: the driving road table name of Xiamen city is XM_CarRoads, the walking road table name of Xiamen city is XM_FootRoads, the logistics road table name of Chengdu city is CD_LogisticsRoads, and the road table name for Wanda Plaza food delivery robot is WDPZ_RobotRoads(iv)
Field description: RoadID indicates the Road ID, Name represents the road name, Length is the road length (or the time or other parameters for calculating the optimal path), FatherRoadID means the parent road ID to which the road belongs


#### 2.2.2. Road Network Topology Table

The road network topology table stores the connection information of the road through a directed graph. The structure of road network topology table is shown in Table2 below.Table 2
The structure of road network topology table.
Column nameData typePrimary keyIs nullConnectionIDintYesNoRoadIDintNoNoLinkedRoadIDintNoNoRightOrLeftNumeric (1)NoYesDirectionNumeric (2)NoYesThe road network topology table structure is described as follows:(i)
The data of road network topology table is obtained by SQL program from the road network data of the GIS system or by field measurement(ii)
The columns of RoadID and LinkedRoadID follow the foreign key constraint by the column RoadID of the road information table(iii)
The road network is a vector diagram that considers one-way lines(iv)
The data description of RightOrLeft column: 0: keep straight, 1: turn right, and 2: turn left(v)
The data description of direction column: 10: east, 20: south, 30: west, and 40: north(vi)
Same as those of the road information table, the names of road network topology tables are distinguished by short codes of location and type. For example: the driving road network topology table name of Xiamen city is XM_CarWayNetwork, the walking road network topology table name of Xiamen city is XM_FootWayNetwork, the logistics road network topology table name of Chengdu city is CD_LogisticsWayNetwork, and the road network topology table name for Wanda Plaza food delivery robot is WDPZ_RobotWayNetwork


### 2.3. UML Class Diagram Design of Road Network Path Search System

The UML class diagram is a graphical notation used to construct and visualize object-oriented systems. Also, it is a type of static structure diagram that describes the structure of a system by showing the system’s classes, their attributes, methods, and the relationships among objects. The principle of single responsibility means that a class does only one specific thing and does not try to do more than it should. According to the principle of single responsibility, opening and closing, Richter substitution, interface, separation, and dependency inversion, the UML class diagram of the road network path search system we designed is shown in Figure2 below.Figure 2
UML class diagram of path search system program.


## 2.1. Function Description of Path Search System

The function of path search system is as follows: after the user inputs the starting point and the ending point of the query, the system returns the optimal path information to the user [9]. The information returned to the user includes the total length of the path and the instructions to navigate the path. The core processing flow of the program is shown in Figure 1.Figure 1
The core processing flow of the path search system.


## 2.2. Database Design of Road Network Path Search System

For different application scenarios, we design a database compatible with various road networks. The database table design of the road network path search system is as follows.


### 2.2.1. Road Information Table

The structure of the road information table is shown in Table1 below.Table 1
Road table structure.
Column nameData typePrimary keyIs nullRoadIDintYesNoNameVarchar(50)_NoNoLengthBigintNoNoFatherRoadIDintNoNoThe road information table structure is described as follows:(i)
The data of the road table is obtained by SQL program from the road network data of the GIS system or by field measurement. The road network path search system is generally used together with the GIS system. So, the information including road ID, name, length, and father road ID of the road table can be obtained from the database table of the GIS system by SQL program(ii)
Each road ID requires a road mark that can be mapped to the map metadata(iii)
The names of road tables are distinguished by short codes of location and type. Examples of short code are as follows: Xiamen city’s short code is XM, Chengdu city’s short code is CD, and Wanda Plaza’s short code is WDPZ. The types of the road table include car, foot, logistics, fly, and robot. Based on short codes and types, the following are examples of road tables names: the driving road table name of Xiamen city is XM_CarRoads, the walking road table name of Xiamen city is XM_FootRoads, the logistics road table name of Chengdu city is CD_LogisticsRoads, and the road table name for Wanda Plaza food delivery robot is WDPZ_RobotRoads(iv)
Field description: RoadID indicates the Road ID, Name represents the road name, Length is the road length (or the time or other parameters for calculating the optimal path), FatherRoadID means the parent road ID to which the road belongs


### 2.2.2. Road Network Topology Table

The road network topology table stores the connection information of the road through a directed graph. The structure of road network topology table is shown in Table2 below.Table 2
The structure of road network topology table.
Column nameData typePrimary keyIs nullConnectionIDintYesNoRoadIDintNoNoLinkedRoadIDintNoNoRightOrLeftNumeric (1)NoYesDirectionNumeric (2)NoYesThe road network topology table structure is described as follows:(i)
The data of road network topology table is obtained by SQL program from the road network data of the GIS system or by field measurement(ii)
The columns of RoadID and LinkedRoadID follow the foreign key constraint by the column RoadID of the road information table(iii)
The road network is a vector diagram that considers one-way lines(iv)
The data description of RightOrLeft column: 0: keep straight, 1: turn right, and 2: turn left(v)
The data description of direction column: 10: east, 20: south, 30: west, and 40: north(vi)
Same as those of the road information table, the names of road network topology tables are distinguished by short codes of location and type. For example: the driving road network topology table name of Xiamen city is XM_CarWayNetwork, the walking road network topology table name of Xiamen city is XM_FootWayNetwork, the logistics road network topology table name of Chengdu city is CD_LogisticsWayNetwork, and the road network topology table name for Wanda Plaza food delivery robot is WDPZ_RobotWayNetwork


## 2.2.1. Road Information Table

The structure of the road information table is shown in Table1 below.Table 1
Road table structure.
Column nameData typePrimary keyIs nullRoadIDintYesNoNameVarchar(50)_NoNoLengthBigintNoNoFatherRoadIDintNoNoThe road information table structure is described as follows:(i)
The data of the road table is obtained by SQL program from the road network data of the GIS system or by field measurement. The road network path search system is generally used together with the GIS system. So, the information including road ID, name, length, and father road ID of the road table can be obtained from the database table of the GIS system by SQL program(ii)
Each road ID requires a road mark that can be mapped to the map metadata(iii)
The names of road tables are distinguished by short codes of location and type. Examples of short code are as follows: Xiamen city’s short code is XM, Chengdu city’s short code is CD, and Wanda Plaza’s short code is WDPZ. The types of the road table include car, foot, logistics, fly, and robot. Based on short codes and types, the following are examples of road tables names: the driving road table name of Xiamen city is XM_CarRoads, the walking road table name of Xiamen city is XM_FootRoads, the logistics road table name of Chengdu city is CD_LogisticsRoads, and the road table name for Wanda Plaza food delivery robot is WDPZ_RobotRoads(iv)
Field description: RoadID indicates the Road ID, Name represents the road name, Length is the road length (or the time or other parameters for calculating the optimal path), FatherRoadID means the parent road ID to which the road belongs


## 2.2.2. Road Network Topology Table

The road network topology table stores the connection information of the road through a directed graph. The structure of road network topology table is shown in Table2 below.Table 2
The structure of road network topology table.
Column nameData typePrimary keyIs nullConnectionIDintYesNoRoadIDintNoNoLinkedRoadIDintNoNoRightOrLeftNumeric (1)NoYesDirectionNumeric (2)NoYesThe road network topology table structure is described as follows:(i)
The data of road network topology table is obtained by SQL program from the road network data of the GIS system or by field measurement(ii)
The columns of RoadID and LinkedRoadID follow the foreign key constraint by the column RoadID of the road information table(iii)
The road network is a vector diagram that considers one-way lines(iv)
The data description of RightOrLeft column: 0: keep straight, 1: turn right, and 2: turn left(v)
The data description of direction column: 10: east, 20: south, 30: west, and 40: north(vi)
Same as those of the road information table, the names of road network topology tables are distinguished by short codes of location and type. For example: the driving road network topology table name of Xiamen city is XM_CarWayNetwork, the walking road network topology table name of Xiamen city is XM_FootWayNetwork, the logistics road network topology table name of Chengdu city is CD_LogisticsWayNetwork, and the road network topology table name for Wanda Plaza food delivery robot is WDPZ_RobotWayNetwork


## 2.3. UML Class Diagram Design of Road Network Path Search System

The UML class diagram is a graphical notation used to construct and visualize object-oriented systems. Also, it is a type of static structure diagram that describes the structure of a system by showing the system’s classes, their attributes, methods, and the relationships among objects. The principle of single responsibility means that a class does only one specific thing and does not try to do more than it should. According to the principle of single responsibility, opening and closing, Richter substitution, interface, separation, and dependency inversion, the UML class diagram of the road network path search system we designed is shown in Figure2 below.Figure 2
UML class diagram of path search system program.


## 3. Code Implementation of Road Network Path Search System

The road path search system is developed using the Microsoft C#.NET programming language, which is a modern, object-oriented, and type-safe programming language with characteristics of being advanced, safe, stable, expandable, and portable. C# enables developers to build many types of secure and robust applications that run in the NET ecosystem. The function description and code of each part of the program are as follows.


### 3.1. RoadNetworkBuilder Class

The RoadNetworkBuilder class initializes each road network object according to location and traffic type. The road network object at each location is a global object, which only needs to be initialized once.The main method of this class is described as follows:(i)
addRoadGraphToNetwork (string city, string type, RoadNetwork roadNetwork): initialize a road network object RoadNetwork according to the location and type (Car, Foot, logistics, Fly, Robot)The code implementation of the RoadNetworkBuilder class is as follows.Pseudocode 1
1. using System.Data.SqlClient;2. namespace JGXY.LBS.Route{3. public class RoadNetworkBuilder{4. public SqlConnection con;5. public RoadNetworkBuilder(SqlConnection conn)6. {this.con = conn; }7. public void addRoadGraphToNetwork(string city,string type,RoadNetwork roadNetwork) {8. string roadSql = “select∗ from ”+city+“_”+type+“Roads”;9. string wayNetworkSql = “select w.RoadID as V_RoadID,r.RoadID as E_RoadID,r.FatherRoadID as E_FatherRoadID ,r.Length as E_length,r.[Name] as E_Name,isnull(RightOrLeft,0) as RightOrLeft,isnull(Orientation,10) as Orientation” +“ from ” +city+“_”+type+“WayNetwork w left outer join ”+city+“_”+type+“Roads r on w.LinkedRoadID = r.RoadID ”;10. SqlDataAdapter roadAdp = new SqlDataAdapter(roadSql,con);11. SqlDataAdapter wayNetworkAdp = new SqlDataAdapter(wayNetworkSql,con);12. try {13. System.Data.DataSet roadData = new System.Data.DataSet();14. roadAdp.Fill(roadData);15. System.Data.DataSet edgeData = new System.Data.DataSet();16.  wayNetworkAdp.Fill(edgeData);17.  RoadGraph graph= new RoadGraph(roadData.Tables[0].Rows.Count);18.//read database initialize route network19.  foreach(System.Data.DataRow myRow in roadData.Tables[0].Rows){20.   Vertice vertex= new Vertice();21.   vertex.RoadID = myRow[“RoadID”].ToString();22.   vertex.FatherRoad = myRow[“FatherRoadID”].ToString();23.   vertex.RoadLength = System.Convert.ToDouble(myRow[“Length”].ToString());24.   vertex.RoadName = myRow[“Name”].ToString();25.   graph.addVertex(vertex);26. }27.   foreach(System.Data.DataRow row in edgeData.Tables[0].Rows){28.  Vertice vertex = new Vertice(row[“V_RoadID”].ToString());29.  Edge edge = new Edge(new Vertice(row[“E_RoadID”].ToString(),row[“E_Name”].ToString(),System.Convert.ToDouble(row[“E_Length”].ToString()),row[“E_FatherRoadID”].ToString()),(Direction.RightOrLeft)System.Enum.Parse(typeof(Direction.RightOrLeft) ,row[“RightOrLeft”].ToString()),(Direction.Orientation)System.Enum.Parse(typeof(Direction.Orientation) ,row[“Orientation”].ToString()));30.   graph.addEdge(vertex,edge);31.  }32.   roadNetwork.addRoadGraph(“RT”,“Car”,graph);}33.   catch(System.Exception e)34.   {35.   throw new Entity.LBS.Route.RouteException(e.Message);36.   }37.  }38. }// END INTERFACE DEFINITION RoadNetworkBuilder39.  }


### 3.2. RoadNetwork Class

The function of the RoadNetwork class is to store various locations and all types of road networks in the system. All types of road networks in the system are initialized only once when the system is started.The code implementation of the RoadNetwork class is as follows.Pseudocode 2
1. namespace JGXY.LBS.Route{2. public class RoadNetwork{3. public System.Collections.Hashtable NetworkHash;4.  public RoadNetwork(){5.  NetworkHash = new System.Collections.Hashtable(10);6.  }7.  public void addRoadGraph(string city,string type,IGraph graph){8.  NetworkHash.Add(city+“_”+type,graph);9.  }10.  public void deleteRoadGraph(string city,string type){11.  NetworkHash.Remove(city+“_”+type);12.  }13.  public bool isRoadGraphExist(string city,string type){14.  return NetworkHash.Contains(city+“_”+type);15.  }16.  }// END CLASS DEFINITION RoadNetwork17. }


### 3.3. IGraph Class

The IGraph class is the network graph interface of the optimal path algorithm. The interface is to realize the scalability and compatibility of the algorithm; that is, the optimal path algorithm can use any topology network graph which conforms to the interface.The code implementation of the IGraph class is as follows:Pseudocode 3
1. namespace JGXY.LBS.Route2. public interface IGraph3. {4.  bool addVertex(object vertex);5.  bool addEdge(object vertex,object edge);6.  object getVertex(object key);7.  object getAdjacentEdges(object vertex);8.  object getEdgeWeight(object edge,object type);9.  object getEdgeWeight(object startVertice,object endVertice,object type);10. bool isVertexExit(object vertex);11. System.Collections.ICollection getPredecessors(object vertex);12. int getVerticesNumber();13. }// END INTERFACE DEFINITION IGraph


### 3.4. RoadGraph Class

The RoadGraph class implements the interface of IGraph class. It saves a road network of one location and one type. The data of the road network is saved by the following format:(i)
Every road is regarded as a vertex, and the distance between the two roads is expressed by the length of the second road(ii)
All vertices (roads) are stored in the hash table. The key of the hash table is road vertex, and the value of the hash table is the set of linked road vertex of this roadThe code implementation of the RoadGraph class is as follows.Pseudocode 4
1. using System.Collections;2. namespace JGXY.LBS.Route3. { public class RoadGraph:IGraph4.  { private int VerticeNumber;5.   public Hashtable HashGraph;6.   public RoadGraph(int totalVerticesNumber)7.   { VerticeNumber = totalVerticesNumber;8.    HashGraph = new Hashtable(totalVerticesNumber,1.0f);9.   }10   public bool addVertex(object vertex)11.   {12.   if(!HashGraph.ContainsKey(vertex))13.   { ArrayList linkedEdges = new ArrayList(6);14.    HashGraph.Add(vertex,linkedEdges);15.    return true;16.    }17.   else18.    { throw new JGXY.LBS.Route.RouteException(“Vertice exits”); }19.   }20.   public bool addEdge(object vertex,object edge)21.   { if(HashGraph.ContainsKey(vertex))22.    { ArrayList linkedEdges = HashGraph[vertex] as ArrayList;23.     linkedEdges.Add(edge);24.     return true;25.    }26.    else27.    {throw new JGXY.LBS.Route.RouteException(“Vertex does not exit”);  }28.   }29.   public object getVertex(object roadID)30.   { return null;31.   }32.   public object getAdjacentEdges(object vertex)33.  { if(HashGraph.ContainsKey(vertex))34.   {ArrayList linkedEdges = HashGraph[vertex] as ArrayList;35.   ArrayList adjacentEdges = new ArrayList(6);36.   adjacentEdges.AddRange(linkedEdges);37.   return adjacentEdges;38.   }39.   else40.   { throw new JGXY.LBS.Route.RouteException(“Vertex does not exit”);}41.  }42.   public object getEdgeWeight(object edge,object type)43.   {return ((Edge)edge).LinkedVertice.RoadLength;}44.   public object getEdgeWeight(object startVertice,object endVertice,object type)45.   {return ((Vertice)endVertice).RoadLength;}46.   public bool isVertexExit(object vertex)47.   { if(HashGraph.ContainsKey(vertex))48.   return true;49.   else50.    return false;51.    }52.   public System.Collections.ICollection getPredecessors(object vertex)53.   {return null;}54.   public int getVerticesNumber()55.   {return this.VerticeNumber; }56.  }57. }// END CLASS DEFINITION RoadGraph58. }


### 3.5. Vertice Class

The function of the vertex class is to store the information of the road. Note: the Vertice class overrides the GetHashCode methods and Equals methods of the base class.(i)
Equals(object obj): the Equals method, defined by the Object class of the C# language, determines whether the specified object is equal to the current one by comparing the memory address of the two objects. So the Vertice class should override the Equals method to determine whether two Vertice objects are equal by comparing the values of the road ID(ii)
GetHashCode(): the Vertice class also overrides the GetHashCode method to generate the hash code by the value of the road IDThe code implementation of the Vertice class is as follows.Pseudocode 5
1. namespace JGXY.LBS.Route2. {3. public class Vertice4. { public string RoadID;5. public string RoadName;6. public double RoadLength;7. public string FatherRoad;8. public Vertice()9. { }10. public Vertice(string roadID)11. { RoadID = roadID; }12. public Vertice(string roadID,string roadName,double roadLength,string fatherRoad)13. { RoadID = roadID;14. RoadName = roadName;15. RoadLength = roadLength;16. FatherRoad = fatherRoad;17. }18. public override int GetHashCode()19. {return RoadID.GetHashCode();}20. public override bool Equals(object obj)21. { if(this.RoadID == ((Vertice)obj).RoadID)22. return true;23. else24.  return false;25. }26. public Vertice Clone()27. { return new Vertice(RoadID,RoadName,RoadLength,FatherRoad); }28. }// END CLASS DEFINITION vertice29.}


### 3.6. Edges Class

Edges class is a linked edge class, used to store the linked way of each road.The code implementation of the Edges class is as follows:Pseudocode 6
1. namespace JGXY.LBS.Route2. {3. public class Edge4. {5. public Vertice LinkedVertice;6. public Direction.RightOrLeft RightOrLeft;7. public Direction.Orientation Orientation;8. public Edge(Vertice vertice,Direction.RightOrLeft rightOrLeft,Direction.Orientation orientation)9. { LinkedVertice = vertice;10. RightOrLeft = rightOrLeft;11. Orientation = orientation;12. }13. public override int GetHashCode()14. { return LinkedVertice.RoadID.GetHashCode(); }15. public override bool Equals(object obj)16. { if(this.LinkedVertice.RoadID == ((Edge)obj).LinkedVertice.RoadID)17.  return true;18. else19.  return false;20. }21. public Edge Clone()22. {return new Edge(LinkedVertice.Clone(),RightOrLeft,Orientation); }23. }// END CLASS DEFINITION Edge24.}


### 3.7. BestRoute Class

The BestRoute class that can implement the shortest path algorithm is used to compute the shortest path between two vertices.The code implementation of the BestRoute class is as follows.Pseudocode 7
1. using System.Collections;2. namespace JGXY.LBS.Route3. { public class BestRoute4. { public IGraph Graph;5. private PriorityQueue priorityQueue;6. private Hashtable determinedEdges;7. private Hashtable shortestPathMap;8. private Hashtable preducessorsMap;9. public BestRoute(IGraph graph)10. { this.Graph = graph;11. int verticeNumber = graph.getVerticesNumber();12. priorityQueue = new PriorityQueue(verticeNumber);13. determinedEdges = new Hashtable(verticeNumber);14. shortestPathMap = new Hashtable(verticeNumber);15. preducessorsMap = new Hashtable(verticeNumber);16. }17. public void run(object sourceVertex,object destinationVertex)18. { priorityQueue.Clear();19. determinedEdges.Clear();20. determinedEdges.Add(new Edge((Vertice)sourceVertex,Direction.RightOrLeft.Straight,Direction.Orientation.North),0);21. ArrayList adjacentEdges = (ArrayList)Graph.getAdjacentEdges(sourceVertex);22. for(int i =0; i <adjacentEdges.Count;i++)23. { priorityQueue.Enqueue(adjacentEdges[i],((Edge)adjacentEdges[i]).LinkedVertice.RoadLength);24. shortestPathMap.Add((Edge)adjacentEdges[i],((Edge)adjacentEdges[i]).LinkedVertice.RoadLength);25. preducessorsMap.Add((Edge)adjacentEdges[i], new26.    Edge((Vertice)sourceVertex,Direction.RightOrLeft.Straight,Direction.Orientation.North));27. }28. while(!priorityQueue.IsEmpty())29. { Edge minEdge = (Edge)priorityQueue.Dequeue();30. if(minEdge.LinkedVertice.Equals(destinationVertex))31. { preducessorsMap.Add(“END”,minEdge);32. break;33.  }34.   determinedEdges.Add(minEdge,null);35.  relax(minEdge);36.  }37. }38. public void relax(object edge)39. { ArrayList adjacentEdges = (ArrayList)Graph.getAdjacentEdges(((Edge)edge).LinkedVertice);40. for(int i =0; i <adjacentEdges.Count;i++)41. { if(!determinedEdges.Contains(adjacentEdges[i]))42.  { double distance = System.Convert.ToDouble(shortestPathMap[edge]) + ((Edge)adjacentEdges[i]).LinkedVertice.RoadLength;43.  if(distance < priorityQueue.getLenght(adjacentEdges[i]))44.  { priorityQueue.Enqueue(adjacentEdges[i],distance);45.  shortestPathMap.Add((Edge)adjacentEdges[i],distance);46.  preducessorsMap.Add((Edge)adjacentEdges[i],edge);47.  }48. }49. }50. }51.public Path getShortestPath(Vertice start ,Vertice end)52. { checkGraph();53. checkStartVerticeExits(start);54. checkEndVerticeExits(end);55. Path path = new Path();56. path.SetStartVertice(start);57. path.SetEndVertice(end);58. Edge preEdge = preducessorsMap[“END”] as Edge;59. ArrayList pathArray = new ArrayList(10);60.  pathArray.Add(preEdge);61. do62. { preEdge = preducessorsMap[preEdge] as Edge ;63. pathArray.Add(preEdge);64. }65. while(preEdge !=null && preEdge.LinkedVertice != start);66. pathArray.RemoveAt(pathArray.Count -1);67. pathArray.Reverse();68. path.viaEdges = pathArray;69. return path;70. }71. public void checkGraph()72. { if(Graph == null)73. { throw new JGXY.LBS.Route.RouteException(“Can’t find a Graph”); }74. }75. public void checkStartVerticeExits(Vertice start)76. { if(!Graph.isVertexExit(start))77. throw new JGXY.LBS.Route.RouteException(“Can’t find start vertex”);78. }79. public void checkEndVerticeExits(Vertice end)80. { if(!Graph.isVertexExit(end))81. throw new JGXY.LBS.Route.RouteException(“Can’t find end vertex”);82. }83.84. }// END CLASS DEFINITION85. public class PriorityQueue86. { Hashtable priorityQueue;87. public PriorityQueue(int verticeNumber)88. {priorityQueue = new Hashtable(verticeNumber); }89. public void Enqueue(object obj,double lenght)90. {priorityQueue[obj] = lenght;}91. public object Dequeue()92. { IDictionaryEnumerator myEnumerator = priorityQueue.GetEnumerator();93. Edge minEdge = null;94. double length = double.MaxValue;95. while(myEnumerator.MoveNext())96. {97.    if(System.Convert.ToDouble(myEnumerator.Value) < length)98. {99. length =System.Convert.ToDouble(myEnumerator.Value) ;100. minEdge = (Edge)myEnumerator.Key;101. }102. }103. priorityQueue.Remove(minEdge);104. return minEdge;105. }106. public void Clear()107. { priorityQueue.Clear(); }108. public bool IsEmpty()109. {110. if(priorityQueue.Count > 0)111. return false;112. else113. return true;114. }115. public bool Exits(object obj)116. {return priorityQueue.Contains(obj); }117. public void Reset(object obj,double lenght)118. { priorityQueue.Add(obj,lenght); }119. public double getLenght(object obj)120. {121. if(priorityQueue.ContainsKey(obj))122.  return System.Convert.ToDouble(priorityQueue[obj]);123. else124.  return double.MaxValue;125. }126. }127.}


### 3.8. RouteSearch Class

The RouteSearch class is used to calculate the shortest path between two vertices and then store the result in the Path object.The code implementation of the RouteSearch class is as follows.Pseudocode 8
1. namespace JGXY.LBS.Route2.  { public class RouteSearch3.   { private IGraph Graph;4.   private BestRoute bestroute;5.   public RouteSearch(RoadGraph graph)6.   { Graph = graph;7.   bestroute = new BestRoute(Graph);8.   }9.   public Path getShortestPath(Vertice start,Vertice end)10.   { return bestroute.getShortestPath(start,end); }11.   }// END CLASS DEFINITION RouteSearch12.  }


### 3.9. Path Class

The Path class is used to store the results of the best path algorithm. The code implementation of the Path class is as follows:Pseudocode 9
1. namespace JGXY.LBS.Route2. { public class Path3.  {4. private Vertice startVertice;5. private Vertice endVertice;6. public System.Collections.ArrayList viaEdges;7. public Path() { }8. public void SetStartVertice(object vertex)9. { startVertice = (Vertice)vertex; }10. public void SetEndVertice(object vertex)11. { endVertice = (Vertice)vertex; }12. public void AddEdge(Edge edge)13. { viaEdges.Add(edge); }14. public double GetLength()15. { double length =0;16. System.Collections.IEnumerator viaEdgesEnumerator = viaEdges.GetEnumerator();17. while(viaEdgesEnumerator.MoveNext())18. {19. length += ((Edge)viaEdgesEnumerator.Current).LinkedVertice.RoadLength;20. }21. length = length+startVertice.RoadLength-endVertice.RoadLength/2;22. return length;23. }24. public string getPathInstruction()25. { string instruction = null ;26. System.Collections.ArrayList viaEdgesReformed = new System.Collections.ArrayList(10);27. if(startVertice != null)28. viaEdgesReformed.Add(new Edge(startVertice.Clone(),Direction.RightOrLeft.Right,Direction.Orientation.North));29. else30.  return “Can’t find the best Path.”;31.32. if(viaEdges.Count>0)33. { for(int i =0 ;i< viaEdges.Count ;i++)34.  {if(((Edge)viaEdgesReformed[viaEdgesReformed.Count -1]).LinkedVertice.FatherRoad == ((Edge)viaEdges[i]).LinkedVertice.FatherRoad)35.  {((Edge)viaEdgesReformed[viaEdgesReformed.Count -1]).LinkedVertice.RoadLength += ((Edge)viaEdges[i]).LinkedVertice.RoadLength;36.  }37.  else38.  {viaEdgesReformed.Add(((Edge)viaEdges[i]).Clone());}39.  }40.    instruction += “Via ” + ((Edge)viaEdgesReformed[0]).LinkedVertice.RoadName + “, drive ” + ((Edge)viaEdgesReformed[0]).LinkedVertice.RoadLength + “ miles, ”;41.  for(int i =1 ;i < viaEdgesReformed.Count ; i++)42.  { string rol;43.  switch(((Edge)viaEdgesReformed[i]).RightOrLeft.ToString())44.   {45.46.    case “Straight”: rol = “ Keep straight,\r\n”; break;47.   case “Right”: rol = “ Turn right,\r\n”; break;48.   case “Left”: rol = “ Turn left,\r\n”; break;49.   default: rol = “ Keep straight,\r\n”; break;50.  }51.  if( i != viaEdgesReformed.Count -1)52.  {instruction += rol + “Via ” + ((Edge)viaEdgesReformed[i]).LinkedVertice.RoadName + “ drive ” + ((Edge)viaEdgesReformed[i]).LinkedVertice.RoadLength + “ miles,”; }53.  else54.  {instruction += rol + “Via ” + ((Edge)viaEdgesReformed[i]).LinkedVertice.RoadName + “ drive ” + ((Edge)viaEdgesReformed[i]).LinkedVertice.RoadLength / 2 + “ miles,Arrive at destination.”;}55. else { instruction = “Can’t find the best Path.”;}56.    return instruction;57. }58. }// END CLASS DEFINITION Path59.}


## 3.1. RoadNetworkBuilder Class

The RoadNetworkBuilder class initializes each road network object according to location and traffic type. The road network object at each location is a global object, which only needs to be initialized once.The main method of this class is described as follows:(i)
addRoadGraphToNetwork (string city, string type, RoadNetwork roadNetwork): initialize a road network object RoadNetwork according to the location and type (Car, Foot, logistics, Fly, Robot)The code implementation of the RoadNetworkBuilder class is as follows.Pseudocode 1
1. using System.Data.SqlClient;2. namespace JGXY.LBS.Route{3. public class RoadNetworkBuilder{4. public SqlConnection con;5. public RoadNetworkBuilder(SqlConnection conn)6. {this.con = conn; }7. public void addRoadGraphToNetwork(string city,string type,RoadNetwork roadNetwork) {8. string roadSql = “select∗ from ”+city+“_”+type+“Roads”;9. string wayNetworkSql = “select w.RoadID as V_RoadID,r.RoadID as E_RoadID,r.FatherRoadID as E_FatherRoadID ,r.Length as E_length,r.[Name] as E_Name,isnull(RightOrLeft,0) as RightOrLeft,isnull(Orientation,10) as Orientation” +“ from ” +city+“_”+type+“WayNetwork w left outer join ”+city+“_”+type+“Roads r on w.LinkedRoadID = r.RoadID ”;10. SqlDataAdapter roadAdp = new SqlDataAdapter(roadSql,con);11. SqlDataAdapter wayNetworkAdp = new SqlDataAdapter(wayNetworkSql,con);12. try {13. System.Data.DataSet roadData = new System.Data.DataSet();14. roadAdp.Fill(roadData);15. System.Data.DataSet edgeData = new System.Data.DataSet();16.  wayNetworkAdp.Fill(edgeData);17.  RoadGraph graph= new RoadGraph(roadData.Tables[0].Rows.Count);18.//read database initialize route network19.  foreach(System.Data.DataRow myRow in roadData.Tables[0].Rows){20.   Vertice vertex= new Vertice();21.   vertex.RoadID = myRow[“RoadID”].ToString();22.   vertex.FatherRoad = myRow[“FatherRoadID”].ToString();23.   vertex.RoadLength = System.Convert.ToDouble(myRow[“Length”].ToString());24.   vertex.RoadName = myRow[“Name”].ToString();25.   graph.addVertex(vertex);26. }27.   foreach(System.Data.DataRow row in edgeData.Tables[0].Rows){28.  Vertice vertex = new Vertice(row[“V_RoadID”].ToString());29.  Edge edge = new Edge(new Vertice(row[“E_RoadID”].ToString(),row[“E_Name”].ToString(),System.Convert.ToDouble(row[“E_Length”].ToString()),row[“E_FatherRoadID”].ToString()),(Direction.RightOrLeft)System.Enum.Parse(typeof(Direction.RightOrLeft) ,row[“RightOrLeft”].ToString()),(Direction.Orientation)System.Enum.Parse(typeof(Direction.Orientation) ,row[“Orientation”].ToString()));30.   graph.addEdge(vertex,edge);31.  }32.   roadNetwork.addRoadGraph(“RT”,“Car”,graph);}33.   catch(System.Exception e)34.   {35.   throw new Entity.LBS.Route.RouteException(e.Message);36.   }37.  }38. }// END INTERFACE DEFINITION RoadNetworkBuilder39.  }


## 3.2. RoadNetwork Class

The function of the RoadNetwork class is to store various locations and all types of road networks in the system. All types of road networks in the system are initialized only once when the system is started.The code implementation of the RoadNetwork class is as follows.Pseudocode 2
1. namespace JGXY.LBS.Route{2. public class RoadNetwork{3. public System.Collections.Hashtable NetworkHash;4.  public RoadNetwork(){5.  NetworkHash = new System.Collections.Hashtable(10);6.  }7.  public void addRoadGraph(string city,string type,IGraph graph){8.  NetworkHash.Add(city+“_”+type,graph);9.  }10.  public void deleteRoadGraph(string city,string type){11.  NetworkHash.Remove(city+“_”+type);12.  }13.  public bool isRoadGraphExist(string city,string type){14.  return NetworkHash.Contains(city+“_”+type);15.  }16.  }// END CLASS DEFINITION RoadNetwork17. }


## 3.3. IGraph Class

The IGraph class is the network graph interface of the optimal path algorithm. The interface is to realize the scalability and compatibility of the algorithm; that is, the optimal path algorithm can use any topology network graph which conforms to the interface.The code implementation of the IGraph class is as follows:Pseudocode 3
1. namespace JGXY.LBS.Route2. public interface IGraph3. {4.  bool addVertex(object vertex);5.  bool addEdge(object vertex,object edge);6.  object getVertex(object key);7.  object getAdjacentEdges(object vertex);8.  object getEdgeWeight(object edge,object type);9.  object getEdgeWeight(object startVertice,object endVertice,object type);10. bool isVertexExit(object vertex);11. System.Collections.ICollection getPredecessors(object vertex);12. int getVerticesNumber();13. }// END INTERFACE DEFINITION IGraph


## 3.4. RoadGraph Class

The RoadGraph class implements the interface of IGraph class. It saves a road network of one location and one type. The data of the road network is saved by the following format:(i)
Every road is regarded as a vertex, and the distance between the two roads is expressed by the length of the second road(ii)
All vertices (roads) are stored in the hash table. The key of the hash table is road vertex, and the value of the hash table is the set of linked road vertex of this roadThe code implementation of the RoadGraph class is as follows.Pseudocode 4
1. using System.Collections;2. namespace JGXY.LBS.Route3. { public class RoadGraph:IGraph4.  { private int VerticeNumber;5.   public Hashtable HashGraph;6.   public RoadGraph(int totalVerticesNumber)7.   { VerticeNumber = totalVerticesNumber;8.    HashGraph = new Hashtable(totalVerticesNumber,1.0f);9.   }10   public bool addVertex(object vertex)11.   {12.   if(!HashGraph.ContainsKey(vertex))13.   { ArrayList linkedEdges = new ArrayList(6);14.    HashGraph.Add(vertex,linkedEdges);15.    return true;16.    }17.   else18.    { throw new JGXY.LBS.Route.RouteException(“Vertice exits”); }19.   }20.   public bool addEdge(object vertex,object edge)21.   { if(HashGraph.ContainsKey(vertex))22.    { ArrayList linkedEdges = HashGraph[vertex] as ArrayList;23.     linkedEdges.Add(edge);24.     return true;25.    }26.    else27.    {throw new JGXY.LBS.Route.RouteException(“Vertex does not exit”);  }28.   }29.   public object getVertex(object roadID)30.   { return null;31.   }32.   public object getAdjacentEdges(object vertex)33.  { if(HashGraph.ContainsKey(vertex))34.   {ArrayList linkedEdges = HashGraph[vertex] as ArrayList;35.   ArrayList adjacentEdges = new ArrayList(6);36.   adjacentEdges.AddRange(linkedEdges);37.   return adjacentEdges;38.   }39.   else40.   { throw new JGXY.LBS.Route.RouteException(“Vertex does not exit”);}41.  }42.   public object getEdgeWeight(object edge,object type)43.   {return ((Edge)edge).LinkedVertice.RoadLength;}44.   public object getEdgeWeight(object startVertice,object endVertice,object type)45.   {return ((Vertice)endVertice).RoadLength;}46.   public bool isVertexExit(object vertex)47.   { if(HashGraph.ContainsKey(vertex))48.   return true;49.   else50.    return false;51.    }52.   public System.Collections.ICollection getPredecessors(object vertex)53.   {return null;}54.   public int getVerticesNumber()55.   {return this.VerticeNumber; }56.  }57. }// END CLASS DEFINITION RoadGraph58. }


## 3.5. Vertice Class

The function of the vertex class is to store the information of the road. Note: the Vertice class overrides the GetHashCode methods and Equals methods of the base class.(i)
Equals(object obj): the Equals method, defined by the Object class of the C# language, determines whether the specified object is equal to the current one by comparing the memory address of the two objects. So the Vertice class should override the Equals method to determine whether two Vertice objects are equal by comparing the values of the road ID(ii)
GetHashCode(): the Vertice class also overrides the GetHashCode method to generate the hash code by the value of the road IDThe code implementation of the Vertice class is as follows.Pseudocode 5
1. namespace JGXY.LBS.Route2. {3. public class Vertice4. { public string RoadID;5. public string RoadName;6. public double RoadLength;7. public string FatherRoad;8. public Vertice()9. { }10. public Vertice(string roadID)11. { RoadID = roadID; }12. public Vertice(string roadID,string roadName,double roadLength,string fatherRoad)13. { RoadID = roadID;14. RoadName = roadName;15. RoadLength = roadLength;16. FatherRoad = fatherRoad;17. }18. public override int GetHashCode()19. {return RoadID.GetHashCode();}20. public override bool Equals(object obj)21. { if(this.RoadID == ((Vertice)obj).RoadID)22. return true;23. else24.  return false;25. }26. public Vertice Clone()27. { return new Vertice(RoadID,RoadName,RoadLength,FatherRoad); }28. }// END CLASS DEFINITION vertice29.}


## 3.6. Edges Class

Edges class is a linked edge class, used to store the linked way of each road.The code implementation of the Edges class is as follows:Pseudocode 6
1. namespace JGXY.LBS.Route2. {3. public class Edge4. {5. public Vertice LinkedVertice;6. public Direction.RightOrLeft RightOrLeft;7. public Direction.Orientation Orientation;8. public Edge(Vertice vertice,Direction.RightOrLeft rightOrLeft,Direction.Orientation orientation)9. { LinkedVertice = vertice;10. RightOrLeft = rightOrLeft;11. Orientation = orientation;12. }13. public override int GetHashCode()14. { return LinkedVertice.RoadID.GetHashCode(); }15. public override bool Equals(object obj)16. { if(this.LinkedVertice.RoadID == ((Edge)obj).LinkedVertice.RoadID)17.  return true;18. else19.  return false;20. }21. public Edge Clone()22. {return new Edge(LinkedVertice.Clone(),RightOrLeft,Orientation); }23. }// END CLASS DEFINITION Edge24.}


## 3.7. BestRoute Class

The BestRoute class that can implement the shortest path algorithm is used to compute the shortest path between two vertices.The code implementation of the BestRoute class is as follows.Pseudocode 7
1. using System.Collections;2. namespace JGXY.LBS.Route3. { public class BestRoute4. { public IGraph Graph;5. private PriorityQueue priorityQueue;6. private Hashtable determinedEdges;7. private Hashtable shortestPathMap;8. private Hashtable preducessorsMap;9. public BestRoute(IGraph graph)10. { this.Graph = graph;11. int verticeNumber = graph.getVerticesNumber();12. priorityQueue = new PriorityQueue(verticeNumber);13. determinedEdges = new Hashtable(verticeNumber);14. shortestPathMap = new Hashtable(verticeNumber);15. preducessorsMap = new Hashtable(verticeNumber);16. }17. public void run(object sourceVertex,object destinationVertex)18. { priorityQueue.Clear();19. determinedEdges.Clear();20. determinedEdges.Add(new Edge((Vertice)sourceVertex,Direction.RightOrLeft.Straight,Direction.Orientation.North),0);21. ArrayList adjacentEdges = (ArrayList)Graph.getAdjacentEdges(sourceVertex);22. for(int i =0; i <adjacentEdges.Count;i++)23. { priorityQueue.Enqueue(adjacentEdges[i],((Edge)adjacentEdges[i]).LinkedVertice.RoadLength);24. shortestPathMap.Add((Edge)adjacentEdges[i],((Edge)adjacentEdges[i]).LinkedVertice.RoadLength);25. preducessorsMap.Add((Edge)adjacentEdges[i], new26.    Edge((Vertice)sourceVertex,Direction.RightOrLeft.Straight,Direction.Orientation.North));27. }28. while(!priorityQueue.IsEmpty())29. { Edge minEdge = (Edge)priorityQueue.Dequeue();30. if(minEdge.LinkedVertice.Equals(destinationVertex))31. { preducessorsMap.Add(“END”,minEdge);32. break;33.  }34.   determinedEdges.Add(minEdge,null);35.  relax(minEdge);36.  }37. }38. public void relax(object edge)39. { ArrayList adjacentEdges = (ArrayList)Graph.getAdjacentEdges(((Edge)edge).LinkedVertice);40. for(int i =0; i <adjacentEdges.Count;i++)41. { if(!determinedEdges.Contains(adjacentEdges[i]))42.  { double distance = System.Convert.ToDouble(shortestPathMap[edge]) + ((Edge)adjacentEdges[i]).LinkedVertice.RoadLength;43.  if(distance < priorityQueue.getLenght(adjacentEdges[i]))44.  { priorityQueue.Enqueue(adjacentEdges[i],distance);45.  shortestPathMap.Add((Edge)adjacentEdges[i],distance);46.  preducessorsMap.Add((Edge)adjacentEdges[i],edge);47.  }48. }49. }50. }51.public Path getShortestPath(Vertice start ,Vertice end)52. { checkGraph();53. checkStartVerticeExits(start);54. checkEndVerticeExits(end);55. Path path = new Path();56. path.SetStartVertice(start);57. path.SetEndVertice(end);58. Edge preEdge = preducessorsMap[“END”] as Edge;59. ArrayList pathArray = new ArrayList(10);60.  pathArray.Add(preEdge);61. do62. { preEdge = preducessorsMap[preEdge] as Edge ;63. pathArray.Add(preEdge);64. }65. while(preEdge !=null && preEdge.LinkedVertice != start);66. pathArray.RemoveAt(pathArray.Count -1);67. pathArray.Reverse();68. path.viaEdges = pathArray;69. return path;70. }71. public void checkGraph()72. { if(Graph == null)73. { throw new JGXY.LBS.Route.RouteException(“Can’t find a Graph”); }74. }75. public void checkStartVerticeExits(Vertice start)76. { if(!Graph.isVertexExit(start))77. throw new JGXY.LBS.Route.RouteException(“Can’t find start vertex”);78. }79. public void checkEndVerticeExits(Vertice end)80. { if(!Graph.isVertexExit(end))81. throw new JGXY.LBS.Route.RouteException(“Can’t find end vertex”);82. }83.84. }// END CLASS DEFINITION85. public class PriorityQueue86. { Hashtable priorityQueue;87. public PriorityQueue(int verticeNumber)88. {priorityQueue = new Hashtable(verticeNumber); }89. public void Enqueue(object obj,double lenght)90. {priorityQueue[obj] = lenght;}91. public object Dequeue()92. { IDictionaryEnumerator myEnumerator = priorityQueue.GetEnumerator();93. Edge minEdge = null;94. double length = double.MaxValue;95. while(myEnumerator.MoveNext())96. {97.    if(System.Convert.ToDouble(myEnumerator.Value) < length)98. {99. length =System.Convert.ToDouble(myEnumerator.Value) ;100. minEdge = (Edge)myEnumerator.Key;101. }102. }103. priorityQueue.Remove(minEdge);104. return minEdge;105. }106. public void Clear()107. { priorityQueue.Clear(); }108. public bool IsEmpty()109. {110. if(priorityQueue.Count > 0)111. return false;112. else113. return true;114. }115. public bool Exits(object obj)116. {return priorityQueue.Contains(obj); }117. public void Reset(object obj,double lenght)118. { priorityQueue.Add(obj,lenght); }119. public double getLenght(object obj)120. {121. if(priorityQueue.ContainsKey(obj))122.  return System.Convert.ToDouble(priorityQueue[obj]);123. else124.  return double.MaxValue;125. }126. }127.}


## 3.8. RouteSearch Class

The RouteSearch class is used to calculate the shortest path between two vertices and then store the result in the Path object.The code implementation of the RouteSearch class is as follows.Pseudocode 8
1. namespace JGXY.LBS.Route2.  { public class RouteSearch3.   { private IGraph Graph;4.   private BestRoute bestroute;5.   public RouteSearch(RoadGraph graph)6.   { Graph = graph;7.   bestroute = new BestRoute(Graph);8.   }9.   public Path getShortestPath(Vertice start,Vertice end)10.   { return bestroute.getShortestPath(start,end); }11.   }// END CLASS DEFINITION RouteSearch12.  }


## 3.9. Path Class

The Path class is used to store the results of the best path algorithm. The code implementation of the Path class is as follows:Pseudocode 9
1. namespace JGXY.LBS.Route2. { public class Path3.  {4. private Vertice startVertice;5. private Vertice endVertice;6. public System.Collections.ArrayList viaEdges;7. public Path() { }8. public void SetStartVertice(object vertex)9. { startVertice = (Vertice)vertex; }10. public void SetEndVertice(object vertex)11. { endVertice = (Vertice)vertex; }12. public void AddEdge(Edge edge)13. { viaEdges.Add(edge); }14. public double GetLength()15. { double length =0;16. System.Collections.IEnumerator viaEdgesEnumerator = viaEdges.GetEnumerator();17. while(viaEdgesEnumerator.MoveNext())18. {19. length += ((Edge)viaEdgesEnumerator.Current).LinkedVertice.RoadLength;20. }21. length = length+startVertice.RoadLength-endVertice.RoadLength/2;22. return length;23. }24. public string getPathInstruction()25. { string instruction = null ;26. System.Collections.ArrayList viaEdgesReformed = new System.Collections.ArrayList(10);27. if(startVertice != null)28. viaEdgesReformed.Add(new Edge(startVertice.Clone(),Direction.RightOrLeft.Right,Direction.Orientation.North));29. else30.  return “Can’t find the best Path.”;31.32. if(viaEdges.Count>0)33. { for(int i =0 ;i< viaEdges.Count ;i++)34.  {if(((Edge)viaEdgesReformed[viaEdgesReformed.Count -1]).LinkedVertice.FatherRoad == ((Edge)viaEdges[i]).LinkedVertice.FatherRoad)35.  {((Edge)viaEdgesReformed[viaEdgesReformed.Count -1]).LinkedVertice.RoadLength += ((Edge)viaEdges[i]).LinkedVertice.RoadLength;36.  }37.  else38.  {viaEdgesReformed.Add(((Edge)viaEdges[i]).Clone());}39.  }40.    instruction += “Via ” + ((Edge)viaEdgesReformed[0]).LinkedVertice.RoadName + “, drive ” + ((Edge)viaEdgesReformed[0]).LinkedVertice.RoadLength + “ miles, ”;41.  for(int i =1 ;i < viaEdgesReformed.Count ; i++)42.  { string rol;43.  switch(((Edge)viaEdgesReformed[i]).RightOrLeft.ToString())44.   {45.46.    case “Straight”: rol = “ Keep straight,\r\n”; break;47.   case “Right”: rol = “ Turn right,\r\n”; break;48.   case “Left”: rol = “ Turn left,\r\n”; break;49.   default: rol = “ Keep straight,\r\n”; break;50.  }51.  if( i != viaEdgesReformed.Count -1)52.  {instruction += rol + “Via ” + ((Edge)viaEdgesReformed[i]).LinkedVertice.RoadName + “ drive ” + ((Edge)viaEdgesReformed[i]).LinkedVertice.RoadLength + “ miles,”; }53.  else54.  {instruction += rol + “Via ” + ((Edge)viaEdgesReformed[i]).LinkedVertice.RoadName + “ drive ” + ((Edge)viaEdgesReformed[i]).LinkedVertice.RoadLength / 2 + “ miles,Arrive at destination.”;}55. else { instruction = “Can’t find the best Path.”;}56.    return instruction;57. }58. }// END CLASS DEFINITION Path59.}


## 4. Test and Results of the Road Path Search System

### 4.1. Test Road Network of the Road Path Search System

In this paper, the test road network as shown in Figure3 is used to test the system. The location of the road network is set to XM city, and the road network is a car drive network.Figure 3
Test road network diagram.


### 4.2. Test Database of the Road Path Search System

According to the test road network diagram in Figure3, we initialize the data in the following test database tables in XM city. The name of the database is Route, the database login user is “sa2,” and the database login password is “sa123[].”


#### 4.2.1. The Test Data Initialization of the Road Network Topology Table

We initialize the test data of the road network topology table XM_CarWayNetwork in XM city as shown in Table3, which realizes the road network topology of Figure 3.Table 3
Test data of the road network topology table.
WINDOWS-2S8TAV..._CarWayNetworkConnectionIDRoadIDLinkedRoadIDRightOrLeftOrientation918142111012200121113191121220222111322230111419232111521242111623240111718190121111211221213211311150114131401151421112615160137161711281518112


#### 4.2.2. The Test Data Initialization of the Road Information Table

According to the test road network diagram in Figure3, we initialize the test data of the road information table named XM_CarNetwork that realizes the road network topology in Figure 3. The table XM_CarNetwork is used for car driving of XM city, as shown in Table 4 below.Table 4
Test data of the road information table.
WINDOWS-2S8TAV...dbo.XM_CarRoadsRoadIDLengthNameFatherRoadID20800Road No. 202021700Road No. 2121221100Road No. 2222231300Road No. 2323242000Road No. 2424111000Road No. 1111121000Road No. 1212131000Road No. 1313141050Road No. 1414151050Road No. 1515161200Road No. 161617900Road No. 171718800Road No. 181819750Road No. 1919


### 4.3. Test Program and Running Results

#### 4.3.1. Test Program

Under the principle of system design and implementation, test program is written based on the test data to test the road network path search system. The test program sets the starting point at the midpoint of Road No. 11 and the ending point at the midpoint of Road No. 24. The code of test program is as follows.Pseudocode 10
1. using System;2. using System.Collections.Generic;3. using System.Linq;4. using System.Text;5. using System.Data.SqlClient;6. using JGXY.LBS.Route;7. namespace TestRouteConsole8. {  class Program9.  {10.   static void Main(string[] args)11.   { try12.    { RoadNetwork rn = new RoadNetwork();13.     SqlConnection conn = new SqlConnection(“database=Route;server=localhost;user = sa2; password =sa123[];Connect Timeout=30”);14.     RoadNetworkBuilder rnb = new RoadNetworkBuilder(conn);15.     rnb.addRoadGraphToNetwork(“XM”, “Car”, rn);16.     Vertice start = new Vertice(“11”, “Road No.11”, 500, “11”);17.     Vertice end = new Vertice(“24”, “Road No.24”, 1000, “24”);18.     RouteSearch routeSearch = new RouteSearch((RoadGraph)rn.NetworkHash[“RT_Car”]);19.     Path path = routeSearch.getShortestPath(start, end);20.     Console.WriteLine(“Total path length:” + path.GetLength().ToString() + “Meters ”);21.     Console.WriteLine(“Best path navigation:” + path.getPathInstruction());22.     Console.Read();23.    }24.    catch (Exception ex)25.    { Console.WriteLine(ex.Message);  }26.   }27.  }28. }


#### 4.3.2. Running Results of the Test Program

The result of running the test program is shown in Figure4. The system calculates the total length of the best path, returns the correct car navigation instructions, and concludes that the total length of the shortest path is 5600 meters, and the road sequence is No. 11, No. 15, No. 18, No. 14, No. 21, and No. 24.Figure 4
The running results of the test program.According to the car navigation instructions of the test program, we blacken the related roads to get the best path diagram shown in Figure5, which proves that the optimal path computed by the road network path search system is correct.Figure 5
The optimal path diagram.


## 4.1. Test Road Network of the Road Path Search System

In this paper, the test road network as shown in Figure3 is used to test the system. The location of the road network is set to XM city, and the road network is a car drive network.Figure 3
Test road network diagram.


## 4.2. Test Database of the Road Path Search System

According to the test road network diagram in Figure3, we initialize the data in the following test database tables in XM city. The name of the database is Route, the database login user is “sa2,” and the database login password is “sa123[].”


### 4.2.1. The Test Data Initialization of the Road Network Topology Table

We initialize the test data of the road network topology table XM_CarWayNetwork in XM city as shown in Table3, which realizes the road network topology of Figure 3.Table 3
Test data of the road network topology table.
WINDOWS-2S8TAV..._CarWayNetworkConnectionIDRoadIDLinkedRoadIDRightOrLeftOrientation918142111012200121113191121220222111322230111419232111521242111623240111718190121111211221213211311150114131401151421112615160137161711281518112


### 4.2.2. The Test Data Initialization of the Road Information Table

According to the test road network diagram in Figure3, we initialize the test data of the road information table named XM_CarNetwork that realizes the road network topology in Figure 3. The table XM_CarNetwork is used for car driving of XM city, as shown in Table 4 below.Table 4
Test data of the road information table.
WINDOWS-2S8TAV...dbo.XM_CarRoadsRoadIDLengthNameFatherRoadID20800Road No. 202021700Road No. 2121221100Road No. 2222231300Road No. 2323242000Road No. 2424111000Road No. 1111121000Road No. 1212131000Road No. 1313141050Road No. 1414151050Road No. 1515161200Road No. 161617900Road No. 171718800Road No. 181819750Road No. 1919


## 4.2.1. The Test Data Initialization of the Road Network Topology Table

We initialize the test data of the road network topology table XM_CarWayNetwork in XM city as shown in Table3, which realizes the road network topology of Figure 3.Table 3
Test data of the road network topology table.
WINDOWS-2S8TAV..._CarWayNetworkConnectionIDRoadIDLinkedRoadIDRightOrLeftOrientation918142111012200121113191121220222111322230111419232111521242111623240111718190121111211221213211311150114131401151421112615160137161711281518112


## 4.2.2. The Test Data Initialization of the Road Information Table

According to the test road network diagram in Figure3, we initialize the test data of the road information table named XM_CarNetwork that realizes the road network topology in Figure 3. The table XM_CarNetwork is used for car driving of XM city, as shown in Table 4 below.Table 4
Test data of the road information table.
WINDOWS-2S8TAV...dbo.XM_CarRoadsRoadIDLengthNameFatherRoadID20800Road No. 202021700Road No. 2121221100Road No. 2222231300Road No. 2323242000Road No. 2424111000Road No. 1111121000Road No. 1212131000Road No. 1313141050Road No. 1414151050Road No. 1515161200Road No. 161617900Road No. 171718800Road No. 181819750Road No. 1919


## 4.3. Test Program and Running Results

### 4.3.1. Test Program

Under the principle of system design and implementation, test program is written based on the test data to test the road network path search system. The test program sets the starting point at the midpoint of Road No. 11 and the ending point at the midpoint of Road No. 24. The code of test program is as follows.Pseudocode 10
1. using System;2. using System.Collections.Generic;3. using System.Linq;4. using System.Text;5. using System.Data.SqlClient;6. using JGXY.LBS.Route;7. namespace TestRouteConsole8. {  class Program9.  {10.   static void Main(string[] args)11.   { try12.    { RoadNetwork rn = new RoadNetwork();13.     SqlConnection conn = new SqlConnection(“database=Route;server=localhost;user = sa2; password =sa123[];Connect Timeout=30”);14.     RoadNetworkBuilder rnb = new RoadNetworkBuilder(conn);15.     rnb.addRoadGraphToNetwork(“XM”, “Car”, rn);16.     Vertice start = new Vertice(“11”, “Road No.11”, 500, “11”);17.     Vertice end = new Vertice(“24”, “Road No.24”, 1000, “24”);18.     RouteSearch routeSearch = new RouteSearch((RoadGraph)rn.NetworkHash[“RT_Car”]);19.     Path path = routeSearch.getShortestPath(start, end);20.     Console.WriteLine(“Total path length:” + path.GetLength().ToString() + “Meters ”);21.     Console.WriteLine(“Best path navigation:” + path.getPathInstruction());22.     Console.Read();23.    }24.    catch (Exception ex)25.    { Console.WriteLine(ex.Message);  }26.   }27.  }28. }


### 4.3.2. Running Results of the Test Program

The result of running the test program is shown in Figure4. The system calculates the total length of the best path, returns the correct car navigation instructions, and concludes that the total length of the shortest path is 5600 meters, and the road sequence is No. 11, No. 15, No. 18, No. 14, No. 21, and No. 24.Figure 4
The running results of the test program.According to the car navigation instructions of the test program, we blacken the related roads to get the best path diagram shown in Figure5, which proves that the optimal path computed by the road network path search system is correct.Figure 5
The optimal path diagram.


## 4.3.1. Test Program

Under the principle of system design and implementation, test program is written based on the test data to test the road network path search system. The test program sets the starting point at the midpoint of Road No. 11 and the ending point at the midpoint of Road No. 24. The code of test program is as follows.Pseudocode 10
1. using System;2. using System.Collections.Generic;3. using System.Linq;4. using System.Text;5. using System.Data.SqlClient;6. using JGXY.LBS.Route;7. namespace TestRouteConsole8. {  class Program9.  {10.   static void Main(string[] args)11.   { try12.    { RoadNetwork rn = new RoadNetwork();13.     SqlConnection conn = new SqlConnection(“database=Route;server=localhost;user = sa2; password =sa123[];Connect Timeout=30”);14.     RoadNetworkBuilder rnb = new RoadNetworkBuilder(conn);15.     rnb.addRoadGraphToNetwork(“XM”, “Car”, rn);16.     Vertice start = new Vertice(“11”, “Road No.11”, 500, “11”);17.     Vertice end = new Vertice(“24”, “Road No.24”, 1000, “24”);18.     RouteSearch routeSearch = new RouteSearch((RoadGraph)rn.NetworkHash[“RT_Car”]);19.     Path path = routeSearch.getShortestPath(start, end);20.     Console.WriteLine(“Total path length:” + path.GetLength().ToString() + “Meters ”);21.     Console.WriteLine(“Best path navigation:” + path.getPathInstruction());22.     Console.Read();23.    }24.    catch (Exception ex)25.    { Console.WriteLine(ex.Message);  }26.   }27.  }28. }


## 4.3.2. Running Results of the Test Program

The result of running the test program is shown in Figure4. The system calculates the total length of the best path, returns the correct car navigation instructions, and concludes that the total length of the shortest path is 5600 meters, and the road sequence is No. 11, No. 15, No. 18, No. 14, No. 21, and No. 24.Figure 4
The running results of the test program.According to the car navigation instructions of the test program, we blacken the related roads to get the best path diagram shown in Figure5, which proves that the optimal path computed by the road network path search system is correct.Figure 5
The optimal path diagram.


## 5. Discussion

The road network path search system is widely used today. This paper designs a complete software architecture of the road network path search system through the comprehensive use of database, programming language, shortest path algorithm, UML language, software design pattern, and other methods and realizes the complete function of the system by Microsoft C#.NET programming language.The system architecture designed in this paper has good scalability, flexibility, and pluggability. The code of the system uses Dijkstra as the shortest path search algorithm. If you want to use other shortest algorithms, you can replace the code of BestRoute class without affecting the design and function of the entire system.According to the test program result, we can search the road network by the system designed in this paper to get the best route navigation information.The system can be deployed on Microsoft Windows operation systems or a cloud server. Based on the map display and GPS functions of the GIS system, our system can realize the function of real-time map navigation.The system can also be used as a path search module for UAVs, self-driving cars, logistics robots, and other applications to realize the path finding function. Furthermore, cooperating with the GPS, infrared equipment, sensors, cameras, and other devices, our system can be used to realize the automatic navigation function of the machine.The future work is to enable this system to support more platforms and application scenarios, compatible with more computer languages, so as to improve the efficiency of the algorithm, and support more shortest path algorithms.


## 6. Conclusion

This paper investigates the architecture design and code implementation of the road network path search system, including system function design, database design and implementation, UML design, code implementation, application method, and system test. The system completely and reliably implements the function of road network path search. Moreover, the system can be studied as a software prototype and its architecture design and code can be applied to various GIS, GPS, robots, unmanned aerial vehicles, logistics robots, and other systems that require path search function.



---

*Source: 4235523-2022-05-26.xml*