ServiceArea 输出数据类型

成功执行后,工具将返回设施点周围的服务区,以及一个状态,指示分析是否成功。

以下将介绍包含服务区域分析结果的输出数据类型。

将提供对面要素的访问权限,这些面要素表示在给定的行驶时间、行驶距离或行程成本范围内可从输入位置到达的区域。

此数据类型支持以下所述字段。 除了这些字段之外,数据类型还包括在生成重叠或非重叠面时输入要素类中用作分析设施点的所有字段。

字段描述数据类型

Name

服务区的名称。 其以关联设施点和中断为基础;例如,Store1: 0.0 – 5.0 表示服务区涵盖名为 Store1 的设施点五分钟路程内的所有可穿过街道。

返回的中断值无设施点名称,例如 0.0 – 5.0,当分析对象的 geometryAtOverlap 属性设置为 ServiceAreaOverlapGeometry.Dissolve 时返回。

文本

FacilityID

分析自动生成的关联设施点的唯一标识符。

如果将分析对象的 geometryAtOverlap 属性设置为 ServiceAreaOverlapGeometry.Dissolve,则一个服务区可以与多个设施点相关联,因此合并服务区时 FacilityID 字段的值为空。

长整型

FacilityOID

用于生成服务区面的输入设施点要素 ObjectID 值。 该字段通常用于连接来自输入设施点的信息。

如果将分析对象的 geometryAtOverlap 属性设置为 ServiceAreaOverlapGeometry.Dissolve,则一个服务区可以与多个设施点相关联,因此合并服务区时 FacilityOID 字段的值为空。

长整型

FromBreak

服务区阻抗中断范围的下限。 此字段的单位基于针对分析所设置的阻抗属性的单位。

如果阻抗属性基于时间,则该值将以 timeUnits 属性指定的单位为单位。 如果阻抗属性基于距离,则该值将以 distanceUnits 属性指定的单位为单位。 如果阻抗属性既不基于时间也不基于距离,则该值将以未知单位表示。

双精度

ToBreak

服务区阻抗中断范围的上限。 该值单位与 FromBreak 字段值的单位相同。

双精度

Breaks

此字段的值复制自输入设施点的 Breaks 字段。

文本

AdditionalTime

此字段的值复制自输入设施点的 AdditionalTime 字段。

双精度

AdditionalDistance

此字段的值复制自输入设施点的 AdditionalDistance 字段。

双精度

AdditionalCost

此字段的值复制自输入设施点的 AdditionalCost 字段。

双精度

线

将生成的服务区存储为线状要素,并覆盖能够在给定时间、距离或其他行程成本中断内到达的街道或网络边。 由于服务区分析以沿网络线的测量结果为基础,因此线可以比面更真实地表示服务区。

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

字段描述数据类型

FacilityOID

用于生成服务区线的输入设施点要素 ObjectID 值。 该字段通常用于连接来自输入设施点的信息。

长整型

SourceName

每条服务区线都要遍历网络源要素类(用于创建在其上执行服务区分析的网络数据集的要素类)中的一个要素。 该字段包含从其中生成线的边源要素类的名称。

文本

SourceOID

遍历的街道要素的 ObjectID 值。 汇总此字段的值可以提供有用的信息,例如特定街道要素包括在设施点中的次数。

长整型

FromPosition

指定服务区线沿基础源要素的开始位置。

  • 值为 0(零)表示服务区线在基础源要素的起点处开始。
  • 值为 1 表明服务区线在基础源要素的终点处开始。
  • 值在 0 到 1 之间表明服务区线在沿基础源要素的某一点处开始;例如,值为 0.25 表示服务区线在数字化方向上沿基础源要素的百分之二十五处开始。

双精度

ToPosition

指定服务区线沿基础源要素的结束位置。

  • 值为 0(零)表示服务区线在基础源要素的起点处结束。
  • 值为 1 表明服务区线在基础源要素的终点处结束。
  • 值在 0 到 1 之间表明服务区线在沿基础源要素的某一点处结束;例如,值为 0.25 表示服务区线在数字化方向上沿基础源要素的百分之二十五处结束。

双精度

FromCumul_Minutes

该字段包含从设施点到此线要素起点这一路径的累积成本(以分钟为单位)。 在这个值中包含线起点处相邻交汇点的成本。

注:

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

注:

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

双精度

ToCumul_Minutes

该字段包含从设施点到此线要素终点这一路径的累积成本(以分钟为单位)。 在这个值中不包含线终点处相邻交汇点的成本。

注:

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

注:

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

双精度

FromCumul_Miles

该字段包含从设施点到此线要素起点这一路径的累积成本(以英里为单位)。 在这个值中包含线起点处相邻交汇点的成本。

注:

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

注:

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

双精度

ToCumul_Miles

该字段包含从设施点到此线要素终点这一路径的累积成本(以英里为单位)。 在这个值中不包含线终点处相邻交汇点的成本。

注:

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

注:

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

双精度

FromCumul_Kilometers

该字段与 FromCumul_Miles 字段相似,但该字段值以公里为单位,而不是以英里为单位。

双精度

ToCumul_Kilometers

该字段与 ToCumul_Miles 字段相似,但该字段值以公里为单位,而不是以英里为单位。

双精度

FromCumul_Other

该字段包含从设施点到此线要素起点这一路径的累积成本(未知单位)。 在这个值中包含线起点处相邻交汇点的成本。

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

注:

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

双精度

ToCumul_Other

该字段包含从设施点到此线要素终点这一路径的累积成本(未知单位)。 在这个值中不包含线终点处相邻交汇点的成本。

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

注:

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

双精度

设施点

将提供对服务区分析中使用的设施点属性的访问权限。 您可以使用此数据类型中的属性,例如 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(未定位)- 该点未在网络上定位,因此未包含在分析中。
  • 2(网络元素未定位)- 未找到由该点的网络位置字段标识的网络元素。 如果删除了该点应处于的网络元素并且未对网络位置重新进行计算,则可能会出现这种情况。
  • 3(元素不可遍历)- 在其上定位该点的网络元素不可遍历。 元素受到约束属性限制时可能会发生这种情况。
  • 4(字段值无效)- 字段值位于范围或编码值域外。 例如,应该填写正数的位置存在负数。
  • 5(无法到达)- 求解程序无法到达该点。 该点可能位于独立于其他输入的网络断开连接区域中,或是障碍或限制阻止了往返于该点。
  • 6(时间窗冲突)- 在指定的时间窗内无法到达该点。 此状态仅适用于支持时间窗的网络分析类型。
  • 7(未定位在最近位置) - 由于限制或障碍致使无法遍历距该点最近的网络位置,因而该点将被置于最近的可遍历网络要素上。

长整型

SnapX

在网络数据集的坐标系中,网络数据集中该点所在位置的 x 坐标。

双精度

SnapY

在网络数据集的坐标系中,网络数据集中该点所在位置的 y 坐标。

双精度

SnapZ

在网络数据集的坐标系中,网络数据集中该点所在位置的 z 坐标。如果网络为二维网络,则 SnapZ 字段将为 0。

双精度

DistanceToNetworkInMeters

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

双精度

Bearing

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

双精度

BearingTol

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

双精度

NavLatency

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

双精度


在本主题中
  1. 线
  2. 设施点