生成服务区的输出

成功执行后,服务将返回设施点周围的服务区、输出设施点,以及一个状态,通过以下输出参数指示分析是否成功:

service_areas

将提供对面要素的访问权限,这些面要素表示在给定的行驶时间、行驶距离或行程成本范围内可从输入位置到达的区域。

重叠几何中断几何面细节面修剪距离面简化容差参数将对输出服务区域的形状造成影响。

下表列出了输出服务区域返回的字段: 除了这些字段之外,参数还包括在生成重叠或非重叠面时输入要素类中用作分析设施点的所有字段。

字段描述

Name

服务区的名称。 其以关联设施点和中断为基础;例如,Store1: 0.0 – 5.0 表示服务区涵盖名为 Store1 的设施点五分钟路程内的所有可穿过街道。

返回中断值时不包含设施点名称(例如,0.0 – 5.0,当重叠几何参数设置为按中断值合并时)。

FacilityID

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

如果将重叠几何参数设置为按中断值合并,则一个服务区可能会与多个设施点相关联,因此合并服务区时 FacilityID 字段的值为空。

FacilityOID

用于生成服务区面的输入设施点要素 ObjectID 值。 该字段通常用于连接来自输入设施点的信息。

如果将重叠几何参数设置为按中断值合并,则一个服务区可能会与多个设施点相关联,因此合并服务区时 FacilityOID 字段的值为空。

FromBreak

服务区阻抗中断范围的下限。 此字段的单位基于针对分析所设置的阻抗属性的单位。

该值以中断单位参数指定的单位为单位。

ToBreak

服务区阻抗中断范围的上限。 该值单位与 FromBreak 字段值的单位相同。

Breaks

此字段的值复制自输入设施点的 Breaks 字段。

AdditionalTime

此字段的值复制自输入设施点的 AdditionalTime 字段。

AdditionalDistance

此字段的值复制自输入设施点的 AdditionalDistance 字段。

AdditionalCost

此字段的值复制自输入设施点的 AdditionalCost 字段。

output_facilities

将提供对服务区分析中使用的设施点属性的访问权限。 您可以使用此数据类型中的属性,例如 Status 字段,来确定分析中未使用设施点的原因。

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

字段描述

Name

设施点的名称。 此字段的值复制自输入设施点的 Name 字段。

FacilityOID

输入设施点要素的 ObjectID 值。 该字段通常用于连接来自输入设施点的信息。

Breaks

此字段的值复制自输入设施点的 Breaks 字段。

AdditionalTime

此字段的值复制自输入设施点的 AdditionalTime 字段。

AdditionalDistance

此字段的值复制自输入设施点的 AdditionalDistance 字段。

AdditionalCost

此字段的值复制自输入设施点的 AdditionalCost 字段。 仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时,才包括该字段。

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

output_network_analysis_layer

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

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

注:

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