配置交通网络分析服务提供者 |
SuperMap iServer 支持以下类型的交通网络分析服务提供者：
配置一个 UGC 本地交通网络分析服务提供者，如下所示：
<provider class="com.supermap.services.providers.UGCTransportationAnalystProvider"
inner-providerNames="ugcDataProvider-Changchun" name="transportationAnalystProvider-Changchun">
<config class="com.supermap.services.providers.TransportationAnalystSetting">
<workspaceConnectString>../../samples/data/NetworkAnalyst/Changchun.sxwu</workspaceConnectString>
<datasourceName>Changchun</datasourceName>
<datasetName>RoadNet</datasetName>
<ruleField>TRule</ruleField>
<forwardSingleWayRuleValues>
<string>FT</string>
</forwardSingleWayRuleValues>
<backwardSingleWayRuleValues>
<string>TF</string>
</backwardSingleWayRuleValues>
<twoWayRuleValues>
<string>twoWay</string>
</twoWayRuleValues>
<prohibitedWayRuleValues>
<string>prohibit</string>
</prohibitedWayRuleValues>
<edgeIDField>SmEdgeID</edgeIDField>
<edgeNameField>RoadName</edgeNameField>
<nodeIDField>SmNodeID</nodeIDField>
<nodeNameField>SmNodeID</nodeNameField>
<fromNodeIDField>SmFNode</fromNodeIDField>
<toNodeIDField>SmTNode</toNodeIDField>
<tolerance>500.0</tolerance>
<weightFieldInfos>
<com.supermap.services.components.commontypes.WeightFieldInfo>
<name>length</name>
<forwardWeightField>Length</forwardWeightField>
<backWeightField>Length</backWeightField>
</com.supermap.services.components.commontypes.WeightFieldInfo>
<com.supermap.services.components.commontypes.WeightFieldInfo>
<name>time</name>
<forwardWeightField>FT_TIME</forwardWeightField>
<backWeightField>TF_TIME</backWeightField>
</com.supermap.services.components.commontypes.WeightFieldInfo>
</weightFieldInfos>
<turnDatasetInfo>
<workspaceConnectString>../../samples/data/NetworkAnalyst/Changchun.sxwu</workspaceConnectString>
<datasourceName>Changchun</datasourceName>
<datasetName>RoadNet_TURN</datasetName>
<nodeIDField>NodeID</nodeIDField>
<fromEdgeIDField>FEdgeID</fromEdgeIDField>
<toEdgeIDField>TEdgeID</toEdgeIDField>
<weightFields>
<string>TurnCost</string>
</weightFields>
</turnDatasetInfo>
<analystModeSetting>
<sscSetting>
<enabled>true</enabled>
<levelField>level_User</levelField>
<sscPath>C:\test.ssc</sscPath>
<autoGenerateSsc>false</autoGenerateSsc>
</sscSetting>
</analystModeSetting>
<autoCheckNetwork>false</autoCheckNetwork>
<initFacilityAnalyst>true</initFacilityAnalyst>
<directionField>SmResistanceA</directionField>
</config>
</provider>
其中，<provider>中的 class 标识的是本地交通网络分析服务提供者的实现类，<config>中的 class 标识的是本地交通网络分析服务提供者对应的配置类，即 TransportationAnalystSetting，<config>中的内容是对应的配置项，主要包括：
数据来源信息如<workspaceConnectString>、<workspaceType>、<datasourceName>、<datasetName>。其中，<workspaceConnectString>表示该服务提供者所用的工作空间的路径。此外，工作空间路径支持从环境变量和系统配置文件中读取。可写为：
<workspaceConnectString>${datapath1}/World.sxwu</workspaceConnectString>
详细说明请参见：预设本地工作空间路径本地交通网络分析使用的数据与算法参数信息，如<turnDatasetInfo>、<weightFieldInfos>、<nodeIDField>、<nodeNameField>、<fromNodeIDField>、<toNodeIDField>、<tolerance>等。
是否自动检查网络数据集<autoCheckNetwork>，为 false 时为手动检查，需用户在 Provider 的配置界面点击按钮进行检查；为 true 时会自动检查。
关于这些参数的详细介绍，请参考：本地交通网络分析服务提供者的配置。
<initFacilityAnalyst>：是否初始化设施网络分析，默认为false。修改为true后，将开启爆管分析、上下游关键设施查找分析、连通性分析功能。详细请参考：burstAnalyse，upstreamcirticalfaclilities，downstreamcirticalfaclilities、connectedEdges
<directionField>：流向字段，当<initFacilityAnalyst>为true时，该参数必填。
<nodeIDFilterField>：该参数仅用于指定生成默认sourceNodeIDs参数的过滤字段。即：当sourceID为空，该属性字段值为true的结点ID将作为默认的sourceNodeIDs。若该参数为空，则会将所有的nodeID作为默认的sourceNodeIDs。当<initFacilityAnalyst>为true时，此参数可用。
<analystModeSetting>：分析模型配置，用于设置除基本分析模型之外的其他分析模型，如最佳路径分析的 SSC 分析模型。如不设置本参数则仅使用基本分析模型。
<sscSetting>：最佳路径分析 SSC 分析模型配置。
<enabled>：是否开启最佳路径分析 SSC 分析模型。
<levelField>：道路等级字段。
<sscPath>：SSC 文件的绝对路径。
<autoGenerateSsc>：是否自动生成 SSC 文件。默认 false，表示不自动生成。
注意：当有 SSC 文件时，直接使用 SSC 文件。没有 SSC 文件且开启自动生成参数，将会自动生成 SSC 文件，自动生成的 SSC 文件存放在 sscPath 参数指定的路径下。当配置开启最佳路径分析 SSC 分析模型但未开启自动生成 SSC 文件且不存在已有的 SSC 文件时，服务将无法使用。
注意：在配置本地交通网络服务提供者前建议对标识网络弧段 ID 的字段、标识网络结点 ID 的字段建立字段索引。
配置一个 REST 交通网络分析服务提供者，如下所示：
<provider class="com.supermap.services.providers.RestTransportationAnalystProvider" name="restSpatialProvider">
<config class="com.supermap.services.providers.RestTransportationAnalystProviderSetting">
<restServiceRootURL>http://localhost:8090/iserver/services/transportationanalyst-sample/rest</restServiceRootURL>
<restProviderCacheConfig>
<maxElementsInMemory>1</maxElementsInMemory>
<maxSizeOnDisk>2048</maxSizeOnDisk>
<timeToLiveSeconds>0</timeToLiveSeconds>
<timeToIdleSeconds>0</timeToIdleSeconds>
</restProviderCacheConfig>
<useCache>true</useCache>
</config>
</provider>
其中<provider>中的 class 标识的是 REST 交通网络分析服务提供者的实现类，<config>中的 class 标识的是 REST 交通网络分析服务提供者对应的配置类，即 RestTransportationAnalystProviderSetting，<config>中的内容是对应的配置项，包括：
配置一个 ArcGIS REST 网络分析服务提供者，如下所示：
<provider class="com.supermap.services.providers.ArcGISRestNetworkAnalystProvider" enabled="true" name="transportationAnalyst-Streets_ND3">
<config class="com.supermap.services.providers.ArcGISRestNetworkAnalystProviderSetting">
<restServiceRootURL>http://localhost:6080/arcgis/rest/services/sample/NAServer</restServiceRootURL>
<token/>
<httpReferer/>
<networkDataset>Streets_ND</networkDataset>
<routeLayer>Route</routeLayer>
<serviceAreaLayer>Service Area</serviceAreaLayer>
<closestFacilityLayer>Closest Facility</closestFacilityLayer>
</config>
</provider>
其中<provider>中的 class 标识的是 ArcGIS REST 网络分析服务提供者的实现类，<config>中的 class 标识的是 ArcGIS REST 网络分析服务提供者对应的配置类，即 ArcGISRestNetworkAnalystProviderSetting，<config>中的内容是对应的配置项，包括：