Skip to main content

ClosestFacility 输出数据类型

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

ClosestFacilities 和 Facilities

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

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

这些数据类型支持下述字段。 除了这些字段之外，数据类型还包含输入要素类中用作分析设施点的所有字段。

字段名

描述

数据类型

ObjectID

要素的对象 ID。

ObjectID

Name

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

文本

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

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

双精度

AdditionalTime

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

双精度

AdditionalDistance

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

双精度

AdditionalCost

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

双精度

Cutoff

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

双精度

ID

用户定义的唯一设施点标识符。 此字段的值将从输入设施点上的 ID 字段中进行复制。

文本

FacilityOID

输入设施点的 ObjectID 值。

对于连接，此字段不始终可靠。 对于使用 insertCursor 方法添加至分析的输入，此字段为空值。 如果已使用 load 方法加载多个要素类，则值可能不唯一。

长整型

ORIG_FID
旧版本：

ClosestFacilities 输出包含 ORIG_FID 字段，用于维护向后兼容性。 它与 FacilityOID 字段相同。 Facilities 输出不包含 ORIG_FID 字段。

长整型

Bearing

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

双精度

BearingTol

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

双精度

NavLatency

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

双精度

事件点

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

数据类型支持以下字段：

字段名

描述

数据类型

ObjectID

要素的对象 ID。

ObjectID

Name

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

文本

TargetFacilityCount

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

长整型

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

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

双精度

AdditonalTime

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

双精度

AdditionalDistance

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

双精度

AdditionalCost

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

双精度

Cutoff

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

双精度

ID

用户定义的唯一事件点标识符。 此字段的值从输入事件点的 ID 字段中复制。

文本

IncidentOID

输入事件点的 ObjectID 值。

对于连接，此字段不始终可靠。 对于使用 insertCursor 方法添加至分析的输入，此字段为空值。 如果已使用 load 方法加载多个要素类，则值可能不唯一。

长整型

Bearing

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

双精度

BearingTol

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

双精度

NavLatency

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

双精度

路径

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

数据类型支持以下字段：

字段名

描述

数据类型

ObjectID

要素的对象 ID。

ObjectID

Name

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

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

如果将 TravelDirection.ToFacility 指定为 travelDirection 属性值，则事件点名称在前；例如 Incident 3 — Facility 5。

文本

FacilityRank

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

长整型

FacilityID

路径上设施点的用户定义的唯一 ID。 此字段的值将从输入设施点上的 ID 字段中进行复制。

文本

FacilityOID

用于生成路径的输入设施点的 ObjectID 值。 此字段对应 Facilities 和 ClosestFacilities 输出表中的 FacilityOID 字段。

长整型

OutputFacilityOID

此字段对应输出 Facilities 表中的 ObjectID 字段，并且可用于这两个表之间的连接。

长整型

IncidentID

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

文本

IncidentOID

用于生成路径的输入事件点的 ObjectID 值。 此字段对应 Incidents 输出表中的 IncidentOID 字段。

长整型

OutputIncidentOID

此字段对应输出 Incidents 表中的 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.Miles 或 DistanceUnits.Kilometers，则将包括附加字段 Total_[DistanceUnits]。 字段值采用由 distanceUnits 属性指定的单位。

注:

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

双精度

Total_Other

设施点和事件点之间路径的累积行程成本，采用位置单位。 这包括访问的设施点和事件点的 AdditionalCost 值（如果指定）。

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

注:

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

双精度

方向

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

旧版本：

此输出类已被 DirectionPoints 和 DirectionLines 输出类取代，这些类应用于所有新脚本和工作流。 Directions 输出类将在未来的版本中移除。

数据类型支持以下字段：

字段名

描述

数据类型

ObjectID

要素的对象 ID。

ObjectID

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：左转，然后立即左转

  • 27：人行坡道

  • 28：电梯

  • 29：自动扶梯

  • 30：楼梯

  • 31：门廊

方向字符串类型

  • 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 字段指路线字符串类型表中的值。

  • 如果 SubItemType 值为 3，则 Type 字段指路线字符串类型表中的值。

短整型

Text

行驶路线的文本描述。

文本

ElaspsedTime

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

浮点型

DriveDistance

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

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

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

浮点型

DirectionPoints

分析中计算的路径的输出转弯方向，表示为沿发生特定方向事件或行进策略的路径上的点位置。

数据类型支持以下字段：

字段名

描述

数据类型

ObjectID

要素的对象 ID。

ObjectID

RouteID

