6     交通网络分析

    6.1 交通网络分析的内容

    6.2 交通网络分析的流程

    6.3 设置交通网络分析环境

    6.4 数据检查

    6.5 加载交通网络模型

    6.6 设置交通网络分析参数

    6.7 最佳路径分析

    6.8 最近设施查找分析

    6.9 旅行商分析

    6.10 多旅行商分析（物流配送）

    6.11 服务区分析

    6.12 选址分区分析

    6.13 其他功能

6.1    交通网络分析的内容 目录

SuperMap 交通网络分析提供以下主要分析功能：

以上分析功能及实现方法将分别在6.7-6.12各个小节中进行详细介绍。此外，SuperMap交通网络分析还提供了其他一些辅助分析的功能，如计算耗费矩阵、更新弧段权值、更新转向权值等将统一在6.13一节中进行介绍。

在深入了解交通网络分析的各个功能和使用方法之前，建议您首先对交通网络分析的流程进行了解。

6.2    交通网络分析的流程 目录

交通网络分析的一般流程可以归纳如下：

1.      根据已有的数据，构建网络数据集，这是交通网络分析的首要步骤；

2.      设置交通网络分析环境，包括网络数据集及其拓扑关系字段、权值信息、转向表及转向权值信息、障碍信息以及交通规则等等；

3.      通过数据检查功能查找网络数据集和转向表的错误，根据错误信息对网络数据集或源数据进行修改，重复该步骤直至检查无误；

4.      加载交通网络模型；

5.      进行交通网络分析。分析前，需要设置交通网络分析参数，包括用于分析的点、障碍信息、权值信息、返回哪些分析结果等。其中，选址分区分析与其他分析功能不同，需要设置选址分区分析参数。

关于如何构建网络数据集，请参见SuperMap iDesktop帮助文档的网络分析相关介绍。对之后的各个步骤，将在下面的各个小节中分别进行介绍。

6.3    设置交通网络分析环境 目录

设置交通网络分析环境是通过设置交通网络分析（TransportationAnalyst）类的setAnalystSetting方法实现的，我们需要为该方法设置一个TransportationAnalystSetting对象，该对象提供了交通网络分析所需要的参数的设置，这些参数包括：网络数据集及其拓扑关系字段（结点ID字段、弧段ID字段、起始结点ID字段和终止结点ID字段）、权值字段信息、转向表及转向权值信息、障碍信息以及交通规则等，这些参数的设置将直接影响到交通网络分析的结果。因此，交通网络分析环境设置实质上是对交通网络分析环境设置（TransportationAnalystSetting）类的方法进行设置，表 6.1列出了该类的各个方法及其含义。

表 6.1 TransportationAnalystSetting类的方法列表

下面对交通网络分析环境的部分参数做进一步的说明。

网络数据集及其拓扑关系字段（setNetworkDataset、setNodeIDField、setEdgeIDField、setFNodeIDField、setTNodeIDField）

网络数据集中表达其拓扑关系的字段包括：结点ID字段、弧段ID字段、弧段的起始结点ID字段和终止结点ID字段。必须指定用于分析的网络数据集及其拓扑关系字段，才能够保证网络的可用性，从而进一步完成交通网络分析。有关网络数据集及其拓扑关系字段的介绍，请参阅第5章。

TransportationAnalystSetting对象的setNetworkDataset方法用于指定网络数据集，setNodeIDField、setEdgeIDField、setFNodeIDField、setTNodeIDField方法分别用于设置网络数据集中的结点 ID 字段、弧段 ID 字段、起始结点 ID 字段和终止结点 ID 字段。

弧段权值字段信息（setWeightFieldInfos）

弧段权值是指通过该弧段的花费，分为正向权值和反向权值，从该弧段的起始结点到达终止结点的花费称为正向权值（或正向阻力），反之为反向权值（或反向阻力）。弧段权值需要从网络数据集的弧段属性表中指定两个字段，分别为正向权值字段和反向权值字段。弧段权值可以是任意类型，如经过该弧段所需的时间、该弧段的长度、该弧段一段时间内的平均拥堵情况、该弧段的交通事故率等。

在交通网络分析环境设置（TransportationAnalystSetting）类中，通过setWeightFieldInfos方法来设置弧段权值，并且为该方法指定的是一个权值字段信息集合（WeightFieldInfos）对象，该对象是权值字段信息（WeightFieldInfo）对象的一个集合，其中的每一个WeightFieldInfo对象可以指定一对权值字段（正向权值字段和反向权值字段），并为此权值字段信息命名，该名称是该权值字段信息的唯一标识。表 6.2列出了WeightFieldInfo类的方法及其含义。

虽然在交通网络分析时只能使用一种弧段权值，但在分析环境中指定权值字段信息的集合的好处是：在分析环境设定多种权值，然后在分析时通过参数类指定具体使用哪种权值，这样就可以方便地变换弧段权值，而不需要重新设置交通网络分析环境。例如，分析从A到B的最佳路径，可以将弧段权值设置为道路的长度，分析结果就是最短路径；将弧段权值设置为通过该弧段花费的时间，那么分析结果就是时间最短的路径。由此也可见，弧段权值直接影响的分析结果的含义。

表 6.2 WeightFieldInfo类的方法列表

障碍结点、边（setBarrierNodes、setBarrierEdges）

障碍，顾名思义，是网络中不能通行的部分，可以是障碍边（也称障碍弧段）、障碍结点。在交通网络分析环境中，可以通过setBarrierEdges方法将某些弧段设置为障碍边，通过setBarrierNodes方法将若干结点设置为障碍点。一旦一条弧段被设置为障碍边，就表示这条边在分析过程中是禁行的。同样，一旦某结点被设置为障碍点，则分析时该结点是禁止通行的。

值得一提的是，障碍点和障碍边还可以在分析时在有关参数类中指定，并且它们与交通网络分析环境中指定的障碍是共同生效的。这在之后的小节中还会介绍。

点到弧段的距离容限（setTolerance）

原则上，在交通网络分析中，可以指定网络中任意的点作为分析的经过点或障碍点，但应该在网络附近。如果这个点不在网络上（既不在弧段上也不在结点上），网络分析会根据该距离容限把该点归结到网络上，如图 6-1所示，桔色点代表网络结点，蓝色代表弧段，灰色点为站点，红色线段是站点到弧段 AB 的距离，如果该距离在设定的距离容限内，则把站点归结到弧段 AB 上。这个距离容限值通过setTolerance方法设置。

设置合适的距离容限值才能保证网络分析的正常进行，如果设置得不合理，可能导致指定的点不能归结到网络上从而导致分析无结果或不正确。这里提供一种计算合理距离容限值的方法：

