LocationAllocation 输出数据类型

介绍包含位置分配分析结果的输出数据类型。

线

用于访问将请求点与请求点所分配到的设施点相连的线。此类线在文档中作为分配线引用。这些分配线包括从每个请求点分配到相关设施点的请求的相关数据。

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

字段说明数据类型

Name

分配线的名称包括请求点的名称以及请求点所分配到的设施点的名称。

分配线的名称基于关联设施点和请求点的名称。

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

如果将 TravelDirection.ToFacility 指定为 travelDirection 属性的值,则请求点名称在前;例如 Demand 3 — Facility 5

文本型

Weight

从已连接请求点分配到连接设施点的权重。

双精度型

FacilityOID

相应输入设施点要素的 ObjectID 值。该字段通常用于将设施点的信息连接到分配线。

长整型

DemandOID

相应输入请求点要素的 ObjectID 值。该字段通常用于将请求点的信息连接到分配线。

长整型

Total_Minutes

设施点和请求点之间的行程时间(以分钟为单位)。请注意,虽然分配线具有直线几何或空几何,但成本始终指行程时间(在交通网络上测量),而非直线距离。

注:

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

注:

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

双精度型

TotalWeighted_Minutes

在设施点与请求点间行进的加权成本(以分钟为单位)。该值等于 Total_Minutes 值乘以分配给设施点的请求点的权重。

仅当为分析设置的出行模式具有基于时间的阻抗属性时,才包括此字段。

注:

如果为分析设置的出行模式具有基于时间的阻抗属性并且分析对象的 timeUnits 属性未设置为 TimeUnits.Minutes,则将包括附加字段 TotalWeigheted_[TimeUnits]。字段值采用由 timeUnits 属性指定的单位。

双精度型

Total_Miles

设施点和请求点之间的行驶距离(以英里为单位)。请注意,虽然分配线具有直线几何或空几何,但成本始终指行驶距离(在交通网络上测量),而非直线距离。

双精度型

Total_Kilometers

设施点和请求点之间的行程距离(以千米为单位)。请注意,虽然分配线具有直线几何或空几何,但成本始终指行驶距离(在交通网络上测量),而非直线距离。

注:

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

注:

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

双精度型

TotalWeighted_Miles

在设施点与请求点间行进的加权成本(以英里为单位)。该值等于 Total_Miles 值乘以分配给设施点的请求点的权重。

仅当为分析设置的出行模式具有基于距离的阻抗属性时,才包括此字段。

双精度型

TotalWeighted_Kilometers

在设施点与请求点间行进的加权成本(以千米为单位)。该值等于 Total_Kilometers 值乘以分配给设施点的请求点的权重。

仅当为分析设置的出行模式具有基于距离的阻抗属性时,才包括此字段。

注:

如果为分析设置的出行模式具有基于距离的阻抗属性并且分析对象的 distanceUnits 属性未设置为 DistanceUnits.MilesDistanceUnits.Kilometers,则将包括附加字段 TotalWeigheted_[DistanceUnits]。字段值采用由 distanceUnits 属性指定的单位。

双精度型

Total_Other

设施点与请求点之间的行程成本(采用未知单位)。请注意,虽然分配线具有直线几何或空几何,但成本始终指行程成本(在交通网络上测量),而非直线距离。

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

注:

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

双精度型

TotalWeighted_Other

在设施点与请求点间行进的加权成本(采用未知单位)。该值等于 Total_Cost 值乘以分配给设施点的请求点的权重。

仅当为分析设置的出行模式具有不基于时间或距离的阻抗属性时,此字段才包括在内。

双精度型

设施点

访问已选设施点、必选设施点、竞争设施点以及未选择的任意候选设施点。

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

字段说明数据类型

Name

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

字符串

FacilityOID

相应输入设施点要素的 ObjectID 值。该字段通常用于连接来自输入设施点的信息。

双精度型

FacilityType

此字段指示最佳设施点,或分析中选择的设施点。设施点类型如下:

  • 0(候选)- 服务未选择候选设施点作为解决方案的一部分。
  • 1(必选)- 提交分析前,设施点被指定为“必选”,因此无论该设施点已获取的请求量如何,都包括在解决方案中。
  • 2(竞争)- 该设施点表示竞争对手的设施点,并会从问题中移除请求。竞争设施点特定于最大化市场份额与目标市场份额两种问题类型;在其他问题类型中会将其忽略。
  • 3(已选)- 这些设施点为已选设施点,即获取请求量最大的候选设施点。

长整型

Weight

设施点的相对权重,用于评定设施点的吸引力、有利条件或一个设施点较之另一个设施点的差异。此字段的值从输入设施点的 Weight 字段中复制。

双精度型

Capacity

设施点能够提供的加权请求量。此字段的值从输入设施点的 Capacity 字段中复制。

双精度型

DemandCount

分配给设施点的请求点计数。非零值表示设施点包括在解决方案之内,其形式可能是必选设施点、竞争设施点或已选设施点。

长整型

DemandWeight

分配给设施点的所有请求点的有效权重总和。值为分配给设施点的请求点的所有 Weight 值的总和。如果使用的是“最大化人口流量”和“目标市场份额”问题类型,则该值为 Weight 字段按比例分配的总和,因为这些问题类型允许请求随距离而衰减或在多个设施点间进行拆分。

