ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Output from Find Routes

Available with Network Analyst license.

  • Routes feature class
  • Stops feature class
  • Directions feature class
  • Route Edges feature class

The Find Routes geoprocessing tool produces layers representing stops, routes, directions, and route edges. The output feature classes and their corresponding field attributes are described in this topic.

Routes feature class

The Routes line feature class represents the best paths between the stops.

The default name of this output feature class is Routes, but you can give it a different name by changing the Output Routes Name parameter (Output_Routes_Name in Python) prior to solving.

The feature class is assigned the same coordinate system that the underlying network dataset uses. This can be controlled by specifying a value for the Output Coordinate System geoprocessing environment.

The field names of the Routes feature class are listed and described below.

Field nameDescription

OID

The system-managed ID field.

Shape

The geometry field indicating the shape of the lines.

Name

The name of the route is copied from the RouteName field of the stops it was assigned to visit. If the input RouteName field of stops was null, the name is derived from the names of the first and last stops.

Input stops that have the same route name at the time the tool runs are grouped together and visited by one route and the route is assigned that name. When more than one route name is present on the input stops, the tool can output multiple routes—one for each unique route name.

StopCount

The number of stops assigned to the route.

Total_[Units]

The total time or distance of the route.

Total_Minutes,Total_Miles, and Total_Kilometers are always present. Another field is present if the Measurement Units input parameter was set to a different unit.

Total_[Accumulated Cost Attribute]_[Units]

The total time or distance of the route based on a cost attribute chosen in the Accumulate Attributes input parameter.

The units of the specified cost attribute are converted to the units that were set in the Measurement Units input parameter.

TotalWait_[Time Attribute]

The total amount of time the route spends in front of a stop waiting for its time window to open. For example, if a stop has a time window of 3:00 to 4:00 p.m., and the route arrives at 2:55 p.m., the wait time at that stop is 5 minutes. This field value is the sum of the wait times at all stops.

TotalViolation_[Time Attribute]

The total amount of the route's time-window violation time. If a route arrives at a stop 5 minutes after the stop's time window ends, the violation time at that stop is 5 minutes. This field is the sum of the violation times at all stops.

StartTime

The time the route begins.

EndTime

The time the route is complete.

FirstStopOID

The OID identifier of the first stop on the route.

LastStopOID

The OID identifier of the last stop on the route.

Shape_Length

The geometric length of the feature.

Stops feature class

The Stops feature class represents the stops that could and could not be reached by any of the routes. For those that couldn't be reached, the attribute table provides information on what was the source of the problem. For those that could be reached, the attribute table lists the route name assigned to the stops, the stop sequence, arrival time, and other information.

The default name of this output feature class is Stops, but you can give it a different name by changing the Output Stops Name parameter (Output_Stops_Name in Python) prior to solving.

The feature class is assigned the same coordinate system that the underlying network dataset uses. This can be controlled by specifying a value for the Output Coordinate System geoprocessing environment.

The field names of the Stops feature class are listed and described below.

Field nameDescription

OID

The system-managed ID field.

Shape

The geometry of the point, which is stored internally.

Name

The name of the stop. If the input stops feature class had a field with the same name, this Name value is derived from that field; otherwise, the Name value is assigned a default value.

RouteName

This represents the name of the route to which the stop is assigned.

Input stops that have the same route name at the time the tool runs are grouped together and visited by one route and the route is assigned that name. When more than one route name is present on the input stops, the tool can output multiple routes—one for each unique route name.

If no name is present, all the stops belong to the same route.

Sequence

The order in which the stop is visited by the assigned route, which is listed in the RouteName field.

A stop with a Sequence value of 3 indicates the assigned route visits two stops before visiting the stop in question.

TimeWindowStart

This field specifies the earliest time that the route can visit the stop.

This field and its values are copied from the input stops.

TimeWindowEnd

This field specifies the latest time that the route can visit the stop.

This field and its values are copied from the input stops.

Curb Approach

Specifies the direction a vehicle may arrive at and depart from the stop.

This field and its values are copied from the input stops.

ArriveCurbApproach

Indicates which side of the vehicle the curb is on when arriving at the stop.

DepartCurbApproach

Indicates which side of the vehicle the curb is on when departing from the stop.

Status

This field is constrained by a domain of values, which are listed below (their coded values are shown in parentheses). Note that network location refers to the location of the stop on the network dataset.

  • OK (0)—The network location was successfully evaluated.
  • Element not traversable (3)—The network element that the network location is on is not traversable. This can occur when the network element is restricted by a restriction attribute.
  • Invalid field values (4)—The field values of the network location fall outside the analysis layer's coded or range domains. For example, a negative number may exist where positive numbers are required.
  • Not reached (5)—The network location can't be arrived at by the solver.
  • Time window violation (6)—Time windows on the route cannot be reached on time; the route arrives early or late.

Additional Time

The amount of time added to the total route time when this stop is visited.

This field and its values are copied from the input stops.

The units for this field value are the same as those specified in the Measurement Units input parameter.

Additional Distance

The amount of distance added to the total route distance when this stop is visited.

This field and its values are copied from the input stops.

The units for this field value are the same as those specified in the Measurement Units input parameter.

Cumul_[Units]

The cumulative distance or duration of the route from the origin to and including the stop. The value reported here is the cumulative route time or distance to the stop, including any additional time or distance at the stop and at any previous stops.

Cumul_[Attribute Name]_[Units]

The cumulative distance or duration of the route from the origin to and including the stop. The value reported here is the cumulative route time or distance to the stop, including any additional time or distance at the stop and at any previous stops.

The units of the specified cost attribute are converted to the units that were set in the Measurement Units input parameter.

