ArcMap

FindRoutes 的输出

成功执行 FindRoutes 后，服务将返回停靠点之间的最佳路径，以及一个状态，通过如下所述的输出参数指示分析是否成功：

output_routes

将提供对生成路径的访问权限。

下表列出了输出路径返回的字段：

字段描述

Name

路径的名称基于相关停靠点的 RouteName 字段。 如果输入 RouteName 字段为空，则该名称将派生自第一个和最后一个停靠点的 Name 字段。

StopCount

分配给路径的停靠点数。

StartTime

以第一个停靠点所在的时区报告的路径起始时间。

EndTime

以最后一个停靠点所在的时区报告的路径结束时间。

StartTimeUTC

以协调世界时间 (UTC) 格式给出的路径开始时间。

EndTimeUTC

以协调世界时间 (UTC) 格式给出的路径结束时间。

Total_Minutes

从第一个停靠点开始到最后一个停靠点结束的累积行驶时间，以分钟为单位。 如果指定，这包括所访问停靠点的任何 AdditionalTime。

Total_Miles

从第一个停靠点开始到最后一个停靠点结束的累积行驶距离（以英里为单位）。 如果指定，这包括所访问停靠点的任何 AdditionalDistance。

Total_Kilometers

从第一个停靠点开始到最后一个停靠点结束的累积行驶距离（以公里为单位）。 如果指定，这包括所访问停靠点的任何 AdditionalDistance。

Total_Other

从第一个停靠点开始到最后一个停靠点结束的累积行程成本（未知单位）。 如果指定，这包括所访问停靠点的任何 AdditionalCost。

仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时，才包括该字段。

TotalWait_Minutes

该字段存储路径的总等待时间，即在停靠点处等待时间窗打开所花费的时间。

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

TotalViolation_Minutes

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

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

对于在分析期间累积的所有基于时间的成本属性，将包括附加字段 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 指的是方向字符串类型表格中的值。
  • 如果 SubItemType 的值为 3，则 Type 指的是方向字符串类型表格中的值。

Text

行驶方向的文本描述。

ElaspsedTime

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

DriveDistance

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

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

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

output_direction_points

指定分析中计算的路径的输出转弯方向，表示为沿发生特定方向事件或行进策略的路径上的点位置。

字段名描述

RouteID

与此方向点相关联的输出 output_routes 要素的　ObjectID。

Sequence

路径方向点的序列，从　1　开始。

DirectionPointType

该点描述的方向事件或行进策略的类型，由以下值之一指定。

  • 标头 (1)
  • 到达 (50)
  • 出发 (51)
  • 直线 (52)
  • 乘坐渡轮 (100)
  • 离开渡轮 (101)
  • 中央分叉口 (102)
  • 环状交叉路 (103)
  • U 形转弯 (104)
  • 门 (150)
  • 楼梯 (151)
  • 电梯 (152)
  • 自动扶梯 (153)
  • 人行坡道 (154)
  • 左侧分叉口 (200)
  • 左侧坡道 (201)
  • 顺时针环状交叉路 (202)
  • 左侧 U 形转弯 (203)
  • 左转弯 (204)
  • 左转弯 (205)
  • 向左急转 (206)
  • 左转，然后立即左转 (207)
  • 左转，然后立即右转 (208)
  • 右侧分叉口 (300)
  • 右侧坡道 (301)
  • 逆时针环状交叉路 (302)
  • 右侧 U 形转弯 (303)
  • 右转弯 (304)
  • 右转弯 (305)
  • 向右急转 (306)
  • 右转，然后立即左转 (307)
  • 右转，然后立即右转 (308)
  • 电梯上行 (400)
  • 自动扶梯上行 (401)
  • 楼梯上行 (402)
  • 电梯下行 (500)
  • 自动扶梯下行 (501)
  • 楼梯下行 (502)
  • 常规事件 (1000)
  • 地标 (1001)
  • 时区变更 (1002)
  • 交通事件 (1003)
  • 调整成本型障碍事件 (1004)
  • 边界交叉 (1005)
  • 违反限制 (1006)
  • 车道 (1007)

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

此线所描述的方向情况类型，由以下值之一指定。

  • 未知 (0)
  • 线段 (1)
  • 行进策略段 (2)
  • 违反限制 (3)
  • 调整成本型障碍 (4)
  • 交通繁忙 (5)
  • 交通畅通 (6)
  • 交通适中 (7)

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

指示该点相对于其在网络上的位置以及分析结果的状态。 可能的值如下：

  • 0（确定）- 该点已在网络上成功定位。
  • 1（未定位）- 该点未在网络上成功定位，因此未包含在分析中。
  • 2（网络元素未定位）- 未找到由该点的网络位置字段标识的网络元素。 如果删除了该点应处于的网络元素并且未对网络位置重新进行计算，则可能会出现这种情况。
  • 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 分钟。

Cumul_Miles

路径从起始点到停靠点（包括停靠点）的累积距离，以英里为单位。 此处报告的值是到停靠点的累积路径距离，包括在此停靠点和任何先前停靠点所经过的所有附加距离。

Cumul_Kilometers

路径从起始点到停靠点（包括停靠点）的累积距离，以千米为单位。 此处报告的值是到停靠点的累积路径距离，包括在此停靠点和任何先前停靠点所经过的所有附加距离。

Cumul_Cost

路径从起始点到停靠点（包括停靠点）的累积路径成本。 此处报告的值是到停靠点的累积路径成本，包括在此停靠点和任何先前停靠点所耗费的所有额外成本。 仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时，才包括该字段。 该值以未知单位表示。

Wait_Minutes

该字段存储的是路径提前到达停靠点时等待时间窗打开所花费的时间。

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

CumulWait_Minutes

该字段存储等待时间窗打开所花费的时间总和。 会测量空闲时间。 其中包括路径访问当前停靠点和所有先前停靠点花费的等待时间。

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

Violation_Minutes

该字段用于测量在时间窗关闭之后路径到达的迟到时间。 确切地说，它存储时间窗终止时与路径到达停靠点之间的时间间隔。

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

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

CumulViolation_Minutes

该字段存储路径访问当前停靠点和所有先前停靠点时的累积冲突时间。

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

对于在分析期间累积的所有基于时间的成本属性，将包括附加字段 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

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

Attr_Miles

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

Attr_Kilometers

基础街道要素遍历部分的长度，以千米为单位。

Attr_Other

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

Cumul_Minutes

路径从其原点到此基础街道要素遍历部分终点的行驶时间，以分钟为单位。

Cumul_Miles

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

Cumul_Kilometers

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

Cumul_Other

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

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 Online 或 Portal for ArcGIS 共享路径图层。 仅当保存路径数据参数设置为 True 时才填充参数值。

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

output_network_analysis_layer

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

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