起点-目的地成本矩阵的输出

成功执行后,服务会返回连接各个起始点和目的地对的线、输出起始点、输出目的地,以及分析是否成功的状态。 此信息在下述输出参数中输出。

output_origin_destination_lines

将提供对连接起点和目的地的线的访问权限。

线包括给定起始点和目的地对之间总行驶时间和行驶距离的信息。

参数支持以下字段:

字段描述

OriginID

分析自动生成的关联起点的唯一标识符。

OriginOID

相应输入起点要素的 ObjectID 值。 该值可用于连接输入起始点间的其他属性和起始点目的地线。

DestinationID

分析自动生成的关联目的地的唯一标识符。

DestinationOID

相应输入目的地要素的 ObjectID 值。 该值可用于连接输入目的地间的其他属性和起始点目的地线。

DestinationRank

为关联原点找到的所有目标中各目标的等级。 离起始点最近的目的地的等级为 1。

Total_Time

沿关联起始点和目的地间街道网络的行驶时间。

该字段值以时间单位参数指定的单位为单位。

注:

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

Total_Distance

沿关联起始点和目的地间街道网络的行驶距离。

该字段值以距离单位参数指定的单位为单位。

注:

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

Total_Other

沿关联起点和目的地间街道网络的行程成本(未知单位)。

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

OriginName

相应输入起始点要素的名称。 仅在输入起始点中指定 Name 字段,且至少一个起始点拥有有效名称时,才包括该字段。 如果某些起点未指定名称,则为这些起点自动生成以 Location 为前缀的名称。

DestinationName

相应输入目的地要素的名称。 仅在输入目的地中指定 Name 字段,且至少一个目的地拥有有效名称时,才包括该字段。 如果某些目的地未指定名称,则为这些目的地自动生成以 Location 为前缀的名称。

output_origins

将提供有关分析中使用的起点信息,例如从给定起点到达的目的地总数或分析中不包含的起点。

参数支持以下字段。 除了这些字段外,参数还包括输入源中用作分析的所有字段。

字段

描述

Name

起点的名称。 如果起点的名称指定为 Name 字段的一部分,则该字段与原点的值相同。 否则,将包含一个自动生成的前缀为 Location 的值。

OriginOID

相应输入起点要素的 ObjectID 值。 该值可用于连接其他属性和输入起始点。

DestinationCount

从起始点抵达的目的地数。

TargetDestinationCount

相应输入起点中 TargetDestinationCount 字段的值。

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

点的地理位置与其在网络上的位置之间的距离,以米为单位。

Cutoff

相应输入起点中 Cutoff 字段的值。

TargetDestinationCount

相应输入起点中 TargetDestinationCount 字段的值。

Bearing

此字段的值从输入设施点的 Bearing 字段中复制。

BearingTol

此字段的值从输入设施点的 BearingTol 字段中复制。

NavLatency

此字段的值从输入设施点的 NavLatency 字段中复制。

output_destinations

将提供有关分析中使用的目的地信息,例如从给定起点到达的起点总数或分析中不包含的目的地。

参数支持以下字段。 除了这些字段外,参数还包括输入目的地中用作分析的所有字段。

字段

描述

Name

目的地的名称。 如果起点的名称指定为 Name 字段的一部分,则该字段与起点的值相同。 否则,将包含一个自动生成的前缀为 Location 的值。

DestinationOID

相应输入目的地要素的 ObjectID 值。 该值可用于连接其他属性和输入目的地。

OriginCount

已抵达目的地的起始点数。

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

点的地理位置与其在网络上的位置之间的距离,以米为单位。

Bearing

此字段的值从输入设施点的 Bearing 字段中复制。

BearingTol

此字段的值从输入设施点的 BearingTol 字段中复制。

NavLatency

此字段的值从输入设施点的 NavLatency 字段中复制。

solve_succeeded

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

output_result_file

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

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

output_network_analysis_layer

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

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

注:

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