1.      计算出网络数据集中包含所有对象的最小外接矩形；

2.    计算出该矩形对象的高度及宽度；

3.      取两者中的较小值除以 40，得出较合适的距离容限。

交通规则（setRuleField）

常用的交通规则包括：道路为正向单行线、逆向单行线、双向通行线或禁行线。其中，正向是指弧段上从起始结点到终止结点的方向，逆向则相反。setRuleField方法用于指定网络数据集中代表交通规则的字段。该字段被要求是一个文本型字段，其字段值则是代表具体的交通规则的字符串。而何种字符串表示何种交通规则，则是通过设置setFTSingleWayRuleValues、setTFSingleWayRuleValues、setProhibitedWayRuleValues和setTwoWayRuleValues四个方法来完成的。例如，通过setFTSingleWayRuleValues方法可以设置代表正向单行线的字符串，并且允许设置多个不同的字符串，那么当交通规则字段的值是指定的这些字段时，对应的弧段则按照正向单行线处理。

转向表及转向权值字段集合（setTurnDataset、setTurnWeightFields）

转向表是一个纯属性表数据集。它记录了一个结点处各个转弯的花费。有关转向表的具体介绍请参阅第3章。另外，创建转向表请参见SuperMap iDesktop帮助文档的网络分析相关介绍，使用者可以根据实际情况进行加工。

通过setTurnDataset方法可以指定转向表，同时需要指定转向表中的转向结点 ID 字段、起始弧段 ID 字段和终止弧段 ID 字段，分别通过setTurnNodeIDField、setTurnFEdgeIDField和setTurnTEdgeIDField方法设置。

与弧段权值相同，可以在转向表中创建多个字段，表示不同情形时的转向取值。类似地，可以通过setTurnWeightFields方法设置多个转向权值字段。

弧段名称字段（setEdgeNameField）

可以通过setEdgeNameField方法指定网络数据集中代表弧段名称的字段。弧段名称用于在交通网络分析的路径分析的行驶导引中显示。如果不设置此字段，或者指定的字段不存在，分析结果中是不会包含行驶导引的，这一点需要非常注意。

弧段过滤表达式（setEdgeFilter）

如果通过setEdgeFilter方法设置了弧段过滤表达式，则只有符合表达式条件的弧段参与交通网络分析。当实际分析中不需要网络中所有的弧段参与时，可以设置过滤表达式从而只让符合条件的弧段参与分析，并且可能提高分析的性能。

6.4    数据检查 目录

第5章介绍了三个构建网络数据集的方法。其中，方法三由于完全按照点、线数据集已有的拓扑关系字段来构建网络，因此，如果这些字段存在错误，构建的网络数据集也会有误。而其他两种方式构建出的网络数据集理论上是不会存在错误的，因此，后期对网络数据集进行了修改，是最有可能的错误来源。

但无论何种原因导致的错误，都可能影响交通网络分析的结果。因此，SuperMap在TransportationAnalystSetting类提供了交通网络数据检查功能，即check方法。该方法可以对交通网络数据集和对应的转向表进行检查。注意，该方法需要在设置交通网络分析环境，也就是设置了TransportationAnalyst类的setAnalystSetting方法之后调用。

语法：

public TransportationAnalystCheckResult check()

返回值说明：

交通网络分析数据检查结果。

该方法返回一个交通网络分析数据检查结果（TransportationAnalystCheckResult）对象，通过该对象的的 getArcErrorInfos 和 getNodeErrorInfos 方法可以返回网络数据集的弧段错误信息和结点错误信息；通过 getTurnErrorInfos 方法可以获取转向表的错误信息。以上三个方法的返回值是字典（Dictionary），错误信息分别存储其中，键代表错误弧段或结点的 SMID，值代表错误类型。错误类型以数字表示，代表的具体错误含义如表 6.3和表 6.4所示。

表 6.3 网络数据集检查错误类型及说明

表 6.4 转向表检查错误类型及说明

6.5    加载交通网络模型 目录

当设置好了交通网络分析环境，即设置了TransportationAnalyst类的setAnalystSetting后，需要调用TransportationAnalyst类的load方法，来加载交通网络模型。该过程将按照交通网络分析环境的设置，构建交通网络模型，存储于内存中。只有调用了该方法，所做的分析环境设置才会在交通网络分析的过程中生效。

语法：

public boolean load()

返回值说明：

加载成功返回true，失败返回false。

注意：

1.    如果对交通网络分析环境设置（TransportationAnalystSetting）进行了修改，或对网络数据集进行了修改，都需要重新调用load方法加载网络模型，否则分析可能出错或结果不正确。

2.    如果没有修改交通网络分析环境或网络数据集，进行分析时不需要重复调用load方法。如果需要再次调用load方法，必须先使用dispose方法释放资源，否则加载可能失败。

6.6    设置交通网络分析参数 目录

在进行最佳路径分析、最近设施查找分析、旅行商分析、多旅行商分析和服务区分析时，都使用了TransportationAnalystParameter类型的对象作为参数。选址分区使用单独的参数类LocationAnalystParameter进行参数设置，之后在介绍选址分区时再进行说明。

通过TransportationAnalystParameter对象的方法，可以为相应的交通网络分析功能提供参数，包括分析途径的点或结点、障碍边、障碍点、权值字段信息的名字标识、转向权值字段，以及分析结果是否返回途经结点集合，途经弧段集合，路由对象集合以及行驶导引等。下面详细介绍TransportationAnalystParameter类的方法，如表 6.5所示：

表 6.5 TransportationAnalystParameter类的方法列表

结点模式与坐标点模式（setNodes、setPoints）

结点模式是指分析点为结点，用户需要指定对应结点的结点ID；坐标点模式是指分析点为坐标点，用户可以指定对应的坐标点。最佳路径分析、最近设施查找分析、旅行商分析、多旅行商分析和服务区分析均支持这两种模式，但需要注意并非分析中所使用的点都通过setNodes或setPoints指定，不同的分析功能需要在TransportationAnalystParameter指定的分析点有所不同，具体在介绍相应的分析功能时会进行说明。

特别需要强调的是，这两种模式是互斥的，原则上不要同时设置。如果同时进行设置，那么会以分析前的最后一个设置为准。例如，先使用setNodes方法指定了结点集合，又使用setPoints方法指定了坐标点集合，然后分析，此时只对坐标点进行分析。

障碍（setBarrierNodes、setBarrierEdges、setBarrierPoints）

setBarrierNodes、setBarrierEdges、setBarrierPoints三个方法分别用于指定障碍结点、障碍弧段和障碍点。在设置交通网络分析时，也可以指定障碍结点和障碍弧段，在分析时，这两处所指定的障碍结点和障碍弧段是共同生效的。

