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

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

output_origin_destination_lines

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

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

参数支持以下字段:

字段说明

OriginOID

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

DestinationOID

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

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(未定位) - 分析中未包含起始点,因为在距离起始点的最大搜索距离内未找到可穿越道路。
  • 3(元素不可遍历)- 起始点所在的网络元素不可遍历。网络元素受到约束属性限制时可能会发生这种情况。
  • 4(字段值无效)- 字段值位于范围或编码值域外。例如,应该填写正数的位置可能存在负数。
  • 5(未到达)- 出于约束的原因,起始点找不到指向任意目的地的路径;例如,设置了路边通道,因此车辆必须以错误方向在单行道上行驶才能到达目的地或以指定行驶时间或行驶距离为基础的中断内无目的地。
  • 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(未定位) - 分析中未包含目的地,因为在距离目的地的最大搜索距离内未找到可穿越道路。
  • 3(元素不可遍历)- 目的地所在的网络元素不可遍历。网络元素受到约束属性限制时可能会发生这种情况。
  • 4(字段值无效)- 字段值位于范围或编码值域外。例如,应该填写正数的位置可能存在负数。
  • 5(未到达)- 出于约束的原因,无法到达目的地;例如,设置了路边通道,因此车辆必须以错误方向在单行道上行驶才能到达目的地或以指定行驶时间或行驶距离为基础的中断内无目的地。
  • 7(未定位在最近位置) - 由于限制或障碍致使无法遍历距目的地最近的网络位置,因而目的地将被置于最近的可遍历网络要素上。

SnapX

在网络数据集的坐标系中,网络数据集中该点所在位置的 x 坐标。

SnapY

在网络数据集的坐标系中,网络数据集中该点所在位置的 y 坐标。

SnapZ

在网络数据集的坐标系中,网络数据集中该点所在位置的 z 坐标。如果网络为二维网络,则 SnapZ 字段将为 0。

DistanceToNetworkInMeters

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

Bearing

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

BearingTol

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

NavLatency

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

solve_succeeded

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

output_result_file

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

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

output_network_analysis_layer

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

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

注:

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