Route

Explore in the sandboxView live

This sample demonstrates the simplest use of route for finding a route between two points. Click the map to add stops to the route. When you've added two stops a route will be calculated. Adding subsequent stops extends the route.

When working with route, you set up RouteParameters, such as the stops, then call the route.solve() method when you're ready to find the route.

How it works

The routing service requires a token for authentication. This sample uses an apiKey to authenticate. You can either replace it with your own apiKey, or remove it and log in once prompted. Alternatively, you can use another authentication method to access the routing service.

The apiKey is defined in the RouteParameters to access the routing service.

                                                                                                                             
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="initial-scale=1,maximum-scale=1,user-scalable=no" />
    <title>Route | Sample | ArcGIS API for JavaScript 4.21</title>
    <style>
      html,
      body,
      #viewDiv {
        padding: 0;
        margin: 0;
        height: 100%;
        width: 100%;
      #paneDiv {
        position: absolute;
        top: 10px;
        left: 62px;
        padding: 0 12px 0 12px;
        background-color: rgba(0, 0, 0, 0.5);
        color: white;
    </style>

    <link rel="stylesheet" href="https://js.arcgis.com/4.21/esri/themes/light/main.css" />
    <script src="https://js.arcgis.com/4.21/"></script>

    <script>
      require([
        "esri/Map",
        "esri/views/MapView",
        "esri/Graphic",
        "esri/layers/GraphicsLayer",
        "esri/rest/route",
        "esri/rest/support/RouteParameters",
        "esri/rest/support/FeatureSet"
      ], function(Map, MapView, Graphic, GraphicsLayer, route, RouteParameters, FeatureSet) {
        // Point the URL to a valid routing service
        const routeUrl = "https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World";
        // The stops and route result will be stored in this layer
        const routeLayer = new GraphicsLayer();
        // Setup the route parameters
        const routeParams = new RouteParameters({
          // An authorization string used to access the routing service
          apiKey: "YOUR_API_KEY",
          stops: new FeatureSet(),
          outSpatialReference: {
            // autocasts as new SpatialReference()
            wkid: 3857
          }
        });
        // Define the symbology used to display the stops
        const stopSymbol = {
          type: "simple-marker", // autocasts as new SimpleMarkerSymbol()
          style: "cross",
          size: 15,
          outline: {
            // autocasts as new SimpleLineSymbol()
            width: 4
        // Define the symbology used to display the route
        const routeSymbol = {
          type: "simple-line", // autocasts as SimpleLineSymbol()
          color: [0, 0, 255, 0.5],
          width: 5
        const map = new Map({
          basemap: "streets-navigation-vector",
          layers: [routeLayer] // Add the route layer to the map
        const view = new MapView({
          container: "viewDiv", // Reference to the scene div created in step 5
          map: map, // Reference to the map object created before the scene
          center: [-117.195, 34.057],
          zoom: 13
        // Adds a graphic when the user clicks the map. If 2 or more points exist, route is solved.
        view.on("click", addStop);
        function addStop(event) {
          // Add a point at the location of the map click
          const stop = new Graphic({
            geometry: event.mapPoint,
            symbol: stopSymbol
          // Execute the route if 2 or more stops are input
          if (routeParams.stops.features.length >= 2) {
        // Adds the solved route to the map as a graphic
        function showRoute(data) {
          const routeResult = data.routeResults[0].route;
    </script>
  </head>
  <body>
    <div id="viewDiv"></div>
    <div id="paneDiv" class="esri-widget">
      <div>
        <p>
          Click on the map to add stops to the route. The route from the last stop to the newly added stop is
          calculated. If a stop is not reachable, then the last valid point is set as the starting point.
        </p>
      </div>
    </div>
  </body>
</html>

When the map is clicked, an event listener calls the function addStop(), which adds a SimpleMarkerSymbol at the location of the click as a stop. The function also add the point as stop in Route Parameter and check if 2 or more exists, route is solved by calling route.solve function and then pass the RouteParameter to the solve function.

          
1
2
3
4
5
6
7
8
9
10
function addStop(event) {
  const stop = new Graphic(event.mapPoint, stopSymbol);
  graphicsLayer.add(stop);
  routeParams.stops.features.push(stop);

  if (routeParams.stops.features.length >= 2) {
    route.solve(routeUrl, routeParams).then(showRoute);
    lastStop = routeParams.stops.features.splice(0, 1)[0];
  }
}

The solve method returns a promise which can be used with the .then() method to define a callback, in this case showRoute.

 
1
route.solve(routeUrl, routeParams).then(showRoute);

The showRoute callback function obtains the routeResult stored within the result object, and the apply the SimpleLineSymbol for the route result symbology, then add the RouteResult to the map by adding it to graphic layer.

     
1
2
3
4
5
function showRoute(data) {
  const routeResult = data.routeResults[0].route;
  routeResult.symbol = routeSymbol;
  graphicsLayer.add(routeResult);
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.