ClosestFacility 输入数据类型

以下介绍了执行最近设施点分析时可以指定的输入数据类型。

事件点

在最近设施点分析中用作起点或终点的位置。

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

字段说明数据类型

Name

事件点的名称。该名称用于行驶方向中。如果未指定名称,则会在输出路径和方向中自动生成前缀为 Location 的唯一名称。

字符串

ID

事件点的唯一标识符。该标识符包含在输出路径中(作为 IncidentID 字段),且有助于将输出路径的附加信息(例如总行驶时间或总距离)连接到事件点的属性中,反之亦然。如果未指定 ID,则服务将为每个事件点自动生成一个唯一的标识符。

字符串

AdditionalTime

在事件点所花费的时间,该时间将被添加到路径总时间中。默认值为 0。

此属性值的单位由分析对象的 timeUnits 属性指定。

例如,如果您要查找距火灾事件点最近的消防站以估算响应时间,AdditionalTime 属性可存储消防人员开始灭火前在事件点位置连接装备所花费的时间。

双重

AdditionalDistance

在事件点所行驶的额外距离,该距离将被添加到路径总距离中。默认值为 0。

此属性值的单位由分析对象的 distanceUnits 属性指定。

通常,事件点的位置(例如住宅)并不是恰好位于街道上,而是位于道路的后方。该属性值可用于构建事件点位置与其在街道上的位置之间的距离,如有必要,将此段距离包括在总行驶距离中。

双重

AdditionalCost

在事件点花费的额外成本,该成本将被添加到路径总距离中。默认值为 0。

当分析的出行模式使用不基于时间也不基于距离的阻抗属性时,应使用此属性值。属性值的单位将理解为未知单位。

双重

TargetFacilityCount

需要为指定事件点查找的设施点的数量。此字段允许您为每个事件点指定要查找的不同数量的设施点。例如,使用此字段,您可以找到距一个事件点最近的三个设施点,以及距另一个事件点最近的两个设施点。

此字段的值将覆盖使用 defaultTargetFacilityCount 属性进行分析的默认设置。

默认值为 Null,这会导致所有事件均使用 defaultTargetFacilityCount 属性设置的默认值。

长整型

Cutoff

停止从指定事件点搜索设施点时所对应的阻抗值。此属性允许您为每个事件点指定不同的中断值。例如,使用此属性,您可以搜索距一个事件点五分钟行驶时间以内的设施点,并搜索距另一个事件点八分钟行驶时间以内的设施点。

只能在将 travelDirection 属性设置为 TravelDirection.ToFacility 时使用此属性。

此属性的值将使用 defaultImpedanceCutoff 属性覆盖分析的默认设置。

如果为分析设置的出行模式使用基于时间的阻抗属性,则该值将以 timeUnits 属性中指定的单位进行解释。如果为分析设置的出行模式使用基于距离的阻抗属性,则该值将以 distanceUnits 属性中指定的单位进行解释。如果为分析设置的出行模式所使用的阻抗属性既不基于时间也不基于距离,则这些值将以未知单位进行解释。

默认值为 Null,这会导致所有事件均使用 defaultImpedanceCutoff 属性设置的默认值。

双重

CurbApproach

指定车辆到达和离开事件点的方向。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(车辆的任意一侧)- 车辆可从任一方向到达和离开事件点,因此事件点处允许 U 形转弯。如果车辆有可能要在事件点处调头,则可以选择该设置。此决策可能取决于道路的宽度以及交通量,或者该事件点是否有停车场能让车辆驶入并调头。

  • 1(车辆的右侧)- 当车辆到达和离开事件点时,停靠点必须在车辆右侧。禁止 U 形转弯。通常用于必须在右侧停靠的车辆(如公共汽车)。

  • 2(车辆的左侧)- 当车辆到达和离开事件点时,路边必须在车辆左侧。禁止 U 形转弯。通常用于必须在左侧停靠的车辆(如公共汽车)。

  • 3(禁止 U 形转弯)- 当车辆到达事件点时,路边可在车辆的任意一侧;但是,车辆在离开时不得调头。

    CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的事件点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近事件点,也就是说,只能从车辆的右侧或左侧接近事件点。例如,如果要到达一个事件点并且在车辆与事件点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

短整型