这里需要说明是障碍点。与障碍结点和障碍弧段不同，障碍点可以不在网络上（既不在弧段上也不在结点上），因此分析时需要根据距离容限（setTolerance）把障碍点归结到最近的网络上。距离容限是在交通网络分析环境中设置的，具体请参阅6.3小节。目前支持对最佳路径分析、最近设施查找、旅行商分析和物流配送分析设置障碍点。

是否返回行驶导引（setPathGuidesReturn）

首先来了解什么是行驶导引（PathGuide）：

行驶导引记录了最佳路径分析、最近设施查找、旅行商分析和多旅行商分析等常用交通网络分析（TransportationAnalyst）结果中的路径信息。一个行驶导引对象对应着一条从起点到终点的行驶路线。行驶导引由行驶导引子项（PathGuideItem）构成。行驶导引由行驶路线的一些关键要素构成，包括站点（即用户输入的用于分析的点，可以为普通的点坐标或者结点）、一般网络结点（如某个道路交叉口）和网络模型上的弧段（如某某路）等，这些关键要素的信息（如长度、方向等）就是由行驶导引子项来描述的。也可以说行驶导引子项就是行驶路线上的关键要素。

行驶导引子项可以概括为以下五类：

1.    站点：即用户选择的用于分析的点，如进行最佳路径分析时指定的要经过的各个点。

2.    站点到网络的线段：当站点为普通的坐标点时，需要首先将站点归结到网络上，才能基于网络进行分析。请参见 TransportationAnalystSetting 类的 setTolerance 方法的介绍。

如下图所示，红色虚线即为站点到网络的最短直线距离。注意，当站点在网络弧段的边缘附近时，如右图所示，这段距离是指站点与弧段端点的连线距离。

3.    站点在网络上的对应点：与“站点到网络的线段”对应，这个点就是将站点（普通坐标点）归结到网络上时，网络上相应的点。上面左图所示的情形，这个点就是站点在对应弧段上的垂足点；上面右图所示的情形，这个点则为弧段的端点。

4.    路段：也就是行驶经过的一段道路。交通网络中用弧段模拟道路，因此行驶路段都位于弧段上。注意，多个弧段可能被合并为一个行驶导引子项，合 并的条件是它们的弧段名称相同，并且相邻弧段间的转角小于 30 度。需要强调，到达站点前的最后一个行驶路段和到达站点后的第一个行驶路段，仅包含一条弧段或弧段的一部分，即使满足上述条件也不会与相邻弧段合并为一个 行驶导引。

如下图所示，使用不同的颜色标示出了两个站点之间的行驶路段。其中，站点 1 之后的第一条路段（红色），虽然其所在弧段的名称与后面几条弧段的名称相同，且转向角度都小于 30 度，但由于它是站点后的第一条路段，因此并未将它们合并。而蓝色路段所覆盖的三条弧段，由于弧段名称相同且转角小于 30 度，故将它们合并为一个行驶导引子项；粉色路段由于与之前的路段具有不同的弧段名称，故成为另一个行驶导引子项；绿色路段由于是到达站点前的最后一条路 段，因此也单独作为一个行驶导引子项。

5.   转向点：两个相邻的行驶路段之间的路口。路口是指有可能发生方向改变的实际道路的路口（如十字路口或丁字路口）。在转向点处行驶方向可能发生改变。如上图中的结点 2783、2786 和 2691 都是转向点。转向点一定是网络结点。

通过行驶导引子项对象，可以获取路径中关键要素的 ID、名称、序号、权值、长度，还可以判断是弧段还是站点，以及行驶方向、转弯方向、花费等信息。按照行驶导引子项的序号对其存储的关键要素信息进行提取并组织，就可以描绘出如何从路径起点到达终点。表 6.6列出了PathGuideItem类的各个方法。

表 6.6 PathGuideItme类的方法列表

下面通过一个例子，来直观地了解行驶导引子项与行驶导引。

图 6-2中的蓝色虚线为最近设施查找分析的结果中的一条路径，在最近设施查找的返回结果中，可以获得这条路径对应的行驶导引。这条路径共包含7个行驶导引子项，包括2个站点（起点和终点）、3个弧段（即路段）和2个结点（即路口）。

下表列出了上图所示的路径所包含的7个行驶导引子项的信息，包括是否为站点、是否为弧段、序号、行驶方向、转弯方向、弧段名称等。注意，这里并未列出行驶导引子项包含的所有信息，如转弯角度、花费、站点到弧段的距离等，用户可根据实际需要决定是否需要这些信息。

按照上面的表格将行驶导引子项记录的信息加以组织，可以得到如下所示的该路径的导引描述：

这里需要特别注意，如果没有在TransportationAnalystSetting中指定弧段名称字段，或指定的字段不存在，则即使将setPathGuidesReturn设置为true，分析结果中也不会返回行驶导引，因为无法给出道路（即弧段）的名称，就不能够起到引导作用。

以上是进行交通网络分析之前普遍要操作的内容，尤其是交通网络分析环境设置是所有交通网络分析功能实现的前提，下面就具体介绍各个交通网络分析功能的实现过程以及介绍相关的概念。

6.7    最佳路径分析 目录

最佳路径分析，是指在网络上选择N（N大于等于2）个点（称为途经点），求解按照途经点的选择顺序，依次经过这些点的花费最小的路径。“花费最小”有多种理解，如基于单因素考虑的时间最短、费用最低、风景最好、路况最佳、过桥最少、收费站最少、经过乡村最多等。图 6-3展示了最佳路径分析的一个实例。

必须按照途经点的给定顺序访问途经点是最佳路径分析的重要特征。最佳路径分析可以理解为按照途经点的给定次序，依次查找两点间的最佳路径，最后加和。例如，要顺序访问1、2、3、4四个结点，则需要分别找到1、2结点间的最佳路径R1_2，2、3间的最佳路径R2_3和3、4结点间的最佳路径R3_4，顺序访问1、2、3、4四个结点的最佳路径R= R1_2 + R2_3 + R3_4。

6.7.1       最佳路径分析的实现方法

TransportationAnalyst类的findPath方法，用于实现最佳路径分析。按照交通网络分析的步骤，在加载网络模型之后，就可以调用该方法进行最佳路径分析了。

语法：

public TransportationAnalystResult findPath(TransportationAnalystParameter parameter，boolean hasLeastEdgeCount)

参数说明：

parameter：指定的交通网络分析参数。

hasLeastEdgeCount：指定是否按照弧段数最少查找。true 表示按照弧段数最少进行查询。

返回值说明：

分析结果对象。

