Skip To Content

Configure routing services

Routing services allow you to perform several types of spatial analysis on transportation networks, such as finding the best route across a city, finding the closest emergency vehicle or facility, identifying a service area around a location, or servicing a set of orders with a fleet of vehicles.

Default administrators and those with the appropriate privileges can configure ArcGIS Enterprise to use routing services to perform various tasks. The routing services can be configured in ArcGIS Enterprise using one of three methods:

Once configured, the routing services can be used with various applications, such as ArcGIS Pro, or to get directions and perform analysis in Map Viewer. You can also use the routing services to include network analysis capabilities in your own custom applications. ArcGIS developers have many APIs that work with the routing services, such as the ArcGIS Maps SDK for JavaScript, the ArcGIS REST API, or the various native ArcGIS Maps SDKs.

Learn more about the various APIs to access routing services

Configure routing services in ArcGIS Enterprise

To configure routing services, follow the steps below.

  1. Sign in to your organization as an administrator.
  2. At the top of the site, click Organization and click the Settings tab.
  3. Click Utility services on the left side of the page.
  4. Click Directions and Routing on the right side of the page.
  5. Click Configure routing services and choose one of the three methods to configure routing services on the ArcGIS Enterprise portal.
    Configure routing services dialog box

Configure routing services from ArcGIS Online

You can configure your ArcGIS Enterprise routing services from ArcGIS Online. To use routing services provided by Esri, you must have an ArcGIS Online organizational account. The account must have credits associated with it and the appropriate permissions to use the routing services.

  1. On the Configure routing services dialog box, select the ArcGIS Online option, and click Next.
  2. Enter the credentials for the ArcGIS Online account to be used for the routing services, and select the folder or create a folder where the corresponding items will be created in ArcGIS Enterprise.
  3. Click Save.

Once it succeeds, it will show that the routing services in ArcGIS Enterprise are coming from ArcGIS Online. It will also show the ArcGIS Online user account that is used to set up the ArcGIS Enterprise routing services. This is the account from which credits will be deducted when you use routing services in ArcGIS Enterprise.

Configure and publish routing services using your network dataset to a federated ArcGIS Server site

If you have a network dataset that models your street data, and want to use it as sources for your routing services, you can configure your ArcGIS Enterprise routing services by publishing routing services using your network dataset to a federated ArcGIS Server site. This process creates all the routing services based on your network dataset and registers them as utility services in ArcGIS Enterprise for various applications to discover and use them.

Ensure that the network dataset that is used to publish routing services is accessible to the server site where you want routing services to be hosted. You can do this by storing the file geodatabase or the mobile geodatabase containing the network dataset in a folder that is registered as a folder data store item within the content of your ArcGIS Enterprise organization, or by adding a database data store item for the enterprise geodatabase that stores the network dataset. The data store item should allow access to the federated ArcGIS Server site that is being used to host routing services.

Learn more about data stores in ArcGIS Enterprise

Caution:

If you have specified ArcGIS Enterprise maximum token duration to be less than 120 minutes, you may run into issues since this process could take a while. It is recommended that you set the ArcGIS Enterprise maximum token duration to be more than 120 minutes before running this process and reset it to your desired value after the process.

  1. On the Configure routing services dialog box, select A network dataset that I'd like to publish, and click Next
  2. In the Network dataset section, do the following
  3. From the Data store item containing the network dataset drop-down menu, select a data store item that contains your network dataset.
  4. From the GIS Server site to host your routing services drop-down menu, choose the GIS Server site that will be used to host your routing services. The drop-down menu only includes GIS Server sites that can access the data store item. It also only includes ArcGIS Server sites of version 11.0 or later.
  5. The Network dataset relative path is the path to the network dataset in the data store. For example, if the catalog path of the network dataset in a file geodatabase is C:\data \streets\NorthAmerica.gdb\Routing\Routing_ND and the data store item is referencing C:\data, the value for the network dataset relative path is /streets/NorthAmerica.gdb/Routing/Routing_ND.

    Note:

    You need to provide the network dataset relative path using forward slashes.

  6. In the Service properties section, complete the following steps:
  7. For the Service folder parameter, specify a name for the server folder that will contain all the routing services created by the tool.
  8. For the Service types parameter, turn off the services you don't need.
    Note:
    Some out- of- the box client applications may have functionality disabled. To make use of all or the needed services, ensure they are turned on in the Configure routing services dialog box.
  9. In the Advanced properties section, specify a configuration file to specify certain properties for the routing services such as the minimum and maximum number of service instances. The framework/runtime/ArcGIS/Resources/ArcToolBox/Services/routingservices folder in the ArcGIS Server installation directory includes two sample configuration files, publishroutingservices.json and publishroutingservices_dedicated.json. The process uses the publishroutingservices.json file by default if you don't specify a configuration file.

Learn more about publishing a routing services config file

Before publishing, ensure all the parameters are entered correctly. Once the process starts, you will get a progress indicator. Since it can take a while to run the process, you can continue with other tasks on your portal and return to the progress indicator page to see whether the process has finished.

Once the process finishes, it should show you the ArcGIS Server site that hosts your routing services, as well as the network dataset that is used for your routing services. If you are using StreetMap Premium data to publish routing services, and if the data is set up to use live traffic, it should show you the traffic data service item indicating your routing services have live traffic configured from ArcGIS Online.

Once configure routing services runs successfully, it creates a few service items of type Tool, Network Analysis Service and Map Image Layer in the portal. Click the options Options button and click View routing services details to view the service item. The launcher Launcher button takes you to each service item's details page, where you can change settings about service item, such as item details, sharing settings, etc.

Learn more about configure item details and settings

Note:

You can edit additional properties on routing services using the ArcGIS Server Manager and admin directory.

Note:
Configure routing services using your own network dataset, configures standard routing services on the portal. If you want to publish custom routing services, see the custom routing services topic in ArcGIS Pro.

Error and warning messages

If you run into issues while publishing, you will see warning messages or error messages. Learn more about warnings and errors when publishing routing services.

When you have more than one warning or error messages, you can see them all by clicking View publishing routing services warnings or View publishing routing services errors. By clicking Detailed messages from publish routing services, you can open the raw JSON messages returned from publishing routing services REST API, which could contain more information.

Configure routing services by updating ArcGIS Enterprise routing utility services URLs

If you have routing services hosted on a stand-alone server and want to register the services with ArcGIS Enterprise so that various applications can discover and use these routing services, you can configure routing services by updating ArcGIS Enterprise routing utility services.

  1. On the Configure routing services dialog box, select Existing routing services (Advanced).
  2. Construct URLs to the various routing utility services. You don't need to specify a URL for all the services.
  3. Click Save.

Once routing services are configured in ArcGIS Enterprise using one of the three methods mentioned above, you can view an individual routing service URL and service item by clicking the Options button and clicking View routing services details. You can delete routing services from the ArcGIS Enterprise portal by clicking Delete routing services. If you configure routing services by updating ArcGIS Enterprise routing utility services URLs, you can directly edit each utility service by clicking the Options button and clicking Edit routing services.

If you configure routing services in ArcGIS Enterprise, and later need to update routing services, you can click the Update routing services button and follow the same steps to update routing services in ArcGIS Enterprise. You could also delete existing routing services and configure them again from scratch. The benefit of doing so is the existing service items and routing services on the ArcGIS Server site are deleted and cleaned. If your routing services source is Custom, you only have the Remove routing services option, which only removes the utility services from ArcGIS Enterprise.