Available with Business Analyst license.
The Publish Routing Services utility allows you to publish directions, routing, and logistics services based on a network dataset to your ArcGIS Server. These services are similar to the routing services available with ArcGIS Online, but are published on-premises based on your own street network dataset.
Once published, the services can be used with Business Analyst Enterprise for creating study areas based on driving and walking times and distances.
To use this utility, your ArcGIS Server site needs to have an ArcGIS Network Analyst extension license.
A street network dataset for the USA is provided for Business Analyst Enterprise users in file geodatabase format (.gdb file). Before using the .gdb file, you must install a StreetMap Premium license file (.sdlic), which is available through Esri Customer Service. You can review the license information in ArcGIS Pro to verify that the *.sdlic license file is enabled. Once enabled, the publish routing services utility can be used to publish services from the .gdb file.
All data needed for street address geocoding and network analysis are included with the 2018 US Data for Business Analyst on My Esri.
StreetMap Premium for ArcGIS product downloads for Pro and Enterprise may appear in your My Esri list. These files are not needed and should not be downloaded. Please follow the steps for downloading the street data below.
Downloading the street network data
- On the My Esri site, click My Organizations then click Downloads.
- Verify that you are in the Products section. In the Quick Search text box, enter Business Analyst or Business.
- Look for ArcGIS Business Analyst Enterprise with 2018 U.S. Data and ensure the version is 10.7. Click View Downloads.
There will be two downloads for the street data, both will need to be downloaded on a folder to your local drive.
- Click the Download Components tab then click Data and Content to expand the list of files.
- Locate #1 ArcGIS Business Analyst Enterprise 2018 Street Data (U.S.A) and click Download.
- In the Esri Download Manager dialog, click Click to download your file now.
- Locate #2 ArcGIS Business Analyst Enterprise 2018 Street Data (U.S.A) and click Download.
- The Destination Folder for Files dialog will appear. Keep the default location or click Browse to choose a different location.
Tip:While you can keep the network dataset in a shared location that is accessible to all the machines in your GIS server site, it is recommended to copy the network dataset locally, on each machine, for best performance when running the services.
The appropriate data license must be installed on the machine before running this utility. Follow the instructions for installing the data license on Windows.
The following parameters are available when running the publishroutingservices.py script:
User name for a user with publisher or administrative privileges in the ArcGIS Server site. If the site is federated with a portal, the user must be a portal user and can have administrative privilege or a publisher privilege that allows publishing web tools and publishing server-based layers. If the site is not federated, the user must have administrative privileges. If your site is configured with web-tier authentication, specify a built-in user, such as the primary site administrator account or the initial administrator account in your portal.
The password of the user who was specified with the -u parameter.
The fully qualified domain name of the machine running ArcGIS Server, such as gisserver.domain.com, or the local URL to your ArcGIS Server site in the format https://gisserver.domain.com:6443/arcgis.
The fully qualified domain name of the machine, such as gisportal.domain.com, where Portal, to which your ArcGIS Server site federates with, is installed. The value can also be a local URL to the portal in the format https://gisportal.domain.com:7443/arcgis A value for this option is required only if the ArcGIS Server that will host the routing services is federated with the portal.
The full path to the network dataset. Along with the path to the file geodatabase, the path should also include the name of the network dataset and the name of the feature dataset containing the network dataset. For example, a value for this option can be c:\data\Streets.gdb\Routing\Routing_ND on Windows and /data/Streets.gdb/Routing/Routing_ND on Linux where Streets.gdb is the file geodatabase that has a network dataset named Routing_ND in a feature dataset named Routing.
Path to a folder where the utility will create the service definition files for the services and a log file named publishroutingservices.log that includes the details about the execution as well as any errors that might be encountered.
Prints help for the utility.
The ArcGIS Server install includes a script that will help to publish a network service which can be used for routing by the Business Analyst Server service. This script is installed to <ArcGIS Server Install Location>/ArcGIS/Server/Tools/PublishRoutingServices and is named publishroutingservices.py.
In this example, the streets data copied locally to the C drive. The staging folder for the service definition files is RoutingSDs, it must be created prior to running the utility.
publishroutingservices.py -s ServerMachine.domain.com -P PortalMachine.domain.com -u PortalAdminUser -p PortalAdminPassword -n "Streets Data\NorthAmerica.gdb\Routing\Routing_ND" -o C:\RoutingSDs
Configuring a network utility services from ArcGIS Online
You have the option to configure your portal to use utility services from ArcGIS Online instead of publishing them to your own server. This has the added benefit of providing street network coverage outside the United States. If you would like to use online network services provided by Esri, you must have an ArcGIS Online organizational account. The account must have credits associated with it and the correct permissions to use the utility services.
The ArcGIS Online network services provide coverage for several countries and can be configured in the portal following the steps below.
- Sign in to the portal website as a member of the default administrator role in your organization.
- At the top of the site, click Organization and click the Settings tab.
- Click ArcGIS Online on the left side of the page.
- Select Network.
- Enter the credentials for the ArcGIS Online account that is to be used for the utility services.
- Click Configure.