路径输入数据类型

下面介绍了执行路径分析时可以指定的输入数据类型。

停靠点

指定一条或多条输出路径将访问的位置。

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

字段说明数据类型

Name

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

字符串

RouteName

分配给停靠点的路径的名称。将相同的路径名称分配到不同的停靠点会导致这些停靠点被归为一组,并由同一路径进行访问。通过将唯一的路径名称分配到不同的停靠点组,可以在一个求解操作中生成多个路径。

字符串

Sequence

输出路径将按照您使用此属性指定的顺序访问停靠点。在一组具有相同 RouteName 值的停靠点中,序号应大于 0 且不大于停靠点的总数。而且,序号不应重复。

如果 findBestSequence 属性设置为 True,将忽略每个路径名称的所有值(第一个和最后一个序列值可能除外),以便工具可以找到尽可能缩短每条路径的总行程的序列。preserveFirstStoppreserveLastStopreturnToStart 属性的值可确定是否忽略每条路径的第一个或最后一个序列值。

整数

AdditionalTime

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

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

您可以将为了完成任务而在停靠点花费的额外时间考虑在内,例如,维修设备、配送包裹或检查场所。

双重

AdditionalDistance

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

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

通常,停靠点的位置(例如住宅)并不是恰好位于街道上,而是位于道路的后方。如果有必要将停靠点的实际位置与其在街道上的位置之间的距离计入总行驶距离,则可使用该属性值构建此段距离。

双重

AdditionalCost

在停靠点花费的额外成本,该成本将添加到路径总成本中。默认值为 0。

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

双重

TimeWindowStart

可以访问停靠点的最早时间。通过为停靠点时间窗指定开始时间和结束时间,您可以定义路径应在何时访问停靠点。当分析的出行模式使用基于时间的阻抗属性时,指定时间窗口值将使分析查找以下解决方案:尽可能缩短总行程并在规定时间窗口内到达停靠点。

此属性的值应为日期和时间值,可以使用 datetime Python 对象进行指定,例如 datetime.datetime(2019, 5, 11, 8, 30, 0),表示 2019 年 5 月 11 日,星期六,上午 08:30:00。值的时区由分析对象的 timeZoneForTimeWindows 属性指定。

此字段可以包含空值;空值表示路径可以在 TimeWindowEnd 属性中所指定时间之前的任意时间到达。如果 TimeWindowEnd 中也出现空值,则路径可以随时访问停靠点。

日期型

TimeWindowEnd

可以访问停靠点的最晚时间。通过为停靠点时间窗指定开始时间和结束时间,您可以定义路径将在何时访问停靠点。当分析的出行模式使用基于时间的阻抗属性时,指定时间窗口值将使分析查找以下解决方案:尽可能缩短总行程并在规定时间窗口内到达停靠点。

此属性的值应为日期和时间值,可以使用 datetime Python 对象进行指定,例如 datetime.datetime(2019, 5, 11, 17, 30, 0),表示 2019 年 5 月 11 日,星期六,17:30:00。值的时区由分析对象的 timeZoneForTimeWindows 属性指定。

此字段可以包含空值;空值表示路径可以在 TimeWindowStart 属性中所指定时间之后的任意时间到达。如果 TimeWindowStart 中也出现空值,则路径可以随时访问停靠点。

日期型

CurbApproach

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

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

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

整数

LocationType

指定停靠点类型。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(停靠点)- 路径将访问的位置。这是默认设置。
  • 1(航路点)- 路径将经过但不停靠的位置。航路点可用于强制路径采用特定路线(经过航路点),无需将其视为实际停靠点。航路点不会显示在方向上。

整数

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