Hide Table of Contents
esri
esri/arcgis
esri/dijit
esri/dijit/analysis
esri/dijit/geoenrichment
esri/dijit/geoenrichment/ReportPlayer
esri/geometry
esri/layers
esri/renderers
esri/symbols
esri/tasks
esri/tasks/datareviewer
esri/tasks/geoenrichment
esri/tasks/locationproviders
Class: RouteTask
[ AMD Module Require | Legacy Module Require ]
require(["esri/tasks/RouteTask"], function(RouteTask) { /* code goes here */ });
Description
(Added at v1.4)
The ArcGIS JavaScript API's RouteTask allows you to find routes between two or more locations and optionally get driving directions. The RouteTask uses ArcGIS Server network analysis services to calculate routes. Network analysis services allow you to solve simple routing problems as well as complex ones that take into account multiple stops, barriers, and time windows.
NOTE: For a more updated approach to working with directions, please see the Working with the Directions Widget topic. This widget encompasses routing functionality that used to only be available via the RouteTask. It now takes much of this functionality and wraps it up into a widget making it easier to consume and use.
The following links provides additional information:
The basic pattern to work with this task is:
- Create the task
- Configure the parameters
- Solve the route and then specify what to do with its results and handle any errors that may be returned.
Samples
Search for samples that use this class.Constructors
| Name | Summary |
|---|---|
| new RouteTask(url) | Creates a new RouteTask object. |
Properties
| Name | Type | Summary |
|---|---|---|
| url | String | URL to the ArcGIS Server REST resource that represents a network analysis service. |
Methods
| Name | Return type | Summary |
|---|---|---|
| getServiceDescription() | Object | Returns an object describing a Route service endpoint (URL of the endpoint is specified in the constructor). |
| solve(params, callback?, errback?) | Deferred | Solves the route against the route layer with the route parameters. |
Events
[ On Style Events | Connect Style Event ]
All On Style event listeners receive a single event object. Additionally, the event object also contains a 'target' property whose value is the object which fired the event.
Events
| Name | Event Object | Summary |
|---|---|---|
| error | {
error: < | Fires when an error occurs when executing the task. |
| solve-complete | {
result: < | Fires when RouteTask.solve() has completed. |
Constructor Details
Creates a new RouteTask object.
Parameters:
< |
Required | URL to the ArcGIS Server REST resource that represents a network analysis service. To obtain the URL, use Services Directory. |
Sample:
require([
"esri/tasks/RouteTask", ...
], function(RouteTask, ... ) {
var routeTask = new RouteTask("https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World");
...
});
Property Details
<String
StringURL to the ArcGIS Server REST resource that represents a network analysis service. To obtain the URL, use Services Directory.
Method Details
Returns an object describing a Route service endpoint (URL of the endpoint is specified in the constructor). The description contains information about the default solver settings, underlying network dataset, available cost and restriction attributes, supported travel modes, etc. If the targeted Network Analyst Server is federated with a Portal or ArcGIS Online, the returned
supportedTravelModes array will include user-specific travel modes. If the Network Analyst Server works in a standalone configuration, the supportedTravelModes will come from the original Closest Facility service description. A few properties returned in this object include:
(Added at v3.14)attributeParameterValues, impedance, restrictUTurns, restrictions, supportedTravelModes, travelDirection, and useHierarchy.Return type:
ObjectSolves the route against the route layer with the route parameters.
Return type:
DeferredParameters:
< |
Required | Route parameters used as input to generate the route. |
< |
Optional | The function to call when the method has completed. The arguments in the function are the same as the onSolveComplete event. |
< |
Optional | An error object is returned if an error occurs during task execution. |
Sample:
require([
"esri/tasks/RouteParameters", "esri/tasks/FeatureSet", "esri/SpatialReference",
"esri/units", "dojo/_base/connect", ...
], function(RouteParameters, FeatureSet, SpatialReference, Units, connect, ... ) {
var routeParams = new RouteParameters();
routeParams.stops = new FeatureSet();
routeParams.returnRoutes = false;
routeParams.returnDirections = true;
routeParams.directionsLengthUnits = Units.MILES;
routeParams.outSpatialReference = new SpatialReference({ wkid:102100 });
connect.connect(routeTask, "onSolveComplete", showRoute);
...
});
See also: on("solve-complete")
Event Details
[ On Style Events | Connect Style Event ]
Fires when an error occurs when executing the task. Should be used in favor of onError. (Added at v3.5)
Event Object Properties:
< |
Error message returned in a JavaScript error object. |
Fires when RouteTask.solve() has completed. Should be used in favor of onSolveComplete. (Added at v3.5)
Event Object Properties:
< |
See the object specifications table below for properties of the result object. |
Object Specifications:
<
result>< |
Array of graphics representing the polyline barriers. Barriers are returned only if RouteParameters.returnBarriers is true. For the list of attributes returned for each barrier, see the documentation on barriers. |
< |
Message received when solve is completed. If a route cannot be solved, the message returned by the server identifies the route that could not be solved. |
< |
Array of graphics representing the polygon barriers. Barriers are returned only if RouteParameters.returnBarriers is true. |
< |
Array of graphics representing the polyline barriers. Barriers are returned only if RouteParameters.returnBarriers is true. |
< |
Array of route results. |
Sample:
function showRoute(evt) {
var solveResult = evt.result;
var routeResults = solveResult.routeResults;
var barriers = solveResult.barriers;
var polygonBarriers = solveResult.polygonBarriers;
var polylineBarriers = solveResult.polylineBarriers;
var messages = solveResult.messages;
...
}