Using the routing service
Your routing app can do things like:
- Calculate point-to-point and multi- stop
A stop is a single point along a route: it can be the origin, an intermediate stop, or destination. routesA route is a polyline that defines the best path between two or more points in a street network. - Optimize the results to find the shortest or the fastest route
- Find the best sequence between stops
A stop is a single point along a route: it can be the origin, an intermediate stop, or destination. - Create routes based on the travel mode
A travel mode is the means of transportation, such as walking or driving, that defines how you can travel in a street network. (driving, cycling, walking, and so on) - Avoid restricted areas and maneuvers
- Specify time windows of arrival and departure for each stop
A stop is a single point along a route: it can be the origin, an intermediate stop, or destination. - Generate driving directions in multiple languages
What is routing?
Routing is the process of finding the best path between two or more stops
In addition to the routing described above, functionality is provided to analyze street networks. This includes the ability to create service areas
Directions
If requested, directions are returned for each route
Directions are composed of maneuvers. Each maneuver contains properties such as the direction text, which contains instructions that describe travel through a section of a route
If supported by the service
Navigation
The navigation API allows you to further enhance the routing experience using the current device location
The route tracker object provides the following functionality using the current device location
- Progress information relative to the next stop
A stop is a single point along a route: it can be the origin, an intermediate stop, or destination. , to the next maneuver, or along the entire route - Guidance for navigation as it’s needed (when approaching a maneuver, for example)
- Automatic recalculation of a route
A route is a polyline that defines the best path between two or more points in a street network. if the device locationA location is a position or region (point, line, or polygon) on the earth's surface. goes off route
How routing works
Online and local routing both rely on a transportation network to model travel. These networks are created from features
Network Analyst services
You can create a transportation network using ArcGIS Pro.mmpk), a mobile scene package.mspk), or a mobile geodatabase
If you’d like a ready-to-use and regularly updated network dataset (and locator
Route task
A route task is a network analysis task that is executed asynchronously
The RouteTask refers to the local transportation network dataset or online service. If solves a Route using the configured RouteParameters and reports the RouteResult.
// Create a RouteTask from an online route service var routeTask = await RouteTask.CreateAsync(new Uri( "https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World"));Route parameters
Route task parameters specify how a route
To initially create RouteParameters, call RouteTask.makeDefaultParameters() to retrieve the default routing parameters defined for the service. You can then change individual route parameters as needed before executing the RouteTask. The service’s default parameters typically support the most common use case anticipated for that service. Different services can have different defaults.
// Get the route services default parameters var routeParameters = await routeTask.CreateDefaultParametersAsync();
// Create a list of stops using the graphic's geometry (points) var stops = new[] { new Stop((MapPoint)originGraphic.Geometry), new Stop((MapPoint)intermediateStopGraphic.Geometry), new Stop((MapPoint)destinationGraphic.Geometry) }; // Add the stops to the route parameters routeParameters.SetStops(stops);
// Return driving directions in Spanish routeParameters.ReturnDirections = true; routeParameters.DirectionsLanguage = "es";Route results
The results returned from finding a route
// Solve the route using the route parameters var routeResult = await routeTask.SolveRouteAsync(routeParameters); // If a result is returned, display the route if (routeResult?.Routes?.FirstOrDefault() is Route route) { // Show the route as a graphic in the map view var routeGraphic = new Graphic(route.RouteGeometry); _routeOverlay.Graphics.Add(routeGraphic); // Get the driving directions var directions = string.Join("\n", route.DirectionManeuvers.Select(maneuver => maneuver.DirectionText)); DirectionsTextBlock.Text = directions; }Examples
Find a route and directions
Use the routing service
To find a route, you need to define at least two stops to visit. The default travel mode
The result contains a set of ordered stops
72 collapsed lines
using Esri.ArcGISRuntime.Geometry;using Esri.ArcGISRuntime.Mapping;using Esri.ArcGISRuntime.Symbology;using Esri.ArcGISRuntime.Tasks.NetworkAnalysis;using Esri.ArcGISRuntime.UI;using System;using System.Linq;using System.Threading.Tasks;
namespace ArcGISRuntime.DevGuide.Topics.RoutingIntroduction;
public partial class RoutingIntroduction{ private GraphicsOverlay _routeOverlay; private GraphicsOverlay _stopsOverlay;
public RoutingIntroduction() { InitializeComponent(); SetupMap(); }
private void SetupMap() { // Provide an access token for your app (usually when the app starts). //Esri.ArcGISRuntime.ArcGISRuntimeEnvironment.ApiKey = "YOUR_ACCESS_TOKEN";
MyMapView.Map = new Map(BasemapStyle.ArcGISNavigation); MyMapView.SetViewpoint(new Viewpoint( latitude: 45.526201, longitude: -122.65, scale: 150000 ));
// Create graphics overlays to show routes and stops. var routeSymbol = new SimpleLineSymbol(SimpleLineSymbolStyle.Solid, System.Drawing.Color.RebeccaPurple, 2); var stopSymbol = new SimpleMarkerSymbol(SimpleMarkerSymbolStyle.Circle, System.Drawing.Color.Red, 14); _routeOverlay = new GraphicsOverlay { Renderer = new SimpleRenderer(routeSymbol) }; _stopsOverlay = new GraphicsOverlay { Renderer = new SimpleRenderer(stopSymbol) };
// Add the graphics overlays to the map view. MyMapView.GraphicsOverlays.Add(_routeOverlay); MyMapView.GraphicsOverlays.Add(_stopsOverlay);
// Solve a route between some predefined stops. _ = RouteBetweenStops(); }
private async Task RouteBetweenStops() { // A graphic to show the start location. var originGraphic = new Graphic { Geometry = new MapPoint(-122.690, 45.522, SpatialReferences.Wgs84) }; // A graphic to show an intermediate stop. var intermediateStopGraphic = new Graphic { Geometry = new MapPoint(-122.615, 45.526, SpatialReferences.Wgs84) }; // A graphic to show the final destination var destinationGraphic = new Graphic { Geometry = new MapPoint(-122.688, 45.512, SpatialReferences.Wgs84) };
// Add graphics to the stops overlay _stopsOverlay.Graphics.Add(originGraphic); _stopsOverlay.Graphics.Add(intermediateStopGraphic); _stopsOverlay.Graphics.Add(destinationGraphic);
// Create a RouteTask from an online route service var routeTask = await RouteTask.CreateAsync(new Uri( "https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World"));
// Get the route services default parameters var routeParameters = await routeTask.CreateDefaultParametersAsync();
// Create a list of stops using the graphic's geometry (points) var stops = new[] { new Stop((MapPoint)originGraphic.Geometry), new Stop((MapPoint)intermediateStopGraphic.Geometry), new Stop((MapPoint)destinationGraphic.Geometry) }; // Add the stops to the route parameters routeParameters.SetStops(stops);
// Return driving directions in Spanish routeParameters.ReturnDirections = true; routeParameters.DirectionsLanguage = "es";
// Solve the route using the route parameters var routeResult = await routeTask.SolveRouteAsync(routeParameters); // If a result is returned, display the route if (routeResult?.Routes?.FirstOrDefault() is Route route) { // Show the route as a graphic in the map view var routeGraphic = new Graphic(route.RouteGeometry); _routeOverlay.Graphics.Add(routeGraphic); // Get the driving directions var directions = string.Join("\n", route.DirectionManeuvers.Select(maneuver => maneuver.DirectionText)); DirectionsTextBlock.Text = directions; }3 collapsed lines
}}Use API keys
Tutorials
Samples
Find route
Offline routing
Route around barriers
Display device location with autopan modes
Mobile map (search and route)
Find service area
