Route output data types
The output data types containing the results from a route analysis are described.
Routes
This provides access to the resulting routes.
The data type supports the following fields:
|
Field |
Description |
Data type |
|---|---|---|
|
|
The object ID of the feature. |
ObjectID |
|
|
The name of the route is based on the |
Text |
|
|
The number of stops assigned to the route. |
Long |
|
|
The start time of the route, reported in the time zone in which the first stop is located. |
Date |
|
|
The end time of the route, reported in the time zone in which the last stop is located. |
Date |
|
|
The start time of the route in coordinated universal time (UTC). |
Date |
|
|
The end time of the route in coordinated universal time (UTC). |
Date |
|
|
The cumulative travel time in minutes from the beginning of the first stop to the end of the last stop for a route. This includes any Note:An additional field, Note:Additional fields, |
Double |
|
|
The cumulative travel distance in miles from the beginning of the first stop to the end of the last stop for a route. This includes any |
Double |
|
|
The cumulative travel distance in kilometers from the beginning of the first stop to the end of the last stop for a route. This includes any Note:An additional field, Note:Additional fields, |
Double |
|
|
The cumulative travel cost in unknown units from the beginning of the first stop to the end of the last stop for a route. This includes any This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based. Note:Additional fields, |
Double |
|
|
This field stores the route's overall wait time, which is the time spent at stops waiting for time windows to open. The field has a null value if time windows are not used in the analysis. Note:An additional field, Note:Additional fields, |
Double |
|
|
This field stores the route's overall violation time at stops. Violation time is added when the route arrives at a stop after the time window has ended; it's the difference between the The field has a null value if time windows are not used in the analysis. Note:An additional field, Additional fields, |
Double |
|
|
This field corresponds to the |
Long |
|
|
The |
Long |
|
|
This field corresponds to the |
Long |
|
|
The |
Long |
RouteEdges
This provides access to the individual network edges along which the routes travel.
The data type supports the following fields:
|
Field |
Description |
Data type |
|---|---|---|
|
|
The object ID of the feature. |
ObjectID |
|
|
The name of the edge source feature class from which the line was generated. |
Text |
|
|
The |
Long |
|
|
The ID representing the edge that comprises the street feature. Since there can be more than one edge per street feature, the |
Long |
|
|
Specifies where the output
|
Double |
|
|
Specifies where the output
|
Double |
|
|
The |
Long |
|
|
The |
Long |
|
|
Uniquely identifies the route that traversed the edge. This field corresponds to the |
Long |
|
|
The travel time in minutes of the traversed portion of the underlying street feature. Note:An additional field, |
Double |
|
|
The length in miles of the traversed portion of the underlying street feature. |
Double |
|
|
The length in kilometers of the traversed portion of the underlying street feature. Note:An additional field, |
Double |
|
|
The travel cost of the traversed portion of the underlying street feature. This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based. The value is in unknown units. Note:Additional fields, |
Double |
|
|
The travel time in minutes of the route from its origin to the end of the traversed portion of this underlying street feature. Note:An additional field, Note:Additional fields, |
Double |
|
|
The length in miles of the route from its origin to the end of the traversed portion of this underlying street feature. |
Double |
|
|
The length in kilometers of the route from its origin to the end of the traversed portion of this underlying street feature. Note:An additional field, Note:Additional fields, |
Double |
|
|
The travel cost of the route from its origin to the end of the traversed portion of this underlying street feature. This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based. The value is in unknown units. Note:Additional fields, |
Double |
|
|
Specifies whether the traversed edge used the soft restriction attribute referred to in this field's name.
For example, if the analysis was performed using the soft restriction called Avoid Toll Roads, a field called |
Long |
RouteJunctions
This provides access to the individual network junctions through which the routes passed.
The data type supports the following fields:
|
Field |
Description |
Data type |
|---|---|---|
|
|
The object ID of the feature. |
ObjectID |
|
|
The name of the junction source feature class from which the point was generated. |
Text |
|
|
The |
Long |
|
|
The ID representing the junction. This ID may be the same as the |
Long |
|
|
Uniquely identifies the route that traversed the junction. This field corresponds to the |
Long |
|
|
The travel time in minutes to traverse the junction. Note:An additional field, |
Double |
|
|
The length in miles added to the route by traversing the junction. |
Double |
|
|
The length in kilometers added to the route by traversing the junction. Note:An additional field, |
Double |
|
|
The travel cost of the traversed junction. This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based. The value is in unknown units. Note:Additional fields, |
Double |
|
|
The travel time in minutes of the route from its origin through this junction. Note:An additional field, Note:Additional fields, |
Double |
|
|
The length in miles of the route from its origin through this junction. |
Double |
|
|
The length in kilometers of the route from its origin through this junction. Note:An additional field, Note:Additional fields, |
Double |
|
|
The travel cost of the route from its origin through this junction. This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based. The value is in unknown units. Note:Additional fields, |
Double |
|
|
Specifies whether the traversed junction used the soft restriction attribute referred to in this field's name.
For example, if the analysis was performed using the soft restriction called Avoid Toll Roads, a field called |
Long |
RouteTurns
This provides access to the network turns traversed by the routes.
The data type supports the following fields:
|
Field |
Description |
Data type |
|---|---|---|
|
|
The object ID of the feature. |
ObjectID |
|
|
The name of the turn source feature class from which the line was generated. |
Text |
|
|
The |
Long |
|
|
The ID representing the turn. This ID is typically the same as the |
Long |
|
|
The |
Long |
|
|
The |
Long |
|
|
Uniquely identifies the route that traversed the turn. This field corresponds to the |
Long |
|
|
The travel time in minutes to traverse the turn. Note:An additional field, |
Double |
|
|
The length in miles added to the route by traversing the turn. |
Double |
|
|
The length in kilometers added to the route by traversing the turn. Note:An additional field, |
Double |
|
|
The travel cost of the traversed turn. This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based. The value is in unknown units. Note:Additional fields, |
Double |
|
|
The travel time in minutes of the route from its origin through this turn. Note:An additional field, Note:Additional fields, |
Double |
|
|
The length in miles of the route from its origin through this turn. |
Double |
|
|
The length in kilometers of the route from its origin through this turn. Note:An additional field, Note:Additional fields, |
Double |
|
|
The travel cost of the route from its origin through this turn. This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based. The value is in unknown units. Note:Additional fields, |
Double |
|
|
Specifies whether the traversed turn used the soft restriction attribute referred to in this field's name.
For example, if the analysis was performed using the soft restriction called Avoid Toll Roads, a field called |
Long |
Directions
This provides access to the turn-by-turn directions for each resulting route.
Legacy:
This output class has been superseded by the DirectionPoints and DirectionLines output classes, which should be used for all new scripts and workflows. The Directions output class will be removed in a future release.
The data type supports the following fields:
|
Field |
Description |
Data type |
|---|---|---|
|
|
The object ID of the feature. |
ObjectID |
|
|
The name of the route to which the driving action applies. This value is the same as the |
Text |
|
|
The time of day to initiate the given driving action. If the route spans multiple days, the date and time of day are displayed. |
Date |
|
|
The type of maneuver that the directions feature represents or the type of the directions text. To determine whether
The Maneuver Types
Directions String Types
|
Short |
|
|
Specifies whether the
|
Short |
|
|
A text description of the travel directions. |
String |
|
|
The time elapsed in minutes from when the current driving direction starts until the next one starts, or until the route ends for the last driving direction. |
Float |
|
|
The distance from where the current driving direction occurs to where the next one occurs, or to where the route ends for the last driving direction. The value is in the units specified by the This value is zero for driving directions that occur at the same location where the next one begins. For example, the |
Float |
Stops
This provides access to the attributes of the stops that are visited by the routes as well as stops that cannot be reached by any of the routes.
You can use the attributes from this parameter, such as the Status field, to determine why a stop was not assigned to any routes.
The data type supports the fields described below. In addition to these fields, the data type also includes all the fields from the input feature class used as stops for the analysis.
|
Field |
Description |
Data type |
|---|---|---|
|
|
The object ID of the feature. |
ObjectID |
|
|
The name of the stop visited by the route. The values for this field are copied from the |
Text |
|
|
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 provided, all the stops belong to the same route. |
Text |
|
|
The order in which the stops are visited by the assigned route, which is listed in the |
Long |
|
|
The earliest time the route can visit the stop. The values for this field are copied from the |
Date |
|
|
The latest time the route can visit the stop. The values for this field are copied from the |
Date |
|
|
The side of the vehicle the curb is on when arriving at the stop. |
Long |
|
|
The side of the vehicle the curb is on when departing from the stop. |
Long |
|
|
The date and time value indicating the arrival time at the stop. The time zone for this time-of-day value is taken from the network element on which the stop is located. |
Date |
|
|
The date and time value indicating the departure time from the stop. The time zone for this time-of-day value is taken from the network element on which the stop is located. |
Date |
|
|
The date and time value indicating the arrival time at the stop. The time zone for this time-of-day value is taken from the network element on which the stop is located. |
Date |
|
|
The date and time value indicating the departure time in coordinated universal time (UTC) |
Date |
|
|
The stop type. The values for this field are copied from the |
Long |
|
|
The numeric identifier of the network dataset source feature class on which the input point is located. |
Long |
|
|
The ObjectID of the feature in the source on which the input point is located. |
Long |
|
|
The position along the digitized direction of the source line feature. This value is stored as a ratio. This field is null if the network location references a junction. |
Double |
|
|
The side of the edge in relation to the digitized direction of the line feature. This field is limited to a domain of two values: Right Side (1) and Left Side (2). |
Long |
|
|
The direction a vehicle may arrive at and depart from the stop. The values for this field are copied from the |
Long |
|
|
Specifies the status of the point with respect to its location on the network and the outcome of the analysis. The possible values are the following:
|
Long |
|
|
The x-coordinate of the position on the network dataset where the point was located, in the coordinate system of the network dataset. |
Double |
|
|
The y-coordinate of the position on the network dataset where the point was located, in the coordinate system of the network dataset. |
Double |
|
|
The z-coordinate of the position on the network dataset where the point was located, in the coordinate system of the network dataset. The |
Double |
|
|
The distance in meters between the point's geographic location and the position where it was located on the network. |
Double |
|
|
The amount of time added to the total route time when this stop is visited. The values for this field are copied from the |
Double |
|
|
The amount of distance added to the total route distance when this stop is visited. The values for this field are copied from the |
Double |
|
|
The cost added to the total route cost when this stop is visited. The values for this field are copied from the |
Double |
|
|
The cumulative duration of the route in minutes from the origin to and including the stop. The value reported here is the cumulative route time to the stop, including any additional time at the stop and at any previous stops. For example, if a route analysis determines that it takes 10 minutes to visit two stops, and the second stop has an Note:An additional field, Note:Additional fields |
Double |
|
|
The cumulative distance of the route in miles from the origin to and including the stop. The value reported here is the cumulative route distance to the stop, including any additional distance at the stop and at any previous stops. Note:An additional field, Note:Additional fields, |
Double |
|
|
The cumulative distance of the route in kilometers from the origin to and including the stop. The value reported here is the cumulative route distance to the stop, including any additional distance at the stop and at any previous stops. |
Double |
|
|
The cumulative cost of the route from the origin to and including the stop. The value reported here is the cumulative route cost to the stop, including any additional cost at the stop and at any previous stops. This field is included only when the travel mode used for the analysis has an impedance attribute that is neither time based nor distance based. The value is in unknown units. Note:Additional fields, |
Double |
|
|
This field stores the time spent waiting for the time window to open when the route arrives early at the stop. The field has a null value if time windows are not used in the analysis. Note:An additional field, Note:Additional fields, |
Double |
|
|
This field stores the sum of how much time has been spent waiting for time windows to open. It measures idle time. It includes the wait time from the current stop and all previous stops visited by the route. The field has a null value if time windows are not used in the analysis. Note:An additional field, Additional fields, |
Double |
|
|
This field is a measure of how late the route arrived after the time window closed. Specifically, it stores the amount of time between the end of the time window and when the route arrived at the stop. The field has a null value if time windows are not used in the analysis. Note:An additional field, Additional fields, |
Double |
|
|
This field stores the cumulative violation time from the current stop and all previous stops visited by the route. The field has a null value if time windows are not used in the analysis. Note:An additional field, Additional fields, |
Double |
|
|
The This field is not always reliable for joins. This field is null for inputs added to the analysis using the |
Long |
|
|
The values for this field are copied from the |
Double |
|
|
The values for this field are copied from the |
Double |
|
|
The values for this field are copied from the |
Double |
DirectionPoints
This is the output turn-by-turn directions for the routes calculated in the analysis, represented as point locations along the routes where specific direction events or maneuvers occur.
The data type supports the following fields:
|
Field name |
Description |
Data type |
|---|---|---|
|
|
The object ID of the feature. |
ObjectID |
|
|
The |
Long |
|
|
The sequence of the direction points for the route, starting with 1. |
Long |
|
|
Specifies the type of direction event or maneuver described by the point, designated by one of the values below.
|
Long |
|
|
The |
Long |
|
|
The directions text that will be displayed in the consuming application. |
Text |
|
|
The time the direction event occurs in coordinated universal time (UTC). |
Date |
|
|
The difference in minutes between the local time at the maneuver location and UTC time shown in the |
Double |
|
|
The name of the direction point. |
Text |
|
|
The highway exit name that appears in the directions instruction. |
Text |
|
|
The alternate source name that appears in the directions instruction. |
Text |
|
|
The name of the intersecting or cross street that appears in the directions instruction. |
Text |
|
|
The signpost branch name that appears in the directions instruction. |
Text |
|
|
The signpost toward destination name that appears in the directions instruction. |
Text |
|
|
The building level at which this direction event occurs. This value corresponds to the |
Long |
|
|
The short text that will be used as voice guidance text in the consuming application. |
Text |
|
|
The additional text, including expanded abbreviations and plurals, that will be used as voice guidance text in the consuming application. |
Text |
|
|
The bearing in degrees of the vehicle departing this point. Zero indicates north. |
Double |
DirectionLines
This is the output route lines calculated in the analysis sliced to represent each route segment between DirectionPoints events or maneuver locations.
|
Field name |
Description |
Data type |
|---|---|---|
|
|
The object ID of the feature. |
ObjectID |
|
|
The |
Long |
|
|
The |
Long |
|
|
Specifies the type of direction situation described by this line, designated by one of the following values:
|
Long |
|
|
The length of the line segment measured in meters. |
Double |
|
|
The travel time along the line segment in minutes. |
Double |
|
|
The building level at which this direction event begins. This value corresponds to the Learn more about the directions configuration of a network dataset |
Long |
|
|
The building level at which this direction event ends. This value corresponds to the |
Long |