介绍包含最近设施点分析结果的输出数据类型。
ClosestFacilities 和 Facilities
将提供对最近设施点分析中的输出设施点的访问权限。
ClosestFacilities 数据类型仅包含与至少一个事件点最接近的输入设施点集中的设施点。 Facilities 数据类型包含分析中的所有设施点，包括无法从任何事件点到达的设施点。 可使用 Facilities 数据类型中的 Status 字段，确定分析中未使用设施点的原因。
上述数据类型支持以下字段。 除了这些字段之外，数据类型还包含输入要素类中用作分析设施点的所有字段。
| 字段名 | 描述 | 数据类型 |
|---|---|---|
ObjectID | 要素的 ObjectID。 | ObjectID |
Name | 设施点的名称。 此字段的值将从输入设施点上的 Name 字段中进行复制。 | 文本 |
SourceID | 输入点所在的网络数据集源要素类的数字标识符。 | 长整型 |
SourceOID | 输入点所在的源中要素的 ObjectID。 | 长整型 |
PosAlong | 沿源线要素的数字化方向的位置点。该值以比率形式存储。如果网络位置引用交汇点，则此字段将为空。 | 双精度 |
SideOfEdge | 相对于线要素的数字化方向的边侧。此字段被限制为具有两个值的属性域：右侧 (1) 和左侧 (2)。 | 长整型 |
CurbApproach | 车辆到达和离开设施点时可能对应的方向。 此字段的值将从输入设施点上的 CurbApproach 字段中进行复制。 | 长整型 |
Status | 指示该点相对于其在网络上的位置以及分析结果的状态。 可能的值如下：
| 长整型 |
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 | 要素的 ObjectID。 | ObjectID |
Name | 事件点的名称。 此字段的值从输入事件点的 Name 字段中复制。 | 文本 |
TargetFacilityCount | 需要为指定事件点查找的设施点的数量。 此字段的值从输入事件点的 TargetFacilityCount 字段中复制。 | 长整型 |
SourceID | 输入点所在的网络数据集源要素类的数字标识符。 | 长整型 |
SourceOID | 输入点所在的源中要素的 ObjectID。 | 长整型 |
PosAlong | 沿源线要素的数字化方向的位置点。该值以比率形式存储。如果网络位置引用交汇点，则此字段将为空。 | 双精度 |
SideOfEdge | 相对于线要素的数字化方向的边侧。此字段被限制为具有两个值的属性域：右侧 (1) 和左侧 (2)。 | 长整型 |
CurbApproach | 车辆到达和离开事件点时可能对应的方向。 此字段的值从输入事件点的 CurbApproach 字段中复制。 | 长整型 |
Status | 指示该点相对于其在网络上的位置以及分析结果的状态。 可能的值如下：
| 长整型 |
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 | 要素的 ObjectID。 | 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。 | 双精度 |
方向
将提供对每个生成路径转弯方向的访问权限。
数据类型支持以下字段：
| 字段名 | 描述 | 数据类型 |
|---|---|---|
ObjectID | 要素的 ObjectID。 | ObjectID |
RouteName | 驾驶操作所应用到的路径的名称。 该值与输出路径的 Name 字段值相同。 | 文本 |
ArriveTime | 开始给定驾驶操作的当日时间。 如果路径跨越多天，则会显示日期和时间。 | 日期 |
Type | 路线要素代表的行进策略类型或路线文本类型。 要确定 Type 指的是行进策略类型还是路线字符串类型，可查看 SubItemType 字段值。 Type 例如，在应用程序中显示行驶路线时，此字段可根据行进策略类型为路线文本分配图标，或根据路线字符串类型使用格式化样式。 Type 值是下方“行进策略类型”或“路线字符串类型”列表中的整数。 行进策略类型
方向字符串类型
| 短整型 |
SubItemType | 指定 Type 字段指的是方向字符串类型表格中的整数，还是行进策略类型表格中的整数。
| 短整型 |
Text | 行驶路线的文本描述。 | 文本 |
ElaspsedTime | 当前行驶方向开始到下一行驶方向开始之时，或到上一行驶方向的路径结束之时所经历的时间，以分钟为单位。 | 浮点型 |
DriveDistance | 当前行驶方向开始到下一行驶方向开始，或到上一行驶方向的路径结束之时所行驶的距离。 值采用由分析对象的 directionsDistanceUnits 属性指定的单位。 如果行驶路线与下一个行驶路线开始的位置相同，则此值为零。 例如，对于路径开始时的路线文本，DriveDistance 值为 0。 | 浮点型 |
DirectionPoints
指定分析中计算的路径的输出转弯方向，表示为沿发生特定方向事件或行进策略的路径上的点位置。
| 字段名 | 描述 | 数据类型 |
|---|---|---|
ObjectID | 要素的 ObjectID。 | ObjectID |
RouteID | 与此方向点相关联的输出路径要素的 ObjectID 值。 | 长整型 |
Sequence | 路径方向点的序列，从 1 开始。 | 长整型 |
DirectionPointType | 该点描述的方向事件或行进策略的类型，由以下值之一指定。
| 长整型 |
FacilityID | 与此方向点相关联的输出设施点的 ObjectID（如果存在）。 如果该点并不代表对设施点的访问，则该值为空。 | 长整型 |
IncidentID | 与此方向点相关联的输出事件点的 ObjectID（如果存在）。 如果该点并不代表对事件点的访问，则该值为空。 | 长整型 |
DisplayText | 在使用应用程序中要显示的方向文本。 | 文本 |
ArrivalTime | 方向事件的发生时间，采用调世界时间 (UTC) 格式。 | 日期 |
ArrivalUTCOffset | 行进策略位置处的当地时间与 ArrivalTime 字段中显示的 UTC 时间之间的差值。 | 双精度 |
Name | 方向点的名称。 | 文本 |
ExitName | 方向说明中显示的高速公路出口名称。 | 文本 |
AlternateName | 方向说明中显示的备用源名称。 | 文本 |
IntersectingName | 方向说明中显示的相交街道或十字路街道的名称。 | 文本 |
BranchName | 方向说明中显示的路标分支名称。 | 文本 |
TowardName | 方向说明中显示的指向目的地名称的路标。 | 文本 |
Level | 发生此方向事件的建筑物级别。 该值对应于在用于分析的网络数据集中定义的 Level 属性。 | 长整型 |
ShortVoiceInstruction | 在使用应用程序中用作语音导航文本的短文本。 | 文本 |
VoiceInstruction | 其他文本，包括展开的缩写和复数形式，以在使用应用程序中用作语音导航文本。 | 文本 |
Azimuth | 偏离此点的车辆的方位角，以度为单位。 零指示北向。 | 双精度 |
DirectionLines
指定在经过剖切的分析中计算的输出路径线，以表示 DirectionPoints 事件或行进策略位置之间的每个路径段。
| 字段名 | 描述 | 数据类型 |
|---|---|---|
ObjectID | 要素的 ObjectID。 | ObjectID |
DirectionPointID | 与此线相关联的 DirectionPoints 表中要素的 ObjectID 值。 | 长整型 |
RouteID | 与此方向线相关联的输出 Routes 要素的 ObjectID 值。 | 长整型 |
DirectionLineType | 此线所描述的方向情况类型，由以下值之一指定：
| 长整型 |
Meters | 线段的长度，以米为单位。 | 双精度 |
Minutes | 沿线段的行驶时间，以分钟为单位。 | 双精度 |
FromLevel | 开始此方向事件的建筑物级别。 该值对应于在用于分析的网络数据集中定义的 Level 属性。 | 长整型 |
ToLevel | 结束此方向事件的建筑物级别。 该值对应于在用于分析的网络数据集中定义的 Level 属性。 | 长整型 |