进行最佳路径分析的N个途经点，是在TransportationAnalystParameter类型的参数parameter中指定的。可以选择结点模式，即通TransportationAnalystParameter对象的setNodes方法指定途经结点集合，或者坐标点模式，即使用setPoints方法指定途经坐标点集合，分析时的访问次序就是指定的途经点在集合中的次序。但注意，二者互斥，详细规则以及其他参数的说明请参阅6.6小节。

将方法中的hasLeastEdgeCount参数设置为true，则按照弧段数最小来查找最佳路径。由于弧段数少不代表弧段的权值小，所以此时查出的结果可能不是最小耗费路径。如图 6-4所示，如果连接 AB 的绿色路径的弧段数少于黄色路径，当该参数设置为 true 时，绿色路径就是查询得到的路径，设置为 false 时，黄色路径就是查询得到的路径。

6.7.2       最佳路径分析结果

最佳路径分析、最近设施查找分析、旅行商分析、多旅行商分析的结果均通过一个交通网络分析结果（TransportationAnalystResult）对象返回，通过该对象的方法可以获得途经结点集合、途经弧段集合、路由集合、行驶导引、权值数组等分析结果。表 6.7列出TransportationAnalystResult类的各个方法。

表 6.7 TransportationAnalystResult类的方法列表

 

以上是对TransportationAnalystResult的方法的基本介绍，下面针对最佳路径分析，着重介绍以下分析结果的具体含义：

途经弧段集合（getEdges）：由于分析结果只有一条路径，因此数组的一维长度为 1，二维元素为该路径途经弧段的弧段 ID。

途经结点集合（getNodes）：由于只有一条结果路径，因此数组的一维长度为 1，二维元素为该路径途经结点的结点 ID。

路由对象集合（getRoutes）：永远只有一条结果路由。

权值数组（getWeights）：因为只有一条路径，所以只有一个值，即该路径的总花费。

站点索引（getStopIndexes）：结果路径只有一条，故数组的一维长度为 1，二维元素表示结果路径经过站点的次序：

1.    结点模式：如设置的分析结点 ID 为 1，3，5 的三个结点，因为结果途经顺序必须为 1，3，5，所以二维元素值依次为 0，1，2，即结果途经顺序在初始设置结点串中的索引。

2.    坐标点模式：如设置的分析坐标点为 Pnt1，Pnt2，Pnt3，因为结果途经顺序必须为 Pnt1，Pnt2，Pnt3，所以二维元素值依次为 0，1，2，即结果途经坐标点顺序在初始设置坐标点串中的索引。

站点权值（getStopWeights）：由于结果路径只有一条，故数组的一维长度为 1。假设指定经过点 1、2、3，则二维元素依次为：1 到 2 的耗费、2 到 3 的耗费。

6.8    最近设施查找分析 目录

最近设施分析是指在网络上给定一个事件点和一组设施点，为事件点查找以最小耗费能到达的一个或几个设施点，结果为从事件点到设施点(或从设施点到事件点)的最佳路径。

设施点和事件点是最近设施查找分析的基本要素。设施点是提供服务的设施，如学校、超市、加油站等；事件点则是需要设施点的服务的事件位置。

例如，在某位置发生一起交通事故，要求查找在 10 分钟内最快到达的 3 家医院，超过 10 分钟能到达的都不予考虑。此例中，事故发生地即是一个事件点，周边的医院则是设施点。分析的结果如图 6-5所示，会给出从事故点能够最快到达的3家医院的路径。并且，最近设施查找实际上也是一种路径分析，因此，同样可以应用障碍边和障碍点的设置，在行驶路途上这些障碍将不能被穿越，在路径分析中会予以考虑。

6.8.1      最近设施查找分析的实现方法

按照交通网络分析的步骤，在加载网络模型之后，就可以调用对应的方法进行最近设施查找分析了。TransportationAnalyst类的提供了两个重载方法findClosestFacility，用于实现最佳路径分析。

方法一：根据指定的参数进行最近设施查找分析，事件点为结点 ID。

语法：

public TransportationAnalystResult findClosestFacility(TransportationAnalystParameter parameter，int eventID, int facilityCount, boolean isFromEvent, double maxWeight)

参数说明：

parameter：指定的交通网络分析参数。

eventID：指定的作为事件点的结点 ID。

facilityCount：指定的要查找的设施点数量。

isFromEvent：指定是否从事件点到设施点进行查找。指定为 true，表示从事件点到设施点进行查找；false 表示从设施点到事件点进行查找。

maxWeight：指定的查找半径。单位同网络分析环境中设置的权值字段。设为0表示查找整个网络。

返回值说明：

分析结果对象。

方法二：根据指定的参数进行最近设施查找分析，事件点为坐标点。

语法：

public TransportationAnalystResult findClosestFacility(TransportationAnalystParameter parameter，Point2D eventPoint, int facilityCount, boolean isFromEvent, double maxWeight)

参数说明：

parameter：指定的交通网络分析参数。

eventPoint：指定的事件点的位置。

facilityCount：指定的要查找的设施点数量。

isFromEvent：指定是否从事件点到设施点进行查找。指定为 true，表示从事件点到设施点进行查找；false 表示从设施点到事件点进行查找。

maxWeight：指定的查找半径。单位同网络分析环境中设置的权值字段。设为0表示查找整个网络。

返回值说明：

分析结果对象。

事件点允许为坐标点或结点ID，分别通过以上两个方法的eventID或eventPoint参数指定，而设施点则是在 TransportationAnalystParameter 类型的参数 parameter 中指定的。同样，设施点的指定方式也有两种：结点模式、坐标点模式，即通过TransportationAnalystParameter对象的setNodes方法，可以指定作为设施点的结点的结点ID集合，称为结点模式；通过setPoints方法，指定作为设施点所在位置的坐标点集合，这是坐标点模式。详见6.6小节。

除设施点外，通过TransportationAnalystParameter对象还可以设置其他一些用于分析的参数，具体内容参阅6.6小节。

6.8.2       最近设施查找分析结果

最近设施查找分析的结果信息需要通过TransportationAnalystResult类对象的相关方法返回，关于这些方法的基本介绍，请参阅6.6小节。这里针对最近设施查找商分析，着重介绍以下分析结果的具体含义：

途经弧段集合（getEdges）：由于分析结果中路径的数量与查找到的最近设施点的数目相同，因此数组的一维长度为结果设施点的个数，二维元素为该路径途经弧段的弧段 ID。

途经结点集合（getNodes）：由于分析结果中路径的数量与查找到的最近设施点的数目相同，因此数组的一维长度为结果设施点的个数，二维元素为各条路径途经结点的结点 ID。

路由对象集合（getRoutes）：查找到的设施个数就是结果路由的数量。

权值数组（getWeights）：权重值的个数与结果设施点的个数相同，每个元素代表从事件点到达该设施点的路径的总花费。

站点索引（getStopIndexes）：无效方法。

站点权值（getStopWeights）：无效方法。

6.9    旅行商分析 目录

旅行商分析是查找经过指定一系列点的路径，旅行商分析是无序的路径分析。旅行商可以自己决定访问结点的顺序，目标是旅行路线阻抗总和最小（或接近最小）。

SuperMap的旅行商分析，默认给定的旅行商经过点集合中的第一个点作为旅行商的起点，此外，用户还可以指定终点，如果选择指定终点，则给定的经过点集合的最后一个点为终点，此时，旅行商从第一个点出发，到指定的终点结束，而其他经过点的访问次序由旅行商自己决定。如果不指定终点，则旅行商从起点出发，而其他点的访问次序由旅行商决定，即按照总花费最小的原则决定访问顺序。图 6-6为不指定终点和指定终点时旅行商分析的实例。

  另外，如果选择指定终点，终点可以与起点相同，即经过点集合中的最后一个点与第一个点相同。此时，旅行商分析的结果是一条闭合路径，即从起点出发，最终回到该点，如图 6-7所示：

需要注意，最佳路径分析（FindPath 方法）与旅行商分析类似，都是在网络中寻找遍历所有经过点的花费最少的路径。但二者具有明显的区别，即在遍历所有经过点时，二者对访问经过点的顺序处理有所不同：最佳路径分析必须按照给定的经过点的次序访问所有点，而旅行商分析需要确定最优次序来访问所有点，而并不一定按照指定的经过点的次序。

6.9.1       旅行商分析的实现方法

按照交通网络分析的步骤，在加载网络模型之后，就可以调用TransportationAnalyst类的findTSPPath方法进行旅行商分析了。

语法：

public TransportationAnalystResult findTSPPath(TransportationAnalystParameter parameter, boolean isEndNodeAssigned)

参数说明：

parameter：指定的交通网络分析参数。

isEndNodeAssigned：指定是否指定终点。指定为 true 表示指定终点，此时给定的经过点集合中最后一个点即为终点；否则不指定终点。

返回值说明：

分析结果对象。

通过TransportationAnalystParameter类型的parameter参数，可以指定旅行商分析所需的各个参数。旅行商分析的经过点的指定方式有两种：结点模式、坐标点模式，即通过TransportationAnalystParameter对象的setNodes方法，可以指定作为分析点的结点的结点ID集合，称为结点模式；通过setPoints方法，指定作为分析点所在位置的坐标点集合，这是坐标点模式。详见6.6小节。

通过TransportationAnalystParameter对象的方法还可以设置其他用于分析的参数信息，具体内容请参阅读6.6小节。

6.9.2       旅行商分析结果

旅行商分析的结果信息需要通过TransportationAnalystResult类对象的相关方法返回，关于这些方法的基本介绍，请参阅6.6小节。这里针对旅行商分析，着重介绍以下分析结果的具体含义：

途经弧段集合（getEdges）：由于分析结果只有一条路径，因此数组的一维长度为 1，二维元素为该路径途经弧段的弧段 ID。

途经结点集合（getNodes）：由于只有一条结果路径，因此数组的一维长度为 1，二维元素为该路径途经结点的结点 ID。

路由对象集合（getRoutes）：永远只有一条结果路由。

权值数组（getWeights）：因为只有一条路径，所以只有一个值，即该路径的总花费。

站点索引（getStopIndexes）：结果路径只有一条，故数组的一维长度为 1，二维元素表示结果路径经过站点的次序：

1.    结点模式：如设置的分析结点 ID 为 1，3，5 的三个结点，而结果途经顺序为 3，5，1，则二维元素值依次为 1，2，0，即结果途经顺序在初始设置结点串中的索引。

2.    坐标点模式：如设置的分析坐标点为 Pnt1，Pnt2，Pnt3，而结果途经顺序为 Pnt2，Pnt3，Pnt1，则二维元素值依次为 1，2，0，即结果途经坐标点顺序在初始设置坐标点串中的索引。

站点权值（getStopWeights）：由于结果路径只有一条，故数组的一维长度为 1。假设指定经过点 1、2、3，分析结果中站点索引为 1、0、2，则二维元素依次为：2 到 1 的耗费、1 到 3 的耗费。

6.10    多旅行商分析（物流配送） 目录

多旅行商分析也称为物流配送，是指在网络数据集中，给定 M 个配送中心点和 N 个配送目的地（M，N 为大于零的整数），查找经济有效的配送路径，并给出相应的行走路线。如何合理分配配送次序和送货路线，使配送总花费达到最小或每个配送中心的花费达到最小，是物流配送所解决的问题。

多旅行商分析的结果将给出每个配送中心所负责的配送目的地，以及这些配送目的地的经过顺序，和相应的行走路线，从而使该配送中心的配送花费最少，或者使得所有的配送中心的总花费最小。并且，配送中心点在完成其所负责的配送目的地的配送任务后，最终会回到配送中心点。

例如，某地区现有 50 个报刊零售地（配送目的地），4 个报刊供应地（配送中心），现寻求这 4 个供应地向报刊零售地发送报纸的最优路线，属物流配送问题。

图 6-8为报刊配送的分析结果，其中红色大一点的圆点代表 4 个报刊供应地（配送中心），而其他小一点的圆点代表报刊零售地（配送目的地），每个配送中心的配送方案采用不同的颜色标示，包括它所负责的配送目的地、配送次序以及配送线路。

 

图 6-9为上图中矩形框圈出的第 2 号配送中心的配送方案。蓝色的标有数字的小圆点是2号配送中心所负责的配送目的地（共有 18 个），2 号配送中心将按照配送目的地上标有数字的顺序依次发送报纸，即先送 1 号报刊零售地，再送 2 号报刊零售地，依次类推，并且沿着分析得出的蓝色线路完成配送，最终回到配送中心。

 

需要注意，由于物流配送的目的是寻找使配送总花费最小或每个配送中心的花费最小的方案，因此，分析结果中有可能某些物流配送中心点不参与配送。

6.10.1       调用多旅行商分析方法

按照交通网络分析的步骤，在加载网络模型之后，就可以调用对应的方法进行多旅行商分析了。TransportationAnalyst类的提供了两个重载方法findMTSPPath ，用于实现多旅行商分析。

方法一：多旅行商（物流配送）分析，配送中心为结点 ID 数组。

语法：

public TransportationAnalystResult findMTSPPath(TransportationAnalystParameter parameter，int[] centerNodes, boolean hasLeastTotalCost)

参数说明：

parameter：指定的交通网络分析参数。

centerNodes：指定的作为配送中心的结点 ID 数组。

