求解位置分配的输出

成功执行 SolveLocationAllocation 后,服务会返回已选设施点、参与的请求点、请求点和请求点所分配到的设施点之间的连接线,以及分析是否成功的状态。此信息在下述输出参数中输出。

output_facilities

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

此参数支持以下字段。除了这些字段外,参数还包括输入设施点中用作分析的所有字段

字段说明

Name

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

FacilityOID

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

FacilityType

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

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

Weight

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

Capacity

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

DemandCount

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

DemandWeight

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

Total_Minutes

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

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

注:

如果测量单位参数基于时间,且值未设置为分钟,则将包括附加的 Total_[TimeUnits] 字段。该字段值以测量单位参数指定的单位为单位。

TotalWeighted_Minutes

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

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

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

注:

如果测量单位参数基于时间,且值未设置为分钟,则将包括附加的 TotalWeighted_[TimeUnits] 字段。该字段值以测量单位参数指定的单位为单位。

Total_Miles

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

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

注:

如果测量单位参数基于距离,且值不是英里千米,则将包括附加的 Total_[DistanceUnits] 字段。该字段值以测量单位参数指定的单位为单位。

TotalWeighted_Miles

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

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

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

注:

如果测量单位参数基于距离,且值不是英里千米,则将包括附加的 TotalWeighted_[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 字段中复制。

output_demand_points

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

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

字段说明

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

output_allocation_lines

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

参数支持以下字段:

字段说明

Name

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

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

如果将行驶方向参数值设置为设施点到请求点,则设施点名称在前。例如,Facility 5 - Demand 3 表示从设施点 5 行进到请求点 3 的路径。

如果将设施点到请求点指定为行驶方向参数值,则请求点名称在前;例如,Demand 3 — Facility 5

Weight

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

FacilityOID

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

DemandOID

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

Total_Minutes

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

注:

如果测量单位参数基于时间,且值未设置为分钟,则将包括附加的 Total_[TimeUnits] 字段。该字段值以测量单位参数指定的单位为单位。

注:

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

TotalWeighted_Minutes

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

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

注:

如果测量单位参数基于时间,且值未设置为分钟,则将包括附加的 TotalWeighted_[TimeUnits] 字段。该字段值以测量单位参数指定的单位为单位。

Total_Miles

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

注:

如果测量单位参数基于距离,且值不是英里千米,则将包括附加的 Total_[DistanceUnits] 字段。该字段值以测量单位参数指定的单位为单位。

注:

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

Total_Kilometers

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

TotalWeighted_Miles

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

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

注:

如果测量单位参数基于距离,且值不是英里千米,则将包括附加的 TotalWeighted_[DistanceUnits] 字段。该字段值以测量单位参数指定的单位为单位。

TotalWeighted_Kilometers

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

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

Total_Other

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

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

注:

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

TotalWeighted_Other

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

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

solve_succeeded

使用此参数可确定分析是否成功。

output_result_file

使用此参数可以将分析结果作为 .zip 文件(包含每个输出的一个或多个文件)进行访问。单个文件的格式由输出格式参数指定。当输出格式参数设置为要素集时,未填充参数值。

如果指定文件基于输出格式(如 JSON 文件GeoJSON 文件),则不会向显示添加输出,因为应用程序(例如 ArcMap 或 ArcGIS Pro)不会绘制结果文件的内容。相反,结果文件将下载到计算机上的临时目录中。在 ArcGIS Pro 中,可以通过查看输出结果文件参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。在 ArcMap 中,可以通过访问输出结果文件参数上的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。

output_network_analysis_layer

使用此参数可访问存储分析设置以及用于分析输入和输出的网络分析图层文件。仅当保存输出网络分析图层参数设置为 True 时才填充参数值。

文件将下载到计算机上的临时目录中。在 ArcGIS Pro 中,可以通过查看输出网络分析图层参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。在 ArcMap 中,可以通过访问输出网络分析图层参数上的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。

注:

由于数据源无效,因此即使在 ArcGIS Desktop 应用程序(例如 ArcMap)中打开文件,也无法直接使用此文件。需要将该文件发送至 Esri 技术支持以诊断工具所返回结果的质量。