下面介绍了执行路径分析时可以指定的输入数据类型。
Stops
指定一条或多条输出路径将访问的位置。
数据类型支持以下字段:
字段 | 描述 | 数据类型 |
---|---|---|
Name | 停靠点的名称。 该名称用于行驶方向中。 如果未提供名称,则会在输出停靠点、路径和方向中自动生成前缀为 Location 的唯一名称。 | 文本 |
RouteName | 停靠点所属路径的名称。 将相同 RouteName 值的停靠点分组在一起。 通过使用此字段,可以将停靠点分组到不同路径,并且输出将尝试为每组停靠点生成一个路径。
| 文本 |
Sequence | 输出路径将按照您使用此属性指定的顺序访问停靠点。 在一组具有相同 RouteName 值的停靠点中,序号应大于 0 且不大于停靠点的总数。 同样,序号之间不应该重复。 如果 findBestSequence 属性设置为 True,将忽略每个路径名称的所有值(第一个和最后一个序列值可能除外),以便工具可以找到尽可能缩短每条路径的总行程的序列。 preserveFirstStop、preserveLastStop 和 returnToStart 属性的值可确定是否忽略每条路径的第一个或最后一个序列值。 | 长整型 |
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 | 指定车辆到达和离开停靠点的方向。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
CurbApproach 属性适用于以下两种国家驾驶标准:右侧通行(美国)和左侧通行(英国)。 首先,考虑位于车辆左侧的停靠点。 不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。 不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近停靠点,也就是说,只能从车辆的右侧或左侧接近停靠点。 例如,要到达一个停靠点并且在车辆与停靠点之间不存在其他交通车道,在美国应该选择 1(车辆的右侧),而在英国应该选择 2(车辆的左侧)。 | 长整型 |
LocationType | 指定停靠点类型。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
| 长整型 |
Bearing | 点移动的方向。 单位为度,从正北开始沿顺时针方向进行测量。 该字段与 BearingTol 字段结合使用。 方位角数据通常会从配有 GPS 接收器的移动设备自动发送。 如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。 使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。 方位角也可帮助工具确定点在街道的哪一边上。 | 双精度 |
BearingTol | 使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。 如果 Bearing 字段值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。 单位为度,默认值为 30。 值必须大于 0 且小于 180。 值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。 | 双精度 |
NavLatency | 如果 Bearing 和 BearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 Bearing 和 BearingTolNavLatency 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。 NavLatency 的单位与阻抗属性的单位相同。 NavLatency 的时间单位与由分析对象的 timeUnits 属性指定的单位相同。 | 双精度 |
网络位置字段
| 结合使用这些属性可描述网络中对象所在的点。 |
PointBarriers
使用此参数可指定一个或多个点作为临时限制,或表示在基础街道上行驶可能需要的附加时间或距离。 例如,点障碍可用来显示一棵沿街倒下的树或是铁路道口上的时间延迟。
数据类型支持以下字段:
字段 | 描述 | 数据类型 |
---|---|---|
Name | 障碍名称。 | 文本 |
BarrierType | 指定点障碍是完全限制通行还是增加通过障碍时的时间或距离。 此特性值可指定为以下整数之一(请使用数值代码而非括号中的名称):
| 长整型 |
Additional_Time | 遍历障碍时增加的行驶时间。 该字段值必须大于或等于零,并且值将以 timeUnits 属性指定的单位进行解释。 | 双精度 |
Additional_Distance | 遍历障碍时增加的距离。 该字段值必须大于或等于零,并且值将以 distanceUnits 属性指定的单位进行解释。 | 双精度 |
AdditionalCost | 遍历障碍时增加的成本。 该字段值必须大于或等于零,并且值将以未知单位进行解释。 | 双精度 |
FullEdge | 指定分析期间如何将限制点障碍应用于边元素。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
| 长整型 |
CurbApproach | 指定受障碍影响的行驶方向。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
由于交汇点是点且不分左右侧,所以无论路边通道如何设置,交汇点上的障碍都会影响所有车辆。 CurbApproach 属性适用于以下两种国家驾驶标准:右侧通行(美国)和左侧通行(英国)。 首先,考虑位于车辆左侧的设施点。 不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。 不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近设施点,也就是说,只能从车辆的右侧或左侧接近设施点。 例如,要到达一个设施点并且在车辆与设施点之间不存在其他交通车道,应在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。 | 长整型 |
Bearing | 点移动的方向。 单位为度,从正北开始沿顺时针方向进行测量。 该字段与 BearingTol 字段结合使用。 方位角数据通常会从配有 GPS 接收器的移动设备自动发送。 如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。 使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。 方位角也可帮助工具确定点在街道的哪一边上。 | 双精度 |
BearingTol | 使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。 如果 Bearing 字段值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。 单位为度,默认值为 30。 值必须大于 0 且小于 180。 值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。 | 双精度 |
NavLatency | 如果 Bearing 和 BearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 Bearing 和 BearingTolNavLatency 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。 NavLatency 的单位与阻抗属性的单位相同。 NavLatency 的时间单位与由分析对象的 timeUnits 属性指定的单位相同。 | 双精度 |
网络位置字段
| 结合使用这些属性可描述网络中对象所在的点。 |
LineBarriers
使用此参数可指定一条或多条线,用于禁止在线与街道相交的位置通行。 例如,线障碍可用于对阻塞若干个路段交通的游行或抗议队伍进行建模。 线障碍还可隔离多条道路以禁止进行遍历,从而在可能的路径中去除不符合要求的街道网络部分。
数据类型支持以下字段:
字段 | 描述 | 数据类型 |
---|---|---|
Name | 障碍名称。 | 文本 |
BarrierType | 指定障碍是完全禁止通行还是按比例调整穿过成本(例如时间或距离)。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
| 长整型 |
ScaledTimeFactor | 它是与障碍相交街道的行驶时间要乘以的因子。 该字段值必须大于零。 | 双精度 |
ScaledDistanceFactor | 它是与障碍相交街道的距离要乘以的因子。 该字段值必须大于零。 | 双精度 |
ScaledCostFactor | 这是与障碍相交的街道的成本要乘以的系数。 该字段值必须大于零。 | 双精度 |
Locations | 此字段中的信息将定义线或面覆盖的网络边和交汇点,以及覆盖的每个边元素部分。您无法直接读取或编辑此字段中包含的信息,但是在求解分析时,Network Analyst 将对其进行解释。 | BLOB |
PolygonBarriers
使用此参数可指定面,用于完全限制通行或按比例调整行驶在面相交的街道上所需的行驶时间或距离。
数据类型支持以下字段:
字段 | 描述 | 数据类型 |
---|---|---|
Name | 障碍名称。 | 文本 |
BarrierType | 指定障碍是完全禁止通行还是按比例调整穿过成本(例如时间或距离)。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
| 长整型 |
ScaledTimeFactor | 它是与障碍相交街道的行驶时间要乘以的因子。 该字段值必须大于零。 | 双精度 |
ScaledDistanceFactor | 它是与障碍相交街道的距离要乘以的因子。 该字段值必须大于零。 | 双精度 |
ScaledCostFactor | 这是与障碍相交的街道的成本要乘以的系数。 该字段值必须大于零。 | 双精度 |
Locations | 此字段中的信息将定义线或面覆盖的网络边和交汇点,以及覆盖的每个边元素部分。您无法直接读取或编辑此字段中包含的信息,但是在求解分析时,Network Analyst 将对其进行解释。 | BLOB |