Create a model for route analysis

Available with Network Analyst license.

ArcGIS Pro provides geoprocessing functionality through the Network Analyst toolbox. These geoprocessing tools, when chained in a model, can help automate repetitive tasks and reduce the probability of error. In a model, the output of one tool is used as input to another tool.

In this tutorial, you will create a model for generating the fastest delivery route connecting 21 stores.

Note:
This tutorial can be completed using as the network data source either the designated tutorial network dataset, ArcGIS Online, or an ArcGIS Enterprise routing service published using a network dataset that covers the geography of the input data of the analysis. If you use ArcGIS Online, credits will be consumed. Learn more about network analysis with a service.

Get the data

The data for this tutorial is available for download.

  1. Go to the data download page.
  2. Click the Download button, and save the file locally.
  3. Unzip the downloaded file.

Create a map

To create a map, complete the following steps:

  1. Open ArcGIS Pro.
  2. Create a new project based on the Map.aptx template.

    A new project with a map appears.

Add the tutorial data to the project

In this set of steps, you'll add a network dataset to the map.

  1. In the Catalog pane, which is on the side of the application by default, right-click Folders and choose Add Folder Connection Add Folder Connection.

    The Add Folder Connection dialog box appears.

  2. Browse to the folder where you placed the tutorial data, double-click Network Analyst, and click Tutorial to select the folder.
  3. Click OK.

    A connection to the Tutorial folder is created.

  4. Next, add one of the network datasets contained within the folder to the map.

    Note:

    You do not need to add the network dataset to the map if you intend to use ArcGIS Online or an ArcGIS Enterprise routing service as the network data source.

  5. In the Catalog pane, expand Folders > Tutorial > Paris.gdb > Transportation.
  6. Drag ParisMultimodal_ND, which has a network dataset icon Network Dataset, onto the map.

    The network dataset is added to the Contents pane and to the map.

  7. In the Catalog pane, expand Folders > Tutorial > Paris.gdb > Analysis.
  8. Drag the Stores feature class onto the map.

    The point feature class is added to the Contents pane and to the map.

Create and run a model

Follow the steps below in ModelBuilder to create a model and run it.

  1. On the Analysis tab in the Geoprocessing group, click the ModelBuilder button Model.

    A new model is opened for editing.

  2. On the Analysis tab in the Geoprocessing group, click Tools.

    The Geoprocessing pane appears.

  3. Click Toolboxes and expand the Network Analyst Tools toolbox.
  4. Click the Analysis toolset and drag the Make Route Analysis Layer tool into the new model window.
  5. The model resembles the example below in the ModelBuilder window.
    Make Route Analysis Layer tool
    Note:

    If the Network Data Source input variable is not present, double-click the Make Route Analysis Layer tool and provide the network data source. Once the network data source is provided, the model resembles the image above.

    Add the network data source to make the model ready to run.

  6. Double-click Network Data Source in the model window.
  7. From the Network Data Source drop-down list, select ParisMultimodal_ND and click OK.
  8. Note:

    You can also specify ArcGIS Online or ArcGIS Enterprise portal as the network data source.

  9. Double-click the Make Route Analysis Layer tool in the model window.

    The Make Route Analysis Layer dialog box appears.

  10. From the Sequence drop-down menu, choose Preserve both first and last stop.
  11. Click OK.
  12. The model resembles the example below:
    Make Route Analysis Layer tool in ModelBuilder
  13. In the Analysis toolset, drag the Add Locations tool into the model window.
  14. Select the Stores feature layer in the Contents pane and drag it into the model window to the left of Add Locations.
  15. Note:

    You can also use a feature layer hosted in an ArcGIS Online or ArcGIS Enterprise portal to load your input features.

  16. Connect Stores to Add Locations and click Input locations on the context menu that appears.
  17. Connect Route to Add Locations and click Input Network Analysis Layer on the context menu that appears.
  18. Click the ModelBuilder tab on the ribbon.
  19. In the View group, click the Auto Layout button Auto Layout.

    The model is arranged in a logical order and resembles the example below:

    Add Locations tool in ModelBuilder

  20. In the Geoprocessing pane, in the Analysis toolset, drag the Solve tool into the model window.
  21. Connect the output from the Add Locations tool, Updated Input Network Analysis Layer, to Solve. Click Input Network Analysis Layer on the context menu that appears.
  22. On the ModelBuilder ribbon, from the Insert section, click the Utilities drop-down menu and choose the Select Data option.
  23. Connect Updated Input Network Analysis Layer(2) to Select Data. Click Input Network Analysis Layer on the context menu that appears.
  24. Open Select Data and from the Child Data Element drop-down menu, select the Routes sublayer.
    Select the sub-layer from the child data element drop-down
  25. Click OK.
  26. Right-click the child data element Routes and select Add to Display to display the extracted sublayer after the solve.
  27. Click the Auto Layout button Auto Layout to arrange the model elements.

    Solve the model

  28. Right-click the output layer of the Solve tool, Updated Input Network Analysis Layer (2), and click Add To Display.
  29. The model adds the final output to the map display when run from the model view.
  30. Click the Save button Save to save the model.
  31. Click the Validate button Validate to ensure that all the elements of the model are valid.
  32. Click the Run button Run.
  33. A status window appears while the route analysis is performed.
  34. When completed, close the status window and switch to the map view so you can inspect the results.

    A new route layer is added to the Contents pane. Also, the sublayer Routes is extracted and added to the Contents pane.

    Route analysis result

Run the model as a geoprocessing tool

As with other geoprocessing tools, you can open and run a model tool in the Geoprocessing pane. Variables that are set as model parameters show as tool parameters when the model is run as a geoprocessing tool, allowing you to specify different data or values for your model to process than what was specified when the model was created.

  1. Switch to the model view and right-click Stores. Select Parameter from the context menu that appears.

    The variable is set as a parameter, which is indicated by the letter P next to the variable in the model.

  2. Repeat step 1 for the ParisMultimodel_ND and Updated Input Network Analysis Layer (2) variables in the model.

    The model resembles the example below:

    Set variables as parameters

  3. Save and close the model.

    The model is saved as a geoprocessing tool in a toolbox.

    Model saved as geoprocessing tool in toolbox

  4. Browse to the location where the model is saved and double-click it, or right-click it and choose Open.

    The model appears in the Geoprocessing pane.

  5. Populate the parameters, if necessary, and click the Run button Run at the lower right.

    A new route layer is added to the map view and the Contents pane.

    Tip:
    You can add the Package Layer and Share Package tools to the model to create a layer package of the final output and share the layer package using your ArcGIS Online account.
    Create and share layer package

    You can also create a project package or project template to share the model, so it can be used by any user in your organization or through ArcGIS Online or ArcGIS Enterprise.