“查找路径”的输出

成功执行 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 参数基于距离,且值不是 MilesKilometers,则将包括附加的 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

该字段存储路径中停靠点处的总冲突时间。如果路径在时间窗关闭之后到达停靠点,则将添加冲突时间,即为输入停靠点上 ArriveTimeTimeWindowEnd 之间的差值。

如果分析中未使用时间窗口,则该字段具有空值。

注:

如果分析对象的 timeUnits 属性未设置为 TimeUnits.Minutes,则将包括附加字段 TotalViolation_[TimeUnits]。字段值采用由 timeUnits 属性指定的单位。

对于在分析期间累积的所有基于时间的成本属性,将包括附加字段 TotalViolation_[AccumulateAttributeName]_[TimeUnits]

FirstStopOID

路径上第一个停靠点的 ObjectID 值。该字段通常用于连接输入停靠点到路径的信息。

LastStopOID

路径上最后一个停靠点的 ObjectID 值。该字段通常用于连接输入停靠点到路径的信息。

output_directions

将提供对每个生成路径转弯方向的访问权限。

方向要素的形状由路径中包括的基础街道确定。

方向语言方向距离单位,和方向样式名称参数会影响行进方向。如果填充方向参数为 False,则该参数返回空。

下表列出了输出方向返回的字段:

字段说明

RouteName

驾驶操作所应用到的路径的名称。该值与输出路径的 Name 字段值相同。

ArriveTime

开始给定驾驶操作的当日时间。如果路径跨越多天,将显示日期和时间。

Type

方向要素代表的行进策略类型或方向文本类型。要确定 Type 指的是行进策略类型还是方向字符串类型,请检查 SubItemType 字段的值。

例如,在应用程序中显示行驶方向时,Type 类型可根据行进策略类型为方向分配图标,或根据方向字符串类型使用格式样式。

Type 值是如下“行进策略类型”或“方向字符串类型”中列出的整数。

行进策略类型

  • 0:未知
  • 1:抵达停靠点
  • 2:直行
  • 3:左转弯
  • 4:右转弯
  • 5:左转
  • 6:右转
  • 7:向左急转弯
  • 8:向右急转弯
  • 9:调头
  • 10:乘坐渡轮
  • 11:进入环状交叉路
  • 12:驶入高速公路
  • 13:驶离高速公路
  • 14:驶入另一条高速公路
  • 15:在岔路口沿中间道路行驶
  • 16:在岔路口靠左侧行驶
  • 17:在岔路口靠右侧行驶
  • 18:离开停靠点
  • 19:出行方案项目
  • 20:离开渡轮
  • 21:右侧匝道
  • 22:左侧匝道
  • 23:左转,然后立即右转
  • 24:右转,然后立即左转
  • 25:右转,然后立即右转
  • 26:左转,然后立即左转

方向字符串类型

  • 0:常规方向字符串类型
  • 1:离开方向字符串类型
  • 2:到达方向字符串类型
  • 3:长度方向字符串类型
  • 4:时间方向字符串类型
  • 5:时间汇总方向字符串类型
  • 6:时间窗口方向字符串类型
  • 7:冲突时间方向字符串类型
  • 8:等待时间方向字符串类型
  • 9:服务时间方向字符串类型
  • 10:预计到达时间方向字符串类型
  • 11:累积长度方向字符串类型
  • 12:街道名称方向字符串类型
  • 13:备用街道名称方向字符串类型
  • 14:符号分支信息方向字符串类型
  • 15:符号朝向信息方向字符串类型
  • 16:十字路街道名称方向字符串类型
  • 17:符号出口编号方向字符串类型

SubItemType

指定 Type 字段指的是方向字符串类型表格中的整数,还是行进策略类型表格中的整数。

  • 如果 SubItemType 的值为 1,则 Type 指的是行进策略类型表格中的值。
  • 如果 SubItemType 的值为 2,则 Type 指的是方向字符串类型表格中的值。

Text

行驶方向的文本描述。

ElaspsedTime

当前行驶方向开始到下一行驶方向开始之时,或到上一行驶方向的路径结束之时所经历的时间,以分钟为单位。

DriveDistance

当前行驶方向开始到下一行使方向开始,或到上一行驶方向的路径结束之时所行使的距离。

该值的单位由 Directions_Distance_Units 参数指定。

如果行驶方向与下一次行驶方向开始的位置相同,则此值为零。例如,对于路径开始时的方向文本,DriveDistance 为 0。

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

