ClosestFacility 输出数据类型

介绍包含最近设施点分析结果的输出数据类型。

ClosestFacilities 和 Facilities

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

ClosestFacilities 数据类型仅包含与至少一个事件点最接近的输入设施点集中的设施点。Facilities 数据类型包含分析中的所有设施点,包括无法从任何事件点到达的设施点。可使用 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 值。该字段通常用于连接来自输入设施点的信息。

OutputFacilities 数据类型包括 ORIG_FID 字段和 Facilities 数据类型,其中包括 FacilityOID 字段。

长整型

Bearing

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

双精度型

BearingTol

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

双精度型

NavLatency

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

双精度型

事件点

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

该数据类型支持以下字段:

字段名说明数据类型

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 字段中复制。

双精度型

路线

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

数据类型支持以下字段:

字段名说明数据类型

Name

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

如果分析对象上的 travelDirection 属性的值设置为 TravelDirection.FromFacility,则设施点名称在前。例如,Facility 5 - Incident 3 表示从设施点 5 到事件点 3 的行驶路径。

如果将 TravelDirection.ToFacility 指定为 travelDirection 属性的值,则事件点名称在前;例如 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

注:

如果分析对象的 timeUnits 属性未设置为 TimeUnits.Minutes,则将包括附加字段 Total_[TimeUnits]。字段值采用由 timeUnits 属性指定的单位。

注:

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

双精度型

Total_Miles

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

双精度型

Total_Kilometers

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

注:

如果分析对象的 distanceUnits 属性未设置为 DistanceUnits.MilesDistanceUnits.Kilometers,则将包括附加字段 Total_[DistanceUnits]。字段值采用由 distanceUnits 属性指定的单位。

注:

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

双精度型

Total_Other

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

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

注:

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

双精度型

方向

将提供对每个生成路径转弯方向的访问权限。

该数据类型支持以下字段:

字段名说明数据类型

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

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

值采用由分析对象的 directionsDistanceUnits 属性指定的单位。

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

双精度型