双精度型

Total_Minutes

设施点和分配至设施点的各个请求点之间的行程距离总和(以分钟为单位)。

仅当为分析设置的出行模式具有基于时间的阻抗属性时,才包括此字段。

注:

如果为分析设置的出行模式具有基于时间的阻抗属性并且分析对象的 timeUnits 属性未设置为 TimeUnits.Minutes,则将包括附加字段 Total_[TimeUnits]。字段值采用由 timeUnits 属性指定的单位。

双精度型

TotalWeighted_Minutes

该字段用于存储设施点的累积加权成本(以分钟为单位)。请求点的加权成本是将其权重乘以设施点与请求点之间的最小成本路径的乘积。设施点的加权成本是分配到该设施点的请求点的所有加权成本的总和。

例如,如果将权重为 2 的请求点分配给距其 10 分钟远的设施点,则 TotalWeighted_Minutes 值为 20 (2 x 10)。如果将权重为 3 的另一个请求点分配给距其 5 分钟远的同一设施点,则 TotalWeighted_Minutes 值将增加到 35 (3 x 5 + 20)。

仅当为分析设置的出行模式具有基于时间的阻抗属性时,才包括此字段。

注:

如果为分析设置的出行模式具有基于时间的阻抗属性并且分析对象的 timeUnits 属性未设置为 TimeUnits.Minutes,则将包括附加字段 TotalWeighted_[TimeUnits]。字段值采用由 timeUnits 属性指定的单位。

双精度型

Total_Miles

设施点和分配至设施点的各个请求点之间的行程距离总和(以英里为单位)。

仅当为分析设置的出行模式具有基于距离的阻抗属性时,才包括此字段。

注:

如果为分析设置的出行模式具有基于距离的阻抗属性并且分析对象的 distanceUnits 属性未设置为 DistanceUnits.MilesDistanceUnits.Kilometers,则将包括附加字段 Total_[DistanceUnits]。字段值采用由 distanceUnits 属性指定的单位。

双精度型

TotalWeighted_Miles

该字段用于存储设施点的累积加权成本(以英里为单位)。请求点的加权成本是将其权重乘以设施点与请求点之间的最小成本路径的乘积。设施点的加权成本是分配到该设施点的请求点的所有加权成本的总和。

例如,如果将权重为 2 的请求点分配给距其 10 英里远的设施点,TotalWeighted_Miles 值即为 20 (2 x 10)。如果将权重为 3 的另一个请求点分配给距其 5 英里远的同一设施点,则 TotalWeighted_Miles 值将增加到 35 (3 x 5 + 20)。

仅当为分析设置的出行模式具有基于距离的阻抗属性时,才包括此字段。

注:

如果为分析设置的出行模式具有基于距离的阻抗属性并且分析对象的 distanceUnits 属性未设置为 DistanceUnits.MilesDistanceUnits.Kilometers,则将包括附加字段 TotalWeighted_[DistanceUnits]。字段值采用由 distanceUnits 属性指定的单位。

双精度型

Total_Kilometers

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

双精度型

TotalWeighted_Kilometers

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

双精度型

Total_Other

设施点和分配至设施点的各个请求点之间的行程成本总和(采用未知单位)。

仅当为分析设置的出行模式具有不基于时间或距离的阻抗属性时,此字段才包括在内。

双精度型

TotalWeighted_Other

该字段用于存储设施点的累积加权成本(采用未知单位)。请求点的加权成本是将其权重乘以设施点与请求点之间的最小成本路径的乘积。设施点的加权成本是分配到该设施点的请求点的所有加权成本的总和。

仅当为分析设置的出行模式具有不基于时间或距离的阻抗属性时,此字段才包括在内。

双精度型

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

双精度型

DemandPoints

访问参与分析的请求点:包括已分配给和未分配给设施点的请求点。

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

字段说明数据类型

Name

请求点的名称。此字段的值从输入请求点上的 Name 字段中复制。

文本型

FacilityOID

此请求点被分配到的设施点的 ObjectID 值。如果请求点未分配给任何设施点,则字段值为 Null。该字段通常用于将输入设施点的信息连接到输出请求点。

长整型

DemandOID

相应输入请求点要素的 ObjectID 值。该字段通常用于连接信息。

长整型

Weight

请求点的相对权重。此字段的值从输入请求点上的 Weight 字段中复制。

双精度型

AllocatedWeight

分配给已选和必选设施点的请求数量。该值不包含分配给竞争设施点的请求。值选项如下:

  • 空值 - 请求点未分配给任何设施点。空值会导致,例如,可能无法从任何设施点到达请求点。
  • 0 - 请求点仅分配给竞争设施点。
  • 非零的正值 - 指示分配给已选设施点和请求设施点的请求数量。

双精度型

GroupName

请求点所在组的名称。此字段的值从输入请求点上的 GroupName 字段中复制。

字符串

ImpedanceTransformation

此字段的值从输入请求点上的 ImpedanceTransformation 字段中复制。

长整型

ImpedancParameter

此字段的值从输入请求点上的 ImpedanceParameter 字段中复制。

双精度型

Cutoff

如果设施点超出此处所示的值,则无法将请求点分配至该设施点。此字段的值从输入请求点上的 Cutoff 字段中复制。

双精度型

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. 设施点
  3. DemandPoints