OriginDestinationCostMatrix 输入数据类型

以下介绍了执行起点 - 目的地成本矩阵分析时可指定的输入数据类型。

起点

指定行驶到目的地的起点。

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

字段说明数据类型

Name

起点的名称。该名称可以是起点的唯一标识符。该名称包含在输出线 (作为 OriginName 字段)和输出起始点(作为 Name 字段)中,并且可将工具输出的附加信息连接到起始点的属性。

如果未指定名称,则会自动生成前缀为 Location 的唯一名称。

字符串

TargetDestinationCount

要为起始点查找的最大目的地数。

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

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

默认值为 Null,这会导致所有起点均使用 defaultDestinationCount 属性设置的默认值。

整数

Cutoff

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

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

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

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

双重

CurbApproach

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

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

CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的起始点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。根据不同国家的驾驶标准,您可能需要决定从起始点离开的方向,即从车辆的左侧或右侧离开起始点。例如,如果要从某个起点出发并且在车辆与起点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

短整型

Bearing

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

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

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

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

双重

BearingTol

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

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

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

双重

NavLatency

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

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

双重

网络位置字段

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

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

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

目的地

指定要从起点行驶至的终点位置。

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

字段说明数据类型

Name

目的地的名称。该名称可以是目的地的唯一标识符。该名称包含在输出线(作为 DestinationName 字段)和输出目的地(作为 Name 字段)中,并且可用于将工具输出的附加信息连接到目的地的属性。

如果未指定名称,则会自动生成前缀为 Location 的唯一名称。

字符串

CurbApproach

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

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

CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的起始点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。根据不同国家的驾驶标准,您可能需要决定从起始点离开的方向,即从车辆的左侧或右侧离开起始点。例如,如果要从某个起点出发并且在车辆与起点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

整数

Bearing

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

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

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

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

双重

BearingTol

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

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

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

双重

NavLatency

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

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

双重

网络位置字段

  • 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 的单位与阻抗属性的单位相同。

双重

网络位置字段

  • 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