hasLeastTotalCost：指定配送模式是否为总花费最小方案。若为 true，则按照总花费最小的模式进行配送，此时可能会出现某些配送中心点配送的花费较多而其他的配送中心点的花费较少的情况。若为 false，则为局部最优，此方案会控制每个配送中心点的花费，使各个中心点花费相对平均，此时总花费不一定最小。

返回值说明：

分析结果对象。

方法二：多旅行商（物流配送）分析，配送中心为点坐标串。

语法：

public TransportationAnalystResult findMTSPPath(TransportationAnalystParameter parameter，int[] centerNodes, boolean hasLeastTotalCost)

参数说明：

parameter：指定的交通网络分析参数。

centerPoints：指定的作为配送中心的坐标点集合。

hasLeastTotalCost：指定配送模式是否为总花费最小方案。若为 true，则按照总花费最小的模式进行配送，此时可能会出现某些配送中心点配送的花费较多而其他的配送中心点的花费较少的情况。若为 false，则为局部最优，此方案会控制每个配送中心点的花费，使各个中心点花费相对平均，此时总花费不一定最小。

返回值说明：

分析结果对象。

多旅行商的配送中心可以指定为结点或坐标点。使用方法一，可以通过centerNodes参数指定配送中心所在结点的结点ID；使用方法二，则通过centerPoints参数指定配送中心所在的坐标点。

配送目的地则是在TransportationAnalystParameter类型的参数parameter中指定的。配送目的地的选择也分为结点模式和坐标点模式：即通过TransportationAnalystParameter对象的setNodes方法，可以指定作为配送目的地的结点的结点ID集合，称为结点模式；通过setPoints方法，指定配送目的地所在位置的坐标点集合，这是坐标点模式。两种模式互斥，详见6.6一节。

通过TransportationAnalystParameter对象的方法还可以设置其他用于分析的参数信息，具体内容请参阅读6.6小节。

6.10.2       多旅行商分析的结果

多旅行商分析的结果信息需要通过TransportationAnalystResult类对象的相关方法返回，关于这些方法的基本介绍，请参阅6.6小节。这里针对多旅行商分析，着重介绍以下分析结果的具体含义：

途经弧段集合（getEdges）：该二维数组的一维长度为参与配送的中心点数，每一个配送中心点对应一条路径；二维元素为各条路径途经弧段的弧段 ID。注意，配送模式为局部最优时，所有中心点参与配送，为总花费最小模式时，参与配送的中心点数可能少于指定的中心点数。

途经结点集合（getNodes）：该二维数组的一维长度为参与配送的中心点数，每一个配送中心点对应一条路径；二维元素为各条路径途经结点的结点 ID。注意，配送模式为局部最优时，所有中心点参与配送，为总花费最小模式时，参与配送的中心点数量可能少于指定的中心点数。

路由对象集合（getRoutes）：配送模式为局部最优时，有多少个配送中心就会有多少个结果路由，为总花费最小模式时，结果路由的个数可能会小于配送中心的个数。

权值数组（getWeights）：权值的个数与分析结果中所使用的配送中心的个数相同，元素的含义为对应中心点的配送路线的总花费。注意，配送模式为局部最优时，所有中心点参与配送，为总花费最小模式时，参与配送的中心点数可能少于指定的中心点数。

站点索引（getStopIndexes）：类似于旅行商分析，只不过数组的一维长度为参与配送的中心点数。二维元素的含义与旅行商分析相同，表示对应的中心点的配送路径经过站点的次序。注意，配送模式为局部最优时，所有中心点参与配送，为总花费最小模式时，参与配送的中心点数可能少于指定的中心点数。

站点权值（getStopWeights）：多旅行商分析的结果可能有多条路径，因此数组一维长度为路径的数量，二维元素为该路径所经过的站点的之间的耗费，需要注意的是，多旅行商分析的路径经过的站点是包括中心点的，且路径的起终点均是中心点。例如，一条结果路径是从中心点 1 出发，经过站点 2、3、4，对应的站点索引为 1、2、0，则站点权重依次为：1 到 3 的耗费、3 到 4 的耗费、4 到 2 的耗费和 2 到 1 的耗费。

6.11    服务区分析 目录

服务区是以指定点为中心，在一定阻力范围内，包含所有可通达边、通达点的一个区域。服务区分析就是依据给定的阻力值（即服务半径）为网络上提供某种特定服务的位置（即中心点）查找其服务的范围（即服务区）的过程。阻力可以是到达的时间、距离或其他任何花费。例如：为网络上某点计算其 30 分钟的服务区，则结果服务区内，任意点出发到该点的时间都不会超过 30 分钟。

服务区分析也可以理解为不考虑中心资源供给量和需求量，而只考虑供给方与需求方之间网络弧段阻力的资源分配。这类分析一般可用于评估分析在某一位置邮局、医院、超市等公共设施一般的服务范围，从而为选择公共设施的最佳位置提供参考。

服务区分析的结果包含了每个服务中心点所能服务到的路由和区域。路由是指从服务中心点出发，按照阻力值不大于所指定的服务半径的原则，沿网络弧段延伸出的路径；服务区则是按照一定算法将路由包围起来所形成的面状区域。

图 6-10展示了服务区分析将要解决的问题以及结果会提供什么样的信息。红色圆点代表提供服务或资源的服务中心点，各种颜色的面状区域就是以相应的服务中心点为中心，在给定的阻力范围内的服务区，每个服务中心点所服务到的路由也以对应的颜色标示。

当服务半径足够大时，两个或多个相邻的服务区之间可能产生交叠，服务区所覆盖的路由也产生了交叠，此时，可以通过互斥处理，使服务区和路由均不产生交叠。如图 6-11所示，左图未进行互斥处理，右图进行了互斥处理。

服务区分析可以指定是否从中心点开始分析。从中心点开始分析和不中中心点开始分析，体现了服务中心和需要该服务的需求地的关系模式。

从中心点开始分析，是一个服务中心向服务需求地提供服务。例如，某个奶站向各个居民点送牛奶，如果要对这个奶站进行服务区分析，看这个奶站在允许的条件下所能服务的范围，那么在实际分析过程中就应当使用从中心点开始分析的模式；

而不从中心点开始分析，是一个服务需求地主动到服务中心获得服务。例如，如果想分析一个区域的某个学校在允许的条件下所能服务的区域时，在现实中，都是学生主动来到学校学习，接受学校提供的服务，那么在实际分析过程中就应当使用不从中心点开始分析的模式。

注意，从中心点出发和不从中心点，在分析时，由于弧段的正向权值和反向权值可能不同，结点的转向权值也可能不同，因此分析的结果也可能不同。

6.11.1       调用服务区分析方法