指示停靠点在分析中的评估状态。此字段可用于确定尚未分配给任何路径的停靠点。可能的值如下:

  • 0(确定)- 停靠点成功定位于交通网络之上,并已进行分析。
  • 1(未定位) - 分析中未包含停靠点,因为在距离停靠点的最大搜索距离内未找到可穿越道路。
  • 3(元素不可遍历)- 停靠点所在的网络元素不可遍历。网络元素受到约束属性限制时可能会发生这种情况。
  • 4(字段值无效)- 字段值位于范围或编码值域外。例如,应该填写正数的位置可能存在负数。
  • 5(未到达)- 出于约束的原因,无法到达停靠点,例如,设置了路边通道,因此车辆必须以错误方向在单行道上行驶才能到达停靠点。
  • 6(时间窗冲突)- 无法准时到达停靠点上的时间窗;路径提前或延后到达。
  • 7(未定位在最近位置) - 由于限制或障碍致使无法遍历距停靠点最近的网络位置,因而停靠点将被置于最近的可遍历网络要素上。

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 参数基于距离,且值不是 MilesKilometers,则将包括附加的 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 要素相对于基础街道要素的数字化方向的开始位置。

  • 值为 0(零)表示线在基础街道要素的起点处开始。
  • 值为 1 表示线在街道要素的终点处开始。
  • 值在 0 到 1 之间表示线在沿基础街道要素的某一点处开始;例如,值为 0.25 表示线在数字化方向上沿基础街道要素的 25% 处开始。

ToPosition

指定输出 RouteEdges 要素相对于基础街道要素的数字化方向的结束位置。

  • 值为 0(零)表示线在基础街道要素的起点处结束。
  • 值为 1 表示线在街道要素的终点处结束。
  • 值在 0 到 1 之间表示线在沿基础街道要素的某一点处结束;例如,值为 0.25 表明线在数字化方向上沿基础街道要素的 25% 处结束。

RouteID

唯一标识遍历边的路径。

RouteID 值对应输出路径的 ObjectID 值。

Attr_Minutes

基础街道要素遍历部分的行驶时间,以分钟为单位。

注:

如果 measurement_units 参数基于时间,且值不是 Minutes,则将包括附加的 Attr_[TimeUnits] 字段。该字段值的单位由 measurement_units 参数指定。

Attr_Miles

基础街道要素遍历部分的长度,以英里为单位。

注:

如果 measurement_units 参数基于距离,且值不是 MilesKilometers,则将包括附加的 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 参数基于距离,且值不是 MilesKilometers,则将包括附加的 Cumul_[DistanceUnits] 字段。该字段值的单位由 measurement_units 参数指定。

注:

对于在分析期间累积的所有基于距离的成本属性,将包括附加字段 Cumul_[AccumulateAttributeName]。值以用于分析的距离单位表示。

Cumul_Kilometers

路径从其原点到此基础街道要素遍历部分终点的长度,以千米为单位。

Cumul_Other

路径从其原点到此基础街道要素遍历部分终点的行程成本。仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时,才包括该字段。该值以未知单位表示。

注:

对于不基于时间或距离并且在分析期间累积的所有成本属性,将包括附加字段 Cumul_[AccumulateAttributeName]

Attr_[Soft Restriction Attribute Name]

指定遍历的边是否已使用该字段名中所引用的软约束属性。

  • 0 - 遍历的边未使用软约束。
  • 1 - 遍历的边使用了软约束。

例如,如果使用名为“避开收费公路”的软约束来执行分析,则会为此软约束创建名为 Attr_Avoid_Toll_Roads 的字段。该字段的值 1 表示路径中的收费公路。

solve_succeeded

使用此参数可确定分析是否成功。

output_result_file

使用此参数可以将分析结果作为 .zip 文件(包含每个输出的一个或多个文件)进行访问。单个文件的格式由输出格式参数指定。当输出格式参数设置为要素集时,未填充参数值。

如果指定文件基于输出格式(如 JSON 文件GeoJSON 文件),则不会向显示添加输出,因为应用程序(例如 ArcMap 或 ArcGIS Pro)不会绘制结果文件的内容。相反,结果文件将下载到计算机上的临时目录中。在 ArcGIS Pro 中,可以通过查看输出结果文件参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。在 ArcMap 中,可以通过访问输出结果文件参数上的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。

output_route_data

可以使用此参数访问含有某文件地理数据库的 .zip 文件,该文件地理数据库包含相应格式的分析的输入和输出,可以使用该格式与 ArcGIS OnlinePortal for ArcGIS 共享路径图层。仅当保存路径数据参数设置为 True 时才填充参数值。

文件将下载到计算机上的临时目录中。在 ArcGIS Pro 中,可以通过查看输出路径数据参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。在 ArcMap 中,可以通过访问输出路径数据参数上的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。

output_network_analysis_layer

使用此参数可访问存储分析设置以及用于分析输入和输出的网络分析图层文件。仅当保存输出网络分析图层参数设置为 True 时才填充参数值。

文件将下载到计算机上的临时目录中。在 ArcGIS Pro 中,可以通过查看输出网络分析图层参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。在 ArcMap 中,可以通过访问输出网络分析图层参数上的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。

注:

由于数据源无效,因此即使在 ArcGIS Desktop 应用程序(例如 ArcMap)中打开文件,也无法直接使用此文件。需要将该文件发送至 Esri 技术支持以诊断工具所返回结果的质量。