ArriveTime

The time of day when the route arrives at the stop.

When the network dataset is configured with time zones, the time-of-day value corresponds with the time zone in which the stop is located; otherwise, it corresponds with the time zone that is configured on the computer used to solve the analysis.

DepartTime

The time of day when the route departs from the stop.

When the network dataset is configured with time zones, the time-of-day value corresponds with the time zone in which the stop is located; otherwise, it corresponds with the time zone that is configured on the computer used to solve the analysis.

ORIG_FID

The Object ID of the input stop. This field can be used to join attributes from the output Stops feature class to the input stops table or from the input stops to the output stops. It can also be used to join attributes to and from the output Stops feature class.

Directions feature class

The Directions line feature class represents segments along routes between stops. It includes text directions for navigation assistance.

The default name of this output feature class is Directions, but you can give it a different name by changing the Directions Name (Output_Directions_Name in Python) parameter prior to solving.

The feature class is assigned the same coordinate system that the underlying network dataset uses. This can be controlled by specifying a value for the Output Coordinate System geoprocessing environment.

The field names of the Directions feature class are listed and described below.

Field NameDescription

ObjectID

The system-managed ID field.

Shape

The geometry field indicating the shape of the lines.

RouteName

The name of the route that the driving action applies to.

ArriveTime

The time of day to initiate the given driving action.

If the route spans multiple days, the date and time of day are displayed.

Type

This field is for advanced users who want to customize the driving-directions text. Most users can meet their requirements by ignoring this field and referring to the Text field instead.

Type refers to a constant in one of two enumerations: esriDirectionsManueverType or esriDirectionsStringType. (See the SubItemType field description to learn which enumeration the Type value refers to.) You can see a list of constant values by searching the SDK of your choice for the enumeration name.

SubItemType

This field is for advanced users who want to customize the driving-directions text. Most users can meet their needs by ignoring this field and referring to the Text field instead.

SubItemType works in combination with Type to create the driving direction shown in the Text field. The SubItemType field specifies whether the Type field refers to a constant value in the esriDirectionsManueverType enumeration or the esriDirectionsStringType enumeration.

  • If the SubItemType value is 1, the Type value refers to esriDirectionsManeuverType.
  • If the SubItemType value is 2, the Type value refers to esriDirectionsStringType.

Text

A text description of the driving direction.

The text uses the style, units, and language you specified in the tool parameters.

ElapsedTime

The time it takes to complete the maneuver.

The units chosen in the Time Attribute Units parameter determine the units of the ElapsedTime field.

Some driving directions include extra records for service time, violation time, and so on. In these cases, the elapsed time is replicated for each record. If you want to sum the total elapsed time, select those records with a Type value of 1 and sum those records.

DriveDistance

The travel distance along this segment of the route.

This value is zero for driving directions that occur at the same location where the next one begins.

Shape_Length

The geometric length of the feature.

Route Edges feature class

The Route Edges line feature class represents the individual road segments that the routes travel along.

The default name of this output feature class is RouteEdges, but you can give it a different name by changing the Output Route Edges Name (Output_Route_Edges_Name in Python) parameter prior to solving.

The feature class is assigned the same coordinate system that the underlying network dataset uses. This can be controlled by specifying a value for the Output Coordinate System geoprocessing environment.

The field names of the Route Edges feature class are listed and described below.

Field NameDescription

ObjectID

The system-managed ID field.

Shape

The geometry field indicating the shape of the lines.

SourceName

The name of the edge source feature class from which the line was generated.

SourceOID

The object ID of the traversed source feature. This value is an object ID from the feature class that is identified in the SourceName field.

RouteEdgeID

The ID representing the network dataset edge that was traversed by the route.

Object IDs uniquely identify features and edge IDs uniquely identify edges, and there may be more than one edge per line feature.

FromPosition

Specifies where the output RouteEdges feature begins in reference to the digitized direction of the underlying source feature.

  • A value of 0 (zero) indicates the line begins at the from-point of the underlying source feature.
  • A value of 1 indicates the line begins at the to-point of the source feature.
  • A value between 0 and 1 indicates the line begins at a point along the underlying source feature; for example, a value of 0.25 means the line begins 25 percent along the digitized direction of the underlying source feature.

ToPosition

Specifies where the output RouteEdge feature ends in reference to the digitized direction of the underlying source feature.

  • A value of 0 (zero) indicates the line ends at the from-point of the underlying source feature.
  • A value of 1 indicates the line ends at the to-point of the source feature.
  • A value between 0 and 1 indicates the line ends at a point along the underlying source feature; for example, a value of 0.25 means the line ends 25 percent along the digitized direction of the underlying source feature.

RouteID

Uniquely identifies the route that traversed the edge. The RouteID value corresponds to an OID value from the output Routes feature class.

Attr_[Units]

The travel time or length of the traversed portion of the underlying source feature.

Attr_[Cost Attribute]_[Units]

The travel time or length of the traversed portion of the underlying source feature according to the cost attribute name.

The units of the specified cost attribute are converted to the units that were set in the Measurement Units input parameter.

Cumul_[Units]

The travel time or length of the route from its origin to the end of the traversed portion of this underlying source feature.

Cumul_[Cost Attribute]_[Units]

The travel time or length of the route from its origin to the end of the traversed portion of this underlying source feature.

The units of the specified cost attribute are converted to the units that were set in the Measurement Units input parameter.

Attr_[Restriction Attribute]

Specifies whether the traversed edge used the restriction attribute referred to in this field's name.

  • 0—The traversed edge didn't use the restriction.
  • 1—The traversed edge used the restriction.

Shape_Length

The geometric length of the feature.

Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal