Directions (Network Analyst)

ArcGIS Pro 3.4 | | Help archive

Summary

Generates turn-by-turn directions from a network analysis layer with routes. The directions can be written to a file in text, XML, or HTML format. If you provide an appropriate style sheet, the directions can be written to any other file format.

Usage

  • The tool solves the network analysis layer if it does not already have a valid result.

Parameters

LabelExplanationData Type
Input Network Analysis Layer

The network analysis layer for which directions will be generated. Directions can be generated only for route, closest facility, and vehicle routing problem network analysis layers.

Caution:
This tool does not support last mile delivery analysis layers even though this layer type supports directions.

Network Analyst Layer
Output File Type

Specifies the format that will be used for the output directions file. This parameter is ignored if the style sheet parameter has a value.

  • XMLThe output directions file will be generated as an XML file. Apart from direction strings and the length and time information for the routes, the file will also contain information about the maneuver type and the turn angle for each direction.
  • TextThe output directions file will be generated as a simple TXT file containing the direction strings, the length and, optionally, the time information for the routes.
  • HTMLThe output directions file will be generated as an HTML file containing the direction strings, the length and, optionally, the time information for the routes.
String
Output Directions File

The full path to the directions file that will be written.

If you provide a style sheet for the Stylesheet parameter, ensure that the file suffix for Output Directions File matches the file type the style sheet produces.

File
Report Length in These Units

Specifies the linear units that will be used in the directions file. For example, even if the impedance attribute has units of meters, you can show directions in miles.

  • Nautical milesThe linear units will be nautical miles
  • FeetThe linear units will be feet.
  • YardsThe linear units will be yards.
  • MilesThe linear units will be miles.
  • MetersThe linear units will be meters.
  • KilometersThe linear units will be kilometers.
String
Report Travel Time
(Optional)

Specifies whether travel time will be reported in the directions file.

  • Checked—Travel time will be reported in the directions file. This is the default.
  • Unchecked—Travel time will not be reported in the directions file.
Boolean
Time Attribute
(Optional)

The time-based cost attribute that will be used to provide travel times in the directions. The cost attribute must exist on the network dataset used by the input network analysis layer.

String
Language
(Optional)

The language that will be used for driving directions.

Use a two- or five-character language code representing one of the available languages for directions generation for this parameter value. In Python, you can retrieve a list of available language codes using the ListDirectionsLanguages function.

String
Style Name
(Optional)

Specifies the formatting style that will be used for directions.

  • Printable driving directionsPrintable turn-by-turn directions will be used.
  • Driving directions for a navigation deviceTurn-by-turn directions designed for an in-vehicle navigation device will be used.
  • Walking directionsTurn-by-turn walking directions, which are designed for pedestrian routes, will be used.
String
Stylesheet
(Optional)

The style sheet that will be used for generating a formatted output file type (such as a PDF, Word, or HTML). The suffix of the file in the output directions file parameter must match the file type that the style sheet generates. The tool overrides the output file type parameter if this parameter contains a value.

Tip:

To create custom HTML and text style sheets, copy and edit the style sheets from Network Analyst. The style sheets are available in the <ArcGIS installation directory>\Pro\Resources\NetworkAnalyst\Directions\Styles directory. The HTML style sheet is Dir2PHTML.xsl, and the text style sheet is Dir2PlainText.xsl.

File

Derived Output

LabelExplanationData Type
Network Analysis Layer

The updated network analysis layer with routes.

Network Analyst Layer

Environments

Licensing information

  • Basic: Requires Network Analyst
  • Standard: Requires Network Analyst
  • Advanced: Requires Network Analyst

Related topics