Bearing

点移动的方向。单位为度,并且从正北方向开始顺时针进行测量。该字段与 BearingTol 字段结合使用。

方位角数据通常会从配有 GPS 接收器的移动设备自动发送。如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。

使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。方位角也可帮助工具确定点在街道的哪一边上。

了解有关方位角和方位角容差的详细信息

双重

BearingTol

使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。如果 Bearing 字段中的值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。

单位为度,默认值为 30。值必须大于 0 且小于 180。值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。

了解有关方位角和方位角容差的详细信息

双重

NavLatency

如果 BearingBearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 BearingBearingTol 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。

NavLatency 的单位与阻抗属性的单位相同。

NavLatency 的时间单位与分析对象的 timeUnits 属性指定的单位相同。

双重

网络位置字段

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

结合使用这些属性可描述网络中对象所在的点。

了解有关在网络中定位输入的详细信息

Facilities

在最近设施点分析中用作起点或终点的位置。

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

字段说明数据类型

Name

设施点的名称。该名称用于行驶方向中。如果未指定名称,则会在输出路径和方向中自动生成前缀为 Location 的唯一名称。

字符串

ID

设施点的唯一标识符。该标识符作为 FacilityID 字段包含在输出路径和输出最近设施点中。FacilityID 字段可用于将输出路径的附加信息(例如总行驶时间或总距离)连接到设施点的属性中。如果未指定 ID,则服务将为每个设施点自动生成一个唯一的标识符。

字符串

AdditionalTime

在设施点所花费的时间,该时间将被添加到路径总时间中。默认值为 0。

此属性值的单位由分析对象的 timeUnits 属性指定。

例如,如果您要查找离火灾事件点最近的消防站,AdditionalTime 可存储消防人员穿好适当的防护装备和离开消防站所花费的时间。

双重

AdditionalDistance

在设施点所行驶的额外距离,该距离将被添加到路径总距离中。默认值为 0。

此属性值的单位由分析对象的 distanceUnits 属性指定。

通常,设施点的位置(例如消防站)并不是恰好位于街道上,而是位于道路的后方。AdditionalDistance 可用于构建设施点位置与其在街道上的位置之间的距离,如有必要,将此段距离包括在总行驶距离中。

双重

AdditionalCost

在设施点花费的额外成本,该成本将被添加到路径总距离中。默认值为 0。

当分析的出行模式使用不基于时间也不基于距离的阻抗属性时,应使用此属性值。属性值的单位将理解为未知单位。

双重

Cutoff

停止从指定设施点搜索事件点时所对应的阻抗值。此属性允许您为每个设施点指定不同的中断值。例如,使用此属性,您可以搜索距一个设施点五分钟行驶时间以内的事件点,并搜索距另一个设施点八分钟行驶时间以内的事件点。

只能在将 travelDirection 属性设置为 TravelDirection.FromFacility 时使用此属性。

此属性的值将使用 defaultImpedanceCutoff 属性覆盖分析的默认设置。

如果分析中的出行模式使用基于时间的阻抗属性,则该值将以 timeUnits 属性中指定的单位进行解释。如果分析中的出行模式使用基于距离的阻抗属性,则该值将以 distanceUnits 属性中指定的单位进行解释。如果分析中的出行模式使用的阻抗属性既不基于时间,也不基于距离,则这些值将被解释为未知单位。

默认值为 Null,这会导致所有事件均使用 defaultImpedanceCutoff 属性设置的默认值。

双重

CurbApproach

指定车辆到达和离开设施点的方向。

  • 0(车辆的任意一侧)- 车辆可从任一方向到达和离开设施点,因此设施点处允许 U 形转弯。如果车辆有可能要在设施点处调头,则可以选择该设置。此决策可能取决于道路的宽度以及交通量,或者该设施点是否有停车场能让车辆驶入并调头。
  • 1(车辆的右侧)- 当车辆到达和离开设施点时,设施点必须在车辆右侧。禁止 U 形转弯。通常用于必须在右侧停靠的车辆(如公共汽车)。
  • 2(车辆的左侧)- 当车辆到达和离开设施点时,路边必须在车辆左侧。禁止 U 形转弯。通常用于必须在左侧停靠的车辆(如公共汽车)。
  • 3(禁止 U 形转弯)- 当车辆到达设施点时,路边可在车辆的任意一侧;但是,车辆在离开时不得调头。

CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的设施点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近设施点,也就是说,只能从车辆的右侧或左侧接近设施点。例如,如果要到达一个设施点并且在车辆与设施点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

短整型

Bearing

点移动的方向。单位为度,并且从正北方向开始顺时针进行测量。该字段与 BearingTol 字段结合使用。

方位角数据通常会从配有 GPS 接收器的移动设备自动发送。如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。

使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。方位角也可帮助工具确定点在街道的哪一边上。

了解有关方位角和方位角容差的详细信息

双重

BearingTol

使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。如果 Bearing 字段中的值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。

单位为度,默认值为 30。值必须大于 0 且小于 180。值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。

了解有关方位角和方位角容差的详细信息

双重

NavLatency

如果 BearingBearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 BearingBearingTol 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。

NavLatency 的单位与阻抗属性的单位相同。

NavLatency 的时间单位与分析对象的 timeUnits 属性指定的单位相同。

双重

网络位置字段

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

结合使用这些属性可描述网络中对象所在的点。

了解有关在网络中定位输入的详细信息

PointBarriers

使用此参数可指定一个或多个点作为临时限制,或表示在基础街道上行驶可能需要的附加时间或距离。例如,点障碍可用来显示一棵沿街倒下的树或是铁路道口上的时间延迟。

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

字段说明数据类型

Name

障碍的名称。

字符串

BarrierType

指定点障碍是完全限制通行还是增加通过障碍时的时间或距离。此特性值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(限制型)- 禁止穿过障碍。此障碍称为限制型点障碍,因为它作为限制使用。

  • 2(增加成本型)- 穿过此障碍会增加行驶时间或行驶距离,增加量由 Additional_TimeAdditional_DistanceAdditional_Cost 字段指定。此障碍类型称为增加成本型点障碍。

短整型

Additional_Time

穿越障碍时增加的行驶时间。此字段仅适用于增加成本型障碍。

该字段值必须大于或等于零,并且值将以 timeUnits 属性指定的单位进行解释。

双重

Additional_Distance

穿越障碍时增加的距离。此字段仅适用于增加成本型障碍。

该字段值必须大于或等于零,并且值将以 distanceUnits 属性指定的单位进行解释。

双重

Additional_Cost

穿越障碍时增加的成本。此字段仅适用于增加成本型障碍。

该字段值必须大于或等于零,并且值将以未知单位进行解释。

双重

FullEdge

指定分析期间如何将限制点障碍应用于边元素。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0 (False) - 允许沿边行进到障碍,但不允许穿过障碍。这是默认值。
  • 1 (True) - 禁止沿关联边的任何位置行进。

短整型

CurbApproach

指定受障碍影响的行驶方向。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(车辆的任一侧)- 障碍将影响在边左右两个方向上行驶的车辆。
  • 1(车辆右侧)- 只会影响车辆的右行方向(障碍位于车辆左侧)。在同一条边上行驶但从左侧接近障碍的车辆不会受到障碍的影响。
  • 2(车辆左侧)- 只会影响车辆的左行方向(障碍位于车辆左侧)。在同一条边上行驶但从右侧接近障碍的车辆不会受到障碍的影响。

由于交汇点是点且不分左右侧,所以无论路边通道如何设置,交汇点上的障碍都会影响所有车辆。

CurbApproach 属性将使用以下两种国家驾驶标准:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的设施点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近设施点,也就是说,只能从车辆的右侧或左侧接近设施点。例如,要到达一个设施点并且在车辆与设施点之间不存在其他交通车道,应在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

短整型

Bearing

点移动的方向。单位为度,并且从正北方向开始顺时针进行测量。该字段与 BearingTol 字段结合使用。

方位角数据通常会从配有 GPS 接收器的移动设备自动发送。如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。

使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。方位角也可帮助工具确定点在街道的哪一边上。

了解有关方位角和方位角容差的详细信息

双重

BearingTol

使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。如果 Bearing 字段中的值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。

单位为度,默认值为 30。值必须大于 0 且小于 180。值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。

了解有关方位角和方位角容差的详细信息

双重

NavLatency