与此方向点相关联的输出路径要素的 ObjectID 值。

长整型

Sequence

路径方向点的序列，从　1　开始。

长整型

DirectionPointType

指定该点描述的方向事件或行进策略的类型，由以下值之一指定。

  • 标头 (1)

  • 到达 (50)

  • 出发 (51)

  • 直线 (52)

  • 乘坐渡轮 (100)

  • 离开渡轮 (101)

  • 中央分叉口 (102)

  • 环状交叉路 (103)

  • U 形转弯 (104)

  • 门 (150)

  • 楼梯 (151)

  • 电梯 (152)

  • 自动扶梯 (153)

  • 人行坡道 (154)

  • 左侧分叉口 (200)

  • 左侧坡道 (201)

  • 顺时针环状交叉路 (202)

  • 左侧 U 形转弯 (203)

  • 左转弯 (204)

  • 左转弯 (205)

  • 向左急转 (206)

  • 左转，然后立即左转 (207)

  • 左转，然后立即右转 (208)

  • 右侧分叉口 (300)

  • 右侧坡道 (301)

  • 逆时针环状交叉路 (302)

  • 右侧 U 形转弯 (303)

  • 右转弯 (304)

  • 右转弯 (305)

  • 向右急转 (306)

  • 右转，然后立即左转 (307)

  • 右转，然后立即右转 (308)

  • 电梯上行 (400)

  • 自动扶梯上行 (401)

  • 楼梯上行 (402)

  • 电梯下行 (500)

  • 自动扶梯下行 (501)

  • 楼梯下行 (502)

  • 常规事件 (1000)

  • 地标 (1001)

  • 时区变更 (1002)

  • 交通事件 (1003)

  • 调整成本型障碍事件 (1004)

  • 边界交叉 (1005)

  • 违反限制 (1006)

  • 车道 (1007)

长整型

FacilityID

与此方向点相关联的输出设施点的 ObjectID（如果存在）。 如果该点并不代表对设施点的访问，则该值为空。

长整型

IncidentID

与此方向点相关联的输出事件点的 ObjectID（如果存在）。 如果该点并不代表对事件点的访问，则该值为空。

长整型

DisplayText

将在使用应用程序中显示的方向文本。

文本

ArrivalTime

方向事件发生的时间（协调世界时间 (UTC)）。

日期

ArrivalUTCOffset

行进策略位置处的当地时间与 ArrivalTime 字段中显示的 UTC 时间之间的差值。

双精度

Name

方向点的名称。

文本

ExitName

方向说明中显示的高速公路出口名称。

文本

AlternateName

方向说明中显示的备用源名称。

文本

IntersectingName

方向说明中显示的相交街道或十字路街道的名称。

文本

BranchName

方向说明中显示的路标分支名称。

文本

TowardName

方向说明中显示的指向目的地名称的路标。

文本

Level

发生此方向事件的建筑物级别。 该值对应于在用于分析的网络数据集中定义的 Level 属性。

长整型

ShortVoiceInstruction

将在使用应用程序中用作语音导航文本的短文本。

文本

VoiceInstruction

附加文本（其中包括展开的缩写和复数形式），将在使用应用程序中用作语音导航文本。

文本

Azimuth

偏离此点的车辆的方位角，以度为单位。 零指示北向。

双精度

DirectionLines

在经过剖切的分析中计算的输出路径线，以表示 DirectionPoints 事件或行进策略位置之间的每个路径段。

字段名

描述

数据类型

ObjectID

要素的对象 ID。

ObjectID

DirectionPointID

与此线相关联的 DirectionPoints 表中要素的 ObjectID 值。

长整型

RouteID

与此方向线相关联的输出 Routes 要素的 ObjectID 值。

长整型

DirectionLineType

指定此线所描述的方向情况类型，由以下值之一指定：

  • 未知 (0)

  • 线段 (1)

  • 行进策略段 (2)

  • 违反限制 (3)

  • 调整成本型障碍 (4)

  • 交通繁忙 (5)

  • 交通畅通 (6)

  • 交通适中 (7)

长整型

Meters

线段的长度，以米为单位。

双精度

Minutes

沿线段的行驶时间，以分钟为单位。

双精度

FromLevel

开始此方向事件的建筑物级别。 该值对应于在用于分析的网络数据集中定义的 Level 属性。

了解有关网络数据集的方向配置的详细信息

长整型

ToLevel

结束此方向事件的建筑物级别。 该值对应于在用于分析的网络数据集中定义的 Level 属性。

长整型