成功执行后,服务将返回停靠点之间的最佳路径,以及一个状态,通过以下输出参数指示分析是否成功:
output_routes
使用此参数可访问停靠点之间生成的一条或多条路径。
以下提供针对各个路径返回的字段说明:
字段名 | 描述 |
---|---|
OID | 路径的唯一标识符。该标识符由服务自动生成。 |
Name | 路径的名称基于相关停靠点的 RouteName 字段。如果输入 RouteName 字段为空,则该名称将派生自第一个和最后一个停靠点的 Name 字段。 |
StopCount | 分配给路径的停靠点数。 |
Total_Minutes | 停靠点之间路径的累积行驶时间,以分钟为单位。 |
FirstStopOID | 路径上第一个停靠点的 ObjectID 值。该字段通常用于连接输入停靠点到路径的信息。 |
LastStopOID | 路径上最后一个停靠点的 ObjectID 值。该字段通常用于连接输入停靠点到路径的信息。 |
Total_Kilometers | 停靠点之间路径的累积行驶距离,以千米为单位。 |
Total_Miles | 停靠点之间路径的累积行驶距离,以英里为单位。 |
Shape_Length | 路径长度,单位采用针对路径几何指定的空间参考。如果未指定 env:outSR 参数,则默认采用十进制度来报告长度。 |
output_directions
使用此参数可访问停靠点之间各个生成的路径的逐步行驶方向。此参数包括行驶方向以及文本相应方向要素的几何。方向要素的形状由路径中包括的基础街道确定。要素几何会以指定为 env:outSR 参数的空间参考的形式返回。如果 populate_directions 参数为 false,则要素为空。directions_language、directions_distance_units、 和 directions_style_name 参数会对行驶方向造成极大影响。
以下为针对方向要素返回的字段的说明:
字段名 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ObjectID | 方向要素的唯一标识符。该标识符由服务自动生成。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RouteName | 驾驶操作所应用到的路径的名称。该值与 output_routes 参数的 Name 属性值相同。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ArriveTime | 每天启动给定驾驶操作的时间。如果路径跨越多天,将显示日期和时间。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
类型 | 指示方向要素代表的行进策略类型或方向文本类型。要确定 Type 指的是行进策略类型还是方向字符串类型,请检查 SubItemType 字段的值。 例如,在应用程序中显示行驶方向时,Type 类型可根据行进策略类型为方向分配不同的图标,,或根据方向字符串类型使用特殊格式样式。 Type 值是如下所示行进策略类型或方向字符串类型表格中列出的整数。 行进策略类型
方向字符串类型
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SubItemType | 指定 Type 字段指的是方向字符串类型表格中的整数,还是行进策略类型表格中的整数。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
文本 | 行驶方向的文本描述。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ElaspsedTime | 当前行驶方向开始到下一行驶方向开始之时,或到上一行驶方向的路径结束之时所经历的时间,以分钟为单位。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DriveDistance | 当前行驶方向开始到下一行驶方向开始,或到上一行驶方向的路径结束之时所行驶的距离。该值的单位由 distance_units 参数指定。 如果行驶方向与下一次行驶方向开始的位置相同,则此值为零。例如,对于路径开始时的方向文本,DriveDistance 为 0。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Shape_Length | 方向要素的长度,单位采用针对路径指定的空间参考。如果未指定 env:outSR 参数,则默认采用十进制度来报告长度。 |
output_stops
使用此参数可以访问路径所途经的一个多个停靠点的属性,以及任何路径无法到达的停靠点。对于能够达到的停靠点,属性表将列出分配到这些停靠点的路径名称、停靠顺序、到达时间和其他信息。对于无法到达的停靠点,属性表将提供有关问题原因的信息。
以下为针对各个停靠点返回的属性说明:
字段名 | 描述 |
---|---|
OID | 停靠点的唯一标识符。该标识符由服务自动生成。 |
Name | 路径所访问的停靠点的名称。 |
RouteName | 分配给停靠点的路径的名称。 在运行工具时,具有相同路径名称的输入停靠点将分组到一起并通过一条路径访问,且系统将为该路径分配此路径名称。当输入停靠点上存在多个路径名称时,工具可输出多条路径 - 每个唯一路径名称对应一条路径。 如果不存在任何名称,则所有停靠点均将分配到同一路径。 |
Sequence | 由分配路径访问停靠点的顺序在 RouteName 字段中列出。 |
TimeWindowStart | 路径可途经此停靠点的最早时间。此字段的值从输入停靠点上的 TimeWindowStart 字段中复制。 |
TimeWindowEnd | 路径可途经此停靠点的最晚时间。此字段的值从输入停靠点上的 TimeWindowEnd 字段中复制。 |
ArriveCurbApproach | 指示车辆到达停靠点时路边通道位于车辆哪一侧。 |
DepartCurbApproach | 指示车辆离开停靠点时路边通道位于车辆哪一侧。 |
LocationType | 指示停靠点类型。此字段的值从输入停靠点上的 LocationType 字段中复制。 |
CurbApproach | 车辆可能到达和离开停靠点的方向。此字段的值从输入停靠点上的 CurbApproach 字段中复制。 |
Status | 指示停靠点在分析中的评估状态。此字段可用于确定尚未分配给任何路径的停靠点。可能的值如下:
|
AdditionalTime | 访问此停靠点时添加到总路径时间中的时间量。此字段的值从输入停靠点上的 AdditionalTime 字段中复制。 仅当 Measurement Units 参数的值基于时间时,才会包括此字段。 |
AdditionalDistance | 访问此停靠点时添加到总路径距离中的距离量。此字段的值从输入停靠点上的 AdditionalDistance 字段中复制。 仅当 Measurement Units 参数的值基于距离时,才会包括此字段。 |
Cumul_Minutes | 路径从起始点到停靠点(包括停靠点)的累积持续时间,以分钟为单位。此处报告的值是到停靠点的累积路径时间,包括在此停靠点和任何先前停靠点所耗费的所有附加时间。 |
ORIG_FID | 输入停靠点的 ObjectID。此字段可用于将属性从输出停靠点连接到输入停靠点,或从输入停靠点连接到输出停靠点。 |
Cumul_Kilometers | 路径从起始点到停靠点(包括停靠点)的累积距离,以千米为单位。此处报告的值是到停靠点的累积路径距离,包括在此停靠点和任何先前停靠点所经过的所有附加距离。 |
Cumul_Miles | 路径从起始点到停靠点(包括停靠点)的累积距离,以英里为单位。此处报告的值是到停靠点的累积路径距离,包括在此停靠点和任何先前停靠点所经过的所有附加距离。 |
output_route_edges
使用此参数可以访问路径途经的各个路段。
以下为针对各个路径边返回的属性说明:
字段名 | 描述 |
---|---|
OID | 路径边的唯一标识符。该标识符由服务自动生成。 |
Shape | 指示线形状的几何字段。 |
SourceName | 从其中生成线的边源要素类的名称。 |
SourceOID | 遍历的街道要素的 ObjectID。汇总此字段的值可以提供有用的信息,例如特定街道要素包括在所有路径中的次数。 |
RouteEdgeID | 表示组成街道要素的边的 ID。由于每个街道要素可以有多个边,因此 SourceOID 字段可用于唯一标识遍历的街道要素,RouteEdgeID 字段可用于唯一标识遍历的街道要素内的边。 |
FromPosition | 指定输出 RouteEdges 要素相对于基础街道要素的数字化方向的开始位置。
|
ToPosition | 指定输出 RouteEdges 要素相对于基础街道要素的数字化方向的结束位置。
|
RouteID | 唯一标识遍历边的路径。RouteID 值对应 output_routes 要素类的 ObjectID 值。 |
Attr_Minutes | 基础街道要素遍历部分的行驶时间,以分钟为单位。 |
Attr_Miles | 基础街道要素遍历部分的长度,以英里为单位。 |
Attr_Kilometers | 基础街道要素遍历部分的长度,以千米为单位。 |
Cumul_Minutes | 路径从其原点到此基础街道要素遍历部分终点的行驶时间,以分钟为单位。 |
Cumul_Miles | 路径从其原点到此基础街道要素遍历部分终点的长度,以英里为单位。 |
Cumul_Kilometers | 路径从其原点到此基础街道要素遍历部分终点的长度,以千米为单位。 |
Attr_[软约束属性名称] | 指定遍历的边是否已使用该字段名中所引用的软约束属性。
例如,如果使用名为“避开收费公路”的软约束来执行分析,则会为此软约束创建名为 Attr_Avoid_Toll_Roads 的字段。该字段的值 1 表示路径中的收费公路。 |
Shape_Length | 路径边的长度,单位采用针对路径几何指定的空间参考。 |
solve_succeeded
此参数可用于确定服务是否能够成功找到路径。可请求获取作业的状态,以此获取失败的错误消息。