如果 BearingBearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 BearingBearingTol 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。

NavLatency 的单位与阻抗属性的单位相同。

NavLatency 的时间单位与分析对象的 timeUnits 属性指定的单位相同。

双重

网络位置字段

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

结合使用这些属性可描述网络中对象所在的点。

了解有关在网络中定位输入的详细信息

LineBarriers

使用此参数可指定一条或多条线,用于禁止在线与街道相交的位置通行。例如,线障碍可用于对阻塞若干个路段交通的游行或抗议队伍进行建模。线障碍还可用于快速隔离多条道路使其禁止被穿越,从而在可能的路径中去除不符合要求的街道网络部分。

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

字段说明数据类型

Name

障碍的名称。

字符串

BarrierType

指定障碍是完全禁止通行还是按比例调整穿过成本(例如时间或距离)。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(限制型)- 禁止穿行障碍物与交通网络相交的任何位置。障碍称为限制型线障碍。

  • 1(按比例调整成本型)- 通过使用 ScaledTimeFactorScaledDistanceFactor 字段指定的系数,按比例调整在基础街道上行进所需的成本(例如行程时间或距离)。如果障碍部分覆盖了街道,则会按比例调整行驶时间或行驶距离。例如,系数 0.25 表示在基础街道上行进的速度是正常速度的四倍。系数 3.0 表示预期在基础街道上行进相同距离所花费的时间为正常值的三倍。此障碍类型称为按比例调整成本型障碍。可使用该障碍对施工期间交通车道封闭造成的减速进行建模。

短整型

ScaledTimeFactor

它是与障碍相交街道的行驶时间要乘以的因子。该字段值必须大于零。

此字段仅适用于增加成本型障碍。

双重

ScaledDistanceFactor

它是与障碍相交街道的距离要乘以的因子。该字段值必须大于零。

此字段仅适用于增加成本型障碍。

双重

ScaledCostFactor

它是与障碍相交街道的成本要乘以的因子。该字段值必须大于零。

此字段仅适用于增加成本型障碍。

双重

Locations

此字段中的信息将定义线或面覆盖的网络边和交汇点,以及覆盖的每个边元素部分。您无法直接读取或编辑此字段中包含的信息,但是在求解分析时,Network Analyst 将对其进行解释。

了解有关在网络中定位输入的详细信息

Blob

PolygonBarriers

使用此参数可指定面,用于完全限制通行或按比例调整行驶在面相交的街道上所需的行驶时间或距离。

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

字段说明数据类型

Name

障碍的名称。

字符串

BarrierType

指定障碍是完全禁止通行还是按比例调整穿过成本(例如时间或距离)。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(限制型)- 禁止穿过障碍的任何部分。此障碍称作限制型面障碍,因为它禁止在与障碍相交的街道上行驶。此类障碍的一个具体应用是对覆盖街道中某些区域且导致街道无法通行的洪水进行建模。

  • 1(按比例调整成本型)- 通过使用 ScaledTimeFactorScaledDistanceFactor 字段指定的系数,按比例调整在基础街道上行进所需的成本(例如行程时间或距离)。如果障碍部分覆盖了街道,则会按比例调整行驶时间或行驶距离。例如,系数 0.25 表示在基础街道上行进的速度是正常速度的四倍。系数 3.0 表示预期在基础街道上行进相同距离所花费的时间为正常值的三倍。此障碍类型称为调整成本型面障碍。可用于对导致特定区域的行进速度减慢的暴风雨进行建模。

短整型

ScaledTimeFactor

它是与障碍相交街道的行驶时间要乘以的因子。该字段值必须大于零。

此字段仅适用于增加成本型障碍。

双重

ScaledDistanceFactor

它是与障碍相交街道的距离要乘以的因子。该字段值必须大于零。

此字段仅适用于增加成本型障碍。

双重

ScaledCostFactor

它是与障碍相交街道的成本要乘以的因子。该字段值必须大于零。

此字段仅适用于增加成本型障碍。

双重

Locations

此字段中的信息将定义线或面覆盖的网络边和交汇点,以及覆盖的每个边元素部分。您无法直接读取或编辑此字段中包含的信息,但是在求解分析时,Network Analyst 将对其进行解释。

了解有关在网络中定位输入的详细信息

Blob