TransportationAnalyst类的findServiceArea方法，用于实现服务区分析。下面对其进行介绍：

语法：

public ServiceAreaResult findServiceArea(TransportationAnalystParameter parameter，double[] weights,boolean isFromCenter,boolean isCenterMutuallyExclusive）

参数说明：

parameter：指定的交通网络分析参数。

weights：指定的服务区半径数组。数组长度应与给定的服务中心点的数量一致，且数组元素按照顺序与中心点一一对应。服务区半径的单位与指定的权值信息中的正向、反向阻力字段的单位一致。

isFromCenter：指定是否从中心点开始分析。若为 true，则从中心点开始分析。若为 false，则不从中心点开始分析。

isCenterMutuallyExclusive：

返回值说明：

分析结果对象。

实现服务区分析时，服务中心的指定是在TransportationAnalystParameter类型的参数parameter中指定的，可以指定多个服务中心点。服务中心点的选择分为结点模式和坐标点模式：即通过TransportationAnalystParameter对象的setNodes方法，指定作为服务中心点的结点的结点ID集合，称为结点模式；通过setPoints方法，指定中心点所在位置的坐标点集合，这是坐标点模式。两种模式互斥，详见6.6一节。

在TransportationAnalystParameter类型的参数中还可以设置服务区分析需要的其他信息，具体介绍请参阅6.6一节。

6.11.2       服务区分析结果

ServiceAreaResult类继承自TransportationAnalystResult类，它继承了TransportationAnalystResult类的getNodes、getEdges、getRoutes和getWeights方法，而getPathGuides、getStopIndexes和getStopWeights方法对服务区分析无效。除此，ServiceAreResult还提供了两个方法用于返回分析结果中的资源供给中心集合，如表 6.8所示。

表 6.8 SupplyCenter类的方法列表

有关getNodes、getEdges、getRoutes和getWeights方法的基本信息，请参阅6.6小节。这里针对服务区分析，着重介绍以下分析结果的具体含义：

途经弧段集合（getEdges）：该二维数组的一维长度为服务区中心点数，二维元素为每个中心点的服务区所覆盖（包括部分覆盖）的弧段的弧段ID。

途经结点集合（getNodes）：该二维数组的一维长度为服务中心点数，二维元素为每个中心点的服务区所覆盖的结点的结点 ID。

路由对象集合（getRoutes）：该数组存储了按照中心点的指定顺序，每个服务区所覆盖（包括部分覆盖）的路由。从服务区分析结果的 getServiceRouteCounts 方法返回的数组的元素顺序对应了中心点的指定顺序，元素值为该中心点的服务区所覆盖（包括部分覆盖）的路由的数量，结合该数组，可以得知每个服务区对应的路由有哪些。

权值数组（getWeights）：该数组存储了按照中心点的指定顺序，每个服务区的总耗费，也就是服务区所覆盖的所有路由的权值。

6.12    选址分区分析 目录

选址分区分析是为了确定一个或多个待建设施的最佳位置，使得设施可以用一种最经济有效的方式为需求方提供服务或者商品。选址分区不仅仅是一个选址过程，还要将需求点的需求分配到相应的新建设施的服务区中，因此称之为选址与分区。

首先来了解选址分区的有关概念：

资源供给中心：即中心点，是提供资源和服务的设施，对应于网络结点，资源供给中心的相关信息包括最大阻力值、资源供给中心类型，资源供给中心在网络中所处结点的 ID 等。

需求点：通常是指需要资源供给中心提供的服务和资源的位置，也对应于网络结点。

最大阻力值：用来限制需求点到资源供给中心的花费。如果需求点到此资源供给中心的花费大于最大阻力值，则该需求点被过滤掉，即该资源供给中心不能服务到此需求点。

资源供给中心类型：包括非中心点，固定中心点和可选中心点。

1.      固定中心点是指网络中已经存在的、已建成的服务设施（扮演资源供给角色）；

2.     可选中心点是指可以建立服务设施的资源供给中心，即待建服务设施将从这些可选中心点中选址；

3.     非中心点在分析时不予考虑，在实际中可能是不允许建立这项设施或者已经存在了其他设施。

另外，分析过程中使用的需求点都为网络结点，即除了各种类型的中心点所对应的网络结点，所有网络结点都作为资源需求点参与选址分区分析，如果要排除某部分结点，可以将其设置为障碍点。

是否从中心点分配：从中心点分配，表示资源通过网络传输到需求点；不从中心点分配，表示需求方通过网络前往中心点获得资源。下面通过两个实例来帮助理解：

1.      从中心点开始分配（供给到需求）的例子：

电能是从电站产生，并通过电网传送到客户那里去的。在这里，电站就是网络模型中的中心，因为它可以提供电力供应。电能的客户沿电网的线路（网络模型中的弧段）分布，他们产生了“需求”。在这种情况下，资源是通过网络由供方传输到需要来实现资源分配的。

2.      不从中心点开始分配（需求到供给）的例子：

学校与学生的关系也构成一种在网络中供需分配关系。学校是资源提供方，它负责提供名额供适龄儿童入学。适龄儿童是资源的需求方，他们要求入学。作为需求方的适龄儿童沿街道网络分布，他们产生了对作为供给方的学校的资源--学生名额的需求。

需求点就是网络中的结点，除此，资源供给中心及其类型、最大阻力值，是否从中心点分配等参数均需要用户设置，在下一节中将介绍选址分区的方法以及如何设置有关参数。

下面通过一个应用实例来加深对选址分区的理解。某个区域目前有 3 所小学，根据需求，拟在该区域内再建立 3 所小学。选择了 9 个地点作为待选地点，将在这些待选点中选择 3 个最佳地点建立新的小学。如图 6-12所示，已有的 3 所小学为固定中心点，7 个候选位置为可选中心点。新建小学要满足的条件为：居民点中的居民步行去学校的时间要在 30 分钟以内。选址分区分析会根据这一条件给出最佳的选址位置，并且圈出每个学校，包括已有的 3 所学校的服务区域。如图 6-13所示，最终序号为 5、6、8 的可选中心点被选为建立新学校的最佳地点。 备注：下面两幅中的网络数据集的所有网络结点被看做是该区域的居民点全部参与选址分区分析，居民点中的居民数目即为该居民点所需服务的数量。

备注：

下面两幅中的网络数据集的所有网络结点被看做是该区域的居民点全部参与选址分区分析，居民点中的居民数目即为该居民点所需服务的数量。

6.12.1     选址分区分析的实现方法

TransportationAnalyst类的findLocation方法，用于实现选址分区分析。

语法：

public LocationAnalystResult findLocation(LocationAnalystParameter parameter)

参数说明：

parameter：指定的选址分区分析参数对象。

返回值说明：

选址分区分析结果对象。

该方法需要传入一个LocationAnalystParameter类型的对象作为参数，通过该对象，可以设置选址分区分析的参数信息，包括资源供给中心集合、期望选址的资源供给中心数量、是否从中心点开始分配，以及权重信息等。下面详细介绍选址分区分析参数（LocationAnalystParameter）类的方法，如表 6.9所示：

表 6.9 LocationAnalystParameter类的方法列表

 

表 6.10 SupplyCenter类的方法列表

 

6.12.2       选址分区分析结果

选址分区分析返回的结果保存在选址分区分析结果（LocationAnalystResult）对象中，从该对象可以获取资源供给结果数组和需求结果数组，如表 6.11所示：

表 6.11 LocationAnalystResult类的方法列表

资源供给结果数组（getSupplyResults）

资源供给结果数组（getSupplyResults）是资源供给结果（SupplyResult）对象的集合，包含了所有资源供给中心的资源供给结果。每一个SupplyResult对象对应一个资源供给中心的供给结果，包括该资源供给中心的ID、类型、最大阻力值、所服务的需求结点的数量、总耗费和平均耗费等信息，详见表 6.12。

表 6.12 SupplyResult类的方法列表

需求结果数组（getDemandResults）

需求结果数组（getDemandResults）是需求结果（DemandResult）对象的集合，包含了所有需求结点的需求结果信息。每一个DemandResult对象对应一个需求结点的需求结果，包括该需求结点的结点ID和为其提供服务的资源供给中心的ID，详见表 6.13。

表 6.13 DemandResult类的方法列表

6.13    其他功能 目录

除了上述内容介绍的交通网络分析功能外，TransportationAnalyst类还提供了三个用于辅助网络分析的方法，包括计算耗费矩阵、更新弧段权值和更新转向结点权值。下面分别对这个三个方法进行介绍。注意，这三个方法也必须在加载网络模型（即调用load方法）之后调用。

6.13.1       计算耗费矩阵

耗费是指从网络上某个结点（或坐标点）到达另一个结点（或坐标点）的最小耗费，也就是两点间最佳路径的耗费。耗费矩阵则是由给定的N个结点（或坐标点）两两间的耗费构成的矩阵。TransportationAnalyst类的computeWeightMatrix方法用于计算给定点的耗费矩阵。

语法：

public double[,] computeWeightMatrix(TransportationAnalystParameter parameter)

参数说明：

parameter：指定的交通网络分析参数对象。

返回值说明：

耗费矩阵。

待计算耗费矩阵的点，通过TransportationAnalystParameter类型的参数parameter指定，即通过TransportationAnalystParameter对象的setNode方法指定结点集合，或者通过该对象的setPoints方法指定坐标点集合，但注意二者互斥，如果同时设置，则只有分析前最后的设置有效。例如，先指定了结点集合，又指定了坐标点集合，然后分析，此时只对坐标点进行分析。

除指定待计算耗费矩阵的点集合外，还可通过TransportationAnalystParameter对象的其他方法设置其他必要参数，如网络数据集及其拓扑关系字段、权值信息等，此外，设置障碍点和障碍边也是有效的。

该方法返回的耗费矩阵是一个等长二维数组，元素的索引与指定的被计算点的索引一致，例如，元素 [1,2] 的值为点集合中索引为 1 的点到索引为 2 的点的最小耗费。注意，计算结果包含点自身到自身的耗费，并且为 0。

6.13.2       更新弧段权值

TransportationAnalyst类的updateEdgeWeight 方法用于对网络模型中的弧段权值进行修改。

语法：

public double updateEdgeWeight(int edgeID, int fromNodeID, int toNodeID, String weightName, double weight)

参数说明：

edgeID：指定的被更新的弧段的弧段 ID。

fromNodeID：指定的被更新的弧段的起始结点 ID。

toNodeID：指定的被更新的弧段的终止结点 ID。

weightName：指定的被更新的权值字段所属的权值字段信息对象的名称，即在交通网络分析环境（TransportationAnalystSetting）中指定的 WeightFieldInfos 对象中相应的 WeightFieldInfo 对象的 setName 方法指定的值。

weight：指定的权值，即用该值更新旧值。单位与 weightName 指定的权值信息字段对象中权值字段的单位相同。

返回值说明：

成功返回更新前的权值，失败返回 Double.MIN_VALUE。

首先，需要明确，该方法用于对加载到内存中的网络模型的弧段权值进行修改，并不会修改网络数据集。因此，该方法提供了对弧段权值进行临时性修改的途经，从而免去修改网络数据集或源数据的弧段权值后需要重新加载网络模型的麻烦。

该方法可以更新弧段的正向权值或反向权值。正向权重是指从弧段的起始结点到达终止结点的花费，反向权值为从弧段的终止结点到达起始结点的花费。因此，指定 fromNodeID 为网络数据集中被更新弧段的起始结点 ID，toNodeID 为该弧段的终止结点 ID，则更新正向权值，反之，指定 fromNodeID 为网络数据集中该弧段的终止结点 ID，toNodeID 为该弧段的起始结点 ID，则更新反向权值。

注意，权值为负数表示弧段在该方向禁止通行。

6.13.3       更新转向结点权值

TransportationAnalyst类的updateTurnNodeWeight 方法用于对网络模型中的转向表中的转向权值进行修改。

语法：

public double updateTurnNodeWeight(int nodeID, int fromEdgeID, int toEdgeID, String turnWeightField, double weight)

参数说明：

nodeID：指定的被更新的转向结点的结点 ID。

fromEdgeID：指定的被更新的转向结点的起始弧段 ID。

toEdgeID：指定的被更新的转向结点的终止弧段 ID。

turnWeightField：指定的转向权值字段名称，即在交通网络分析环境（TransportationAnalystSetting）中指定的 TurnWeightFields 中的一个值。

weight：指定的权值，即用该值更新旧值。单位与 turnWeightField 指定的转向权值字段的单位相同。

返回值说明：

成功返回更新前的权值，失败返回 Double.MIN_VALUE。

首先，需要明确，该方法用于对加载到内存中的网络模型的转向表的转向权值进行修改，并不会修改转向表。因此，该方法提供了对转向权值进行临时性修改的途经，从而免去修改转向表后需要重新加载网络模型的麻烦。

在一个结点处，可能产生多种转向。转弯的方向通过给定的转向结点的起始弧段 ID 和终止弧段 ID 确定。通过该方法指定对应的起始弧段ID和终止弧段ID，从而修改转向结点处对应的转向权值。注意转向权值为负数表示该转弯方向禁止通行。

有关转向表，请参阅第3章的介绍。