生成服务区的输出

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

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(未定位)- 由于在距设施点的最大搜索距离内未找到可遍历道路,因此该设施点未包括在分析中。
  • 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 技术支持以诊断工具所返回结果的质量。