Skip to main content

路径输入数据类型

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

Stops

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

数据类型支持以下字段:

字段

描述

数据类型

Name

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

文本

RouteName

停靠点所属路径的名称。 将相同 RouteName 值的停靠点分组在一起。

通过使用此字段,可以将停靠点分组到不同路径,并且输出将尝试为每组停靠点生成一个路径。

  • 如果某些停靠点有路径名称,会将其分组到具有相同名称的路径。 如果某些停靠点有 RouteName 值而其他停靠点没有,会在结果中将这些没有路径名称的停靠点列为未分配停靠点,并忽略对其解决。

  • 如果所有停靠点都没有 RouteName 值,那么所有停靠点属于相同路径,并且生成一个路径。

  • RouteName 值不区分大小写。 例如,Route 1 和 ROUTE 1 将被视为同一条路径。

文本

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 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。

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

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

双精度

网络位置字段

  • SourceID

  • SourceOID

  • PosAlong

  • SideOfEdge

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

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

PointBarriers

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

数据类型支持以下字段:

字段

描述

数据类型

Name

障碍名称。

文本

BarrierType

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

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

  • 2(增加成本型)- 穿过此障碍会增加通过 Additional_TimeAdditional_DistanceAdditionalCost 字段指定的行驶时间或行驶距离的数值。 此障碍类型称为增加成本型点障碍。

长整型

Additional_Time

遍历障碍时增加的行驶时间。

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

双精度

Additional_Distance

遍历障碍时增加的距离。

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

双精度

AdditionalCost

遍历障碍时增加的成本。

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

双精度

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 值的输入也是可选的。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