成功执行 FindRoutes 后,服务将返回停靠点之间的最佳路径,以及一个状态,通过如下所述的输出参数指示分析是否成功:
output_routes
将提供对生成路径的访问权限。
下表列出了输出路径返回的字段:
字段 | 描述 |
---|---|
Name | 路径的名称基于相关停靠点的 RouteName 字段。 如果输入 RouteName 字段为空,则该名称将派生自第一个和最后一个停靠点的 Name 字段。 |
StopCount | 分配给路径的停靠点数。 |
StartTime | 以第一个停靠点所在的时区报告的路径起始时间。 |
EndTime | 以最后一个停靠点所在的时区报告的路径结束时间。 |
StartTimeUTC | 以协调世界时间 (UTC) 格式给出的路径开始时间。 |
EndTimeUTC | 以协调世界时间 (UTC) 格式给出的路径结束时间。 |
Total_Minutes | 从第一个停靠点开始到最后一个停靠点结束的累积行驶时间,以分钟为单位。 这包括所访问的停靠点任何 AdditionalTime 值(如果指定)。 注:如果 measurement_units 基于时间,且其值未设置为 Minutes,则将包括附加字段 Total_[TimeUnits]。 该字段值的单位由 measurement_units 参数指定。 注:对于在分析期间累积的所有基于时间的成本属性,将包括附加字段 Total_[AccumulateAttributeName]_[TimeUnits]。 |
Total_Miles | 从第一个停靠点开始到最后一个停靠点结束的累积行驶距离(以英里为单位)。 这包括所访问的停靠点任何 AdditionalDistance 值(如果指定)。 注:如果 measurement_units 参数基于距离,且值不是 Miles 或 Kilometers,则将包括附加字段 Total_[DistanceUnits]。 该字段值的单位由 measurement_units 参数指定。 注:对于在分析期间累积的所有基于距离的成本属性,将包括附加字段 Total_[AccumulateAttributeName]_[DistanceUnits]。 |
Total_Kilometers | 从第一个停靠点开始到最后一个停靠点结束的累积行驶距离(以公里为单位)。 这包括所访问的停靠点任何 AdditionalDistance 值(如果指定)。 |
Total_Other | 从第一个停靠点开始到最后一个停靠点结束的累积行程成本(未知单位)。 这包括所访问的停靠点任何 AdditionalCost 值(如果指定)。 仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时,才包括该字段。 注:对于不基于时间或距离并且在分析期间累积的所有成本属性,将包括附加字段 Total_[AccumulateAttributeName]_Other。 |
TotalWait_Minutes | 该字段存储路径的总等待时间,即在停靠点处等待时间窗打开所花费的时间。 如果分析中未使用时间窗口,则该字段具有空值。 注:如果未将 measurement_units 参数设置为 Minutes,则将包括 TotalWait_[TimeUnits] 附加字段。 该字段值的单位由 measurement_units 参数指定。 注:对于在分析期间累积的所有基于时间的成本属性,将包括附加字段 TotalWait_[AccumulateAttributeName]_[TimeUnits]。 |
TotalViolation_Minutes | 该字段存储路径中停靠点处的总冲突时间。 如果路径在时间窗关闭之后到达停靠点,则将添加冲突时间,即为输入停靠点上 ArriveTime 与 TimeWindowEnd 字段值之间的差值。 如果分析中未使用时间窗口,则该字段具有空值。 注:如果分析对象的 timeUnits 属性未设置为 TimeUnits.Minutes,则将包括附加字段 TotalViolation_[TimeUnits]。 字段值采用由 timeUnits 属性指定的单位。 对于在分析期间累积的所有基于时间的成本属性,将包括附加字段 TotalViolation_[AccumulateAttributeName]_[TimeUnits]。 |
FirstStopID | 路径上第一个停靠点的分析自动生成的唯一标识符。 |
FirstStopOID | 路径上第一个停靠点的 ObjectID 值。 该字段通常用于连接输入停靠点到路径的信息。 |
LastStopID | 路径上最后一个停靠点的分析自动生成的唯一标识符。 |
LastStopOID | 路径上最后一个停靠点的 ObjectID 值。 该字段通常用于连接输入停靠点到路径的信息。 |
output_directions
将提供对每个生成路径转弯方向的访问权限。
方向要素的形状由路径中包括的基础街道确定。
方向语言、方向距离单位和方向样式名称参数会影响行进方向。 如果填充方向参数设置为 False,则该参数返回空要素。
下表列出了输出方向返回的字段:
字段 | 描述 |
---|---|
RouteName | 驾驶操作所应用到的路径的名称。 该值与输出路径的 Name 字段值相同。 |
ArriveTime | 开始给定驾驶操作的当日时间。 如果路径跨越多天,则会显示日期和时间。 |
Type | 路线要素代表的行进策略类型或路线文本类型。 要确定 Type 指的是行进策略类型还是路线字符串类型,可查看 SubItemType 字段值。 Type 例如,在应用程序中显示行驶路线时,此字段可根据行进策略类型为路线文本分配图标,或根据路线字符串类型使用格式化样式。 Type 值是下方“行进策略类型”或“路线字符串类型”列表中的整数。 行进策略类型
方向字符串类型
|
SubItemType | 指定 Type 字段指的是方向字符串类型表格中的整数,还是行进策略类型表格中的整数。
|
Text | 行驶路线的文本描述。 |
ElaspsedTime | 当前行驶方向开始到下一行驶方向开始之时,或到上一行驶方向的路径结束之时所经历的时间,以分钟为单位。 |
DriveDistance | 当前行驶方向开始到下一行驶方向开始,或到上一行驶方向的路径结束之时所行驶的距离。 该值的单位由 Directions_Distance_Units 参数指定。 如果行驶路线与下一个行驶路线开始的位置相同,则此值为零。 例如,对于路径开始时的路线文本,DriveDistance 值为 0。 |
output_direction_points
指定分析中计算的路径的输出转弯方向,表示为沿发生特定方向事件或行进策略的路径上的点位置。
字段名 | 描述 |
---|---|
RouteID | 与此方向点相关联的输出 output_routes 要素的 ObjectID。 |
Sequence | 路径方向点的序列,从 1 开始。 |
DirectionPointType | 该点描述的方向事件或行进策略的类型,由以下值之一指定。
|
StopID | 与此方向点相关联的停靠点(如果存在)的 ObjectID。 如果该点并不代表对停靠点的访问,则该值为空。 |
DisplayText | 在使用应用程序中要显示的方向文本。 |
ArrivalTime | 方向事件的发生时间,采用调世界时间 (UTC) 格式。 |
ArrivalUTCOffset | 行进策略位置处的当地时间与 ArrivalTime 字段中显示的 UTC 时间之间的差值。 |
Name | 方向点的名称。 |
ExitName | 方向说明中显示的高速公路出口名称。 |
AlternateName | 方向说明中显示的备用源名称。 |
IntersectingName | 方向说明中显示的相交街道或十字路街道的名称。 |
BranchName | 方向说明中显示的路标分支名称。 |
TowardName | 方向说明中显示的指向目的地名称的路标。 |
Level | 发生此方向事件的建筑物级别。 该值对应于在用于分析的网络数据集中定义的 Level 属性。 |
ShortVoiceInstruction | 在使用应用程序中用作语音导航文本的短文本。 |
VoiceInstruction | 其他文本,包括展开的缩写和复数形式,以在使用应用程序中用作语音导航文本。 |
Azimuth | 偏离此点的车辆的方位角,以度为单位。 零指示北向。 |
output_direction_lines
指定在经过剖切的分析中计算的输出路径线,以表示 DirectionPoints 事件或行进策略位置之间的每个路径段。
字段名 | 描述 |
---|---|
DirectionPointID | 与此线相关联的 output_direction_points 表中要素的 ObjectID。 |
RouteID | 与此方向线相关联的输出 output_routes 要素的 ObjectID。 |
DirectionLineType | 此线所描述的方向情况类型,由以下值之一指定:
|
Meters | 线段的长度,以米为单位。 |
Minutes | 沿线段的行驶时间,以分钟为单位。 |
FromLevel | 开始此方向事件的建筑物级别。 该值对应于在用于分析的网络数据集中定义的 Level 属性。 |
ToLevel | 结束此方向事件的建筑物级别。 该值对应于在用于分析的网络数据集中定义的 Level 属性。 |
output_stops
将提供对路径所途径的停靠点以及任何路径无法到达的停靠点的属性的访问权限。
您可以使用此参数中的属性,例如 Status 字段,来确定未将停靠点分配给任何路径的原因。
下表列出了输出停靠点返回的字段: 除了这些字段外,参数还包括输入要素类中用作分析停靠点的所有字段。
字段 | 描述 |
Name | 路径所访问的停靠点的名称。 此字段的值从输入停靠点上的 Name 字段中复制。 |
RouteName | 分配给停靠点的路径的名称。 在运行工具时,具有相同路径名称的输入停靠点将分组到一起并通过一条路径访问,且系统将为该路径分配此路径名称。 当输入停靠点上存在多个路径名称时,工具可输出多条路径 - 每个唯一路径名称对应一条路径。 如果不存在任何名称,则所有停靠点均将分配到同一路径。 |
Sequence | 由分配路径访问停靠点的顺序,其在 RouteName 字段中列出。 |
TimeWindowStart | 路径可途经此停靠点的最早时间。 此字段的值从输入停靠点上的 TimeWindowStart 字段中复制。 |
TimeWindowEnd | 路径可途经此停靠点的最晚时间。 此字段的值从输入停靠点上的 TimeWindowEnd 字段中复制。 |
ArriveCurbApproach | 车辆到达停靠点时路边通道位于车辆哪一侧。 |
DepartCurbApproach | 车辆离开停靠点时路边通道位于车辆哪一侧。 |
ArriveTime | 指示到达停靠点时的日期和时间值。 此时间值的时区取自停靠点所在的网络元素。 |
DepartTime | 指示离开停靠点时的日期和时间值。 此时间值的时区取自停靠点所在的网络元素。 |
ArriveTimeUTC | 指示到达停靠点时的日期和时间值。 此时间值的时区取自停靠点所在的网络元素。 |
DepartTimeUTC | 表示出发时的日期和时间值,以协调世界时间 (UTC) 给出 |
LocationType | 停靠点类型。 此字段的值从输入停靠点上的 LocationType 字段中复制。 |
SourceID | 输入点所在的网络数据集源要素类的数字标识符。 |
SourceOID | 输入点所在的源中要素的 ObjectID。 |
PosAlong | 沿源线要素的数字化方向的位置点。该值以比率形式存储。如果网络位置引用交汇点,则此字段将为空。 |
SideOfEdge | 相对于线要素的数字化方向的边侧。此字段被限制为具有两个值的属性域:右侧 (1) 和左侧 (2)。 |
CurbApproach | 车辆可能到达和离开停靠点的方向。 此字段的值从输入停靠点上的 CurbApproach 字段中复制。 |
Status | 指示该点相对于其在网络上的位置以及分析结果的状态。 可能的值如下:
|
SnapX | 在网络数据集的坐标系中,网络数据集中该点所在位置的 x 坐标。 |
SnapY | 在网络数据集的坐标系中,网络数据集中该点所在位置的 y 坐标。 |
SnapZ | 在网络数据集的坐标系中,网络数据集中该点所在位置的 z 坐标。如果网络为二维网络,则 SnapZ 字段将为 0。 |
DistanceToNetworkInMeters | 点的地理位置与其在网络上的位置之间的距离,以米为单位。 |
AdditionalTime | 访问此停靠点时添加到总路径时间中的时间量。 此字段的值从输入停靠点上的 AdditionalTime 字段中复制。 |
AdditionalDistance | 访问此停靠点时添加到总路径距离中的距离量。 此字段的值从输入停靠点上的 AdditionalDistance 字段中复制。 |
AdditionalCost | 访问此停靠点时添加到总路径成本中的成本。 此字段的值从输入停靠点上的 AdditionalCost 字段中复制。 仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时,才包括该字段。 |
Cumul_Minutes | 路径从起始点到停靠点(包括停靠点)的累积持续时间,以分钟为单位。 此处报告的值是到停靠点的累积路径时间,包括在此停靠点和任何先前停靠点所耗费的所有附加时间。 例如,如果路径分析确定要花费 10 分钟访问两个停靠点,且第二个停靠点的 AdditionalTime 值为 5,则 Cumul_Minutes 值将为 15 分钟。 注:如果 measurement_units 参数基于时间,且其值未设置为 Minutes,则将包括附加字段 Cumul_[TimeUnits]。 该字段值的单位由 measurement_units 参数指定。 注:对于在分析期间累积的所有基于时间的成本属性,将包括附加字段 Cumul_[AccumulateAttributeName]_[TimeUnits]。 |
Cumul_Miles | 路径从起始点到停靠点(包括停靠点)的累积距离,以英里为单位。 此处报告的值是到停靠点的累积路径距离,包括在此停靠点和任何先前停靠点所经过的所有附加距离。 注:如果 measurement_units 参数基于距离,且值不是 Miles 或 Kilometers,则将包括附加字段 Cumul_[DistanceUnits]。 该字段值的单位由 measurement_units 参数指定。 注:对于在分析期间累积的所有基于距离的成本属性,将包括附加字段 Cumul_[AccumulateAttributeName]_[DistanceUnits]。 |
Cumul_Kilometers | 路径从起始点到停靠点(包括停靠点)的累积距离,以千米为单位。 此处报告的值是到停靠点的累积路径距离,包括在此停靠点和任何先前停靠点所经过的所有附加距离。 |
Cumul_Cost | 路径从起始点到停靠点(包括停靠点)的累积路径成本。 此处报告的值是到停靠点的累积路径成本,包括在此停靠点和任何先前停靠点所耗费的所有额外成本。 仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时,才包括该字段。 该值以未知单位表示。 注:对于不基于时间或距离并且在分析期间累积的所有成本属性,将包括附加字段 Cumul_[AccumulateAttributeName]_Other。 |
Wait_Minutes | 该字段存储的是路径提前到达停靠点时等待时间窗打开所花费的时间。 如果分析中未使用时间窗口,则该字段具有空值。 注:如果 measurement_units 参数基于时间,且其值未设置为 Minutes,则将包括附加字段 Wait_[TimeUnits]。 该字段值的单位由 measurement_units 参数指定。 注:对于在分析期间累积的所有基于时间的成本属性,将包括附加字段 Wait_[AccumulateAttributeName]_[TimeUnits]。 |
CumulWait_Minutes | 该字段存储等待时间窗打开所花费的时间总和。 会测量空闲时间。 其中包括路径访问当前停靠点和所有先前停靠点花费的等待时间。 如果分析中未使用时间窗口,则该字段具有空值。 注:如果 measurement_units 参数基于时间,且其值未设置为 Minutes,则将包括附加字段 CumulWait_[TimeUnits]。 该字段值的单位由 measurement_units 参数指定。 注:对于在分析期间累积的所有基于时间的成本属性,将包括附加字段 CumulWait_[AccumulateAttributeName]_[TimeUnits]。 |
Violation_Minutes | 该字段用于测量在时间窗关闭之后路径到达的迟到时间。 确切地说,它存储时间窗终止时与路径到达停靠点之间的时间间隔。 如果分析中未使用时间窗口,则该字段具有空值。 注:如果 measurement_units 参数基于时间,且其值未设置为 Minutes,则将包括附加字段 Violation_[TimeUnits]。 该字段值的单位由 measurement_units 参数指定。 对于在分析期间累积的所有基于时间的成本属性,将包括附加字段 Violation_[AccumulateAttributeName]_[TimeUnits]。 |
CumulViolation_Minutes | 该字段存储路径访问当前停靠点和所有先前停靠点时的累积冲突时间。 如果分析中未使用时间窗口,则该字段具有空值。 注:如果 measurement_units 参数基于时间,且其值未设置为 Minutes,则将包括附加字段 CumulViolation_[TimeUnits]。 该字段值的单位由 measurement_units 参数指定。 注:如果分析对象的 timeUnits 属性未设置为 TimeUnits.Minutes,则将包括附加字段 CumulViolation_[TimeUnits]。 字段值采用由 timeUnits 属性指定的单位。 对于在分析期间累积的所有基于时间的成本属性,将包括附加字段 CumulViolation_[AccumulateAttributeName]_[TimeUnits]。 |
ORIG_FID | 输入停靠点的 ObjectID 值。 此字段可用于将属性从输出停靠点连接到输入停靠点,或从输入停靠点连接到输出停靠点。 |
Bearing | 此字段的值从输入停靠点上的 Bearing 字段中复制。 |
BearingTol | 此字段的值从输入停靠点上的 BearingTol 字段中复制。 |
NavLatency | 此字段的值从输入停靠点上的 NavLatency 字段中复制。 |
output_route_edges
将提供对路径途径的各个网络边的访问权限。
将 populate_route_edges 参数设置为 True 时此参数仅包含值。
下表列出了输出路径边支持的字段:
字段 | 描述 |
---|---|
SourceName | 生成线时基于的边源要素类的名称。 |
SourceOID | 遍历的街道要素的 ObjectID 值。 汇总此字段的值可以提供有用的信息,例如特定街道要素包括在所有路径中的次数。 |
RouteEdgeID | 表示组成街道要素的边的 ID。 由于每个街道要素可以有多个边,因此 SourceOID 字段可用于唯一标识遍历的街道要素,RouteEdgeID 字段可用于唯一标识遍历的街道要素内的边。 |
FromPosition | 指定输出 RouteEdges 要素相对于基础街道要素的数字化方向的开始位置。
|
ToPosition | 指定输出 RouteEdges 要素相对于基础街道要素的数字化方向的结束位置。
|
FromJunctionID | RouteJunctions 要素类中与 RouteEdges 要素的起点重合的要素 ObjectID。 |
ToJunctionID | RouteJunctions 要素类中与 RouteEdges 要素的终点重合的要素 ObjectID。 |
RouteID | 唯一标识遍历边的路径。 RouteID 值对应输出路径的 ObjectID 值。 |
Attr_Minutes | 基础街道要素遍历部分的行驶时间,以分钟为单位。 注:如果 measurement_units 参数基于时间,且其值未设置为 Minutes,则将包括附加字段 Attr_[TimeUnits]。 该字段值的单位由 measurement_units 参数指定。 |
Attr_Miles | 基础街道要素遍历部分的长度,以英里为单位。 注:如果 measurement_units 参数基于距离,且值不是 Miles 或 Kilometers,则将包括附加字段 Attr_[DistanceUnits]。 该字段值的单位由 measurement_units 参数指定。 |
Attr_Kilometers | 基础街道要素遍历部分的长度,以千米为单位。 |
Attr_Other | 基础街道要素遍历部分的行程成本。 仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时,才包括该字段。 该值以未知单位表示。 注:对于不基于时间或距离并且在分析期间累积的所有成本属性,将包括附加字段 Attr_[AccumulateAttributeName]。 |
Cumul_Minutes | 路径从其原点到此基础街道要素遍历部分终点的行驶时间,以分钟为单位。 注:如果 measurement_units 参数基于时间,且其值未设置为 Minutes,则将包括附加字段 Cumul_[TimeUnits]。 该字段值的单位由 measurement_units 参数指定。 注:对于在分析期间累积的所有基于时间的成本属性,将包括附加字段 Cumul_[AccumulateAttributeName]。 值以用于分析的时间单位表示。 |
Cumul_Miles | 路径从其原点到此基础街道要素遍历部分终点的长度,以英里为单位。 注:如果 measurement_units 参数基于距离,且值不是 Miles 或 Kilometers,则将包括附加字段 Cumul_[DistanceUnits]。 该字段值的单位由 measurement_units 参数指定。 注:对于在分析期间累积的所有基于距离的成本属性,将包括附加字段 Cumul_[AccumulateAttributeName]。 值以用于分析的距离单位表示。 |
Cumul_Kilometers | 路径从其原点到此基础街道要素遍历部分终点的长度,以千米为单位。 |
Cumul_Other | 路径从其原点到此基础街道要素遍历部分终点的行程成本。 仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时,才包括该字段。 该值以未知单位表示。 注:对于不基于时间或距离并且在分析期间累积的所有成本属性,将包括附加字段 Cumul_[AccumulateAttributeName]。 |
Attr_[Soft Restriction Attribute Name] | 指定遍历的边是否已使用该字段名中所引用的软约束属性。
例如,如果使用名为“避开收费公路”的软约束来执行分析,则会为此软约束创建名为 Attr_Avoid_Toll_Roads 的字段。 该字段的值 1 表示路径中的收费公路。 |
solve_succeeded
使用此参数可确定分析是否成功。
output_result_file
使用此参数可以将分析结果作为 .zip 文件(包含每个输出的一个或多个文件)进行访问。 单个文件的格式由输出格式参数指定。 当输出格式参数设置为要素集时,未填充参数值。
如果指定文件基于输出格式(如 JSON 文件或 GeoJSON 文件),则不会向显示添加输出,因为应用程序(例如 ArcMap 或 ArcGIS Pro)不会绘制结果文件的内容。 相反,结果文件将下载到计算机上的临时目录中。 在 ArcGIS Pro 中,可以通过查看输出结果文件参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。 在 ArcMap 中,可以通过访问输出结果文件参数的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。
output_route_data
使用此参数可访问含有某文件地理数据库的 .zip 文件,该文件地理数据库包含相应格式的分析的输入和输出,可以使用该格式与 ArcGIS Online 或 Portal for ArcGIS 共享路径图层。 仅当保存路径数据参数设置为 True 时才填充参数值。
文件将下载到计算机上的临时目录中。 在 ArcGIS Pro 中,可以通过查看输出路径数据参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。 在 ArcMap 中,可以通过访问输出路径数据参数的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。
output_network_analysis_layer
使用此参数可访问存储分析设置以及用于分析输入和输出的网络分析图层文件。 仅当保存输出网络分析图层参数设置为 True 时才填充参数值。
文件将下载到计算机上的临时目录中。 在 ArcGIS Pro 中,可以通过查看输出网络分析图层参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。 在 ArcMap 中,可以通过访问输出网络分析图层参数的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。
注:
由于数据源无效,因此即使在 ArcGIS Desktop 应用程序(例如 ArcMap)中打开文件,也无法直接使用此文件。 需要将该文件发送至 Esri 技术支持以诊断工具所返回结果的质量。