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(未定位)- 由于在距设施点的最大搜索距离内未找到可遍历道路,因此该设施点未包括在分析中。
  • 3(元素不可遍历)- 设施点所在的网络元素不可遍历。网络元素受到约束属性限制时可能会发生这种情况。
  • 4(字段值无效)- 字段值位于范围或编码值域外。例如,应该填写正数的位置可能存在负数。
  • 5(未到达)- 出于约束的原因,无法到达设施点,例如,设置了路边通道,因此车辆必须以错误方向在单行道上行驶才能到达设施点。
  • 7(在最接近位置上未定位)- 由于限制或障碍致使无法遍历距设施点最近的网络位置,因而已在最接近的可遍历网络要素上定位该设施点。

长整型

SnapX

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

双精度型

SnapY

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

双精度型

SnapZ

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

双精度型

DistanceToNetworkInMeters

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

双精度型

Bearing

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

双精度型

BearingTol

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

双精度型

NavLatency

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

双精度型


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