查找最近设施点的输出

成功执行后,服务将返回事件点和所选设施点之间的最佳路径和行驶方向;同时显示一个状态,通过以下输出参数指示分析是否成功:

Output_facilities 和 output_closest_facilities

将提供对最近设施点分析中的输出设施点的访问权限。

output_closest_facilities 参数仅包含与至少一个事件点最接近的输入设施点集中的设施点。相反,output_facilities 数据类型包含分析中的所有设施点,包括无法从任何事件点到达的设施点。可使用 output_facilities 数据类型中的 Status,确定分析中未使用设施点的原因。

下表列出了输出设施点返回的字段:

字段名称说明

Name

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

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

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

AdditionalTime

访问此设施点时添加到总路径时间中的时间量。此字段的值从输入设施点的 AdditionalTime 字段中复制。

AdditionalDistance

访问此设施点时添加到总路径距离中的距离数。此字段的值从输入设施点的 AdditionalDistance 字段中复制。

AdditionalCost

访问此设施点时添加到总路径成本中的成本。此字段的值从输入设施点的 AdditionalCost 字段中复制。仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时,才包括该字段。

Cutoff

分析停止从指定事件点搜索设施点时所对应的阻抗值。此字段的值从输入设施点的 Cutoff 字段中复制。

ID

设施点的唯一标识符。此字段的值从输入设施点的 ID 字段中复制。

ORIG_FID

FacilityOID

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

ClosestFacilities 输出包含 ORIG_FID 字段,Facilities 输出包含 FacilityOID 字段。

Bearing

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

BearingTol

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

NavLatency

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

output_routes

将提供对生成的路径或设施点与事件点之间路径的访问权限。

route_shaperoute_line_simplification_tolerance 这两个参数会对输出路径的形状造成影响。

字段名称说明

Name

最近设施点路径的名称基于相关设施点和事件点的名称。

如果将 travel_direction 参数值设置为 Facility to Incident,则设施点名称在前。例如,Facility 5 - Incident 3 表示从设施点 5 到事件点 3 的行驶路径。

而如果将 Incident to Facility 指定为 travel_direction 参数的值,则事件点名称在前,例如 Incident 3 — Facility 5

FacilityRank

某设施点在为相关事件点找到的所有设施点中的等级;最近设施点的等级为 1。

FacilityID

路径上设施点的唯一 ID。此字段的值从输入设施点的 ID 字段中复制。

FacilityOID

用于生成路径的输入设施点 ObjectID 值。该字段通常用于连接设施点到路径的信息。

IncidentID

路径上事件点的唯一 ID。此字段的值从输入事件点上的 ID 字段中复制。

IncidentOID

用于生成路径的输入事件点 ObjectID 值。该字段通常用于连接事件点到路径的信息。

FacilityCurbApproach

描述到达或离开设施点时设施点在车辆的哪一侧。值 1 表示在车辆的右侧;值 2 表示在车辆的左侧。

IncidentCurbApproach

描述到达或离开事件点时事件点位于车辆的哪一侧。值 1 表示在车辆的右侧;值 2 表示在车辆的左侧。

StartTime

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

EndTime

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

StartTimeUTC

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

EndTimeUTC

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

Total_Minutes

设施点和事件点之间路径的累积行驶时间,以分钟为单位。如果针对访问的设施点和事件点指定,则包括所有 AdditionalTime

注:

如果 measurement_units 参数基于时间,且值不是 Minutes,则将包括附加的 Total_[TimeUnits] 字段。该字段值的单位由 measurement_units 参数指定。

注:

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

Total_Miles

设施点和事件点之间路径的累积行驶距离,以英里为单位。如果针对访问的设施点和事件点指定,则包括所有 AdditionalDistance

注:

如果 measurement_units 参数基于距离,且值不是 MilesKilometers,则将包括附加的 Total_[DistanceUnits] 字段。该字段值的单位由 measurement_units 参数指定。

注:

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

Total_Kilometers

设施点和事件点之间路径的累积行驶距离,以千米为单位。如果针对访问的设施点和事件点指定,则包括所有 AdditionalDistance

注:

如果 measurement_units 参数基于距离,且值不是 MilesKilometers,则将包括附加的 Total_[DistanceUnits] 字段。该字段值的单位由 measurement_units 参数指定。

注:

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

Total_Other

设施点和事件点之间路径的累积行驶成本,其单位未知。如果针对访问的设施点和事件点指定,则包括所有 AdditionalCost

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

注:

对于不基于时间或距离并且在分析期间累积的所有成本属性,将包括附加字段 Total_[AccumulateAttributeName]_Other

output_incidents

将提供对在最近设施点分析中用作起点或终点的位置的访问权限。

下表列出了输出事件返回的字段:

字段说明

Name

事件的名称。此字段的值从输入事件点的 Name 字段中复制。

TargetFacilityCount

需要为指定事件点查找的设施点的数量。此字段的值从输入事件点的 TargetFacilityCount 字段中复制。

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

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

AdditonalTime

访问此事件点时添加到总路径时间中的时间量。此字段的值从输入事件点的 AdditionalTime 字段中复制。

AdditionalDistance

访问此事件点时添加到总路径距离中的距离量。此字段的值从输入事件点的 AdditionalDistance 字段中复制。

AdditionalCost

访问此事件点时添加到总路径成本中的成本。此字段的值从输入事件点的 AdditionalCost 字段中复制。仅当用于分析的出行模式具有既不基于时间也不基于距离的阻抗属性时,才包括该字段。

Cutoff

分析停止从给定设施点搜索事件点时所对应的阻抗值。此字段的值从输入事件点的 Cutoff 字段中复制。

IncidentOID

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

Bearing

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

BearingTol

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

NavLatency

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

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 指的是方向字符串类型表格中的值。

Text

行驶方向的文本描述。

ElaspsedTime

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

DriveDistance

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

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

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

solve_succeeded

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

output_route_data

可以使用此参数访问含有某文件地理数据库的 .zip 文件,该文件地理数据库包含相应格式的分析的输入和输出,可以使用该格式与 ArcGIS OnlinePortal for ArcGIS 共享路径图层。仅当保存路径数据参数设置为 True 时才填充参数值。

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

output_result_file

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

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

output_network_analysis_layer

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

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

注:

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