SuperMap.REST.FindPathService

最佳路径分析服务类。 最佳路径是在网络数据集中指定一些节点,按照节点的选择顺序, 顺序访问这些节点从而求解起止点之间阻抗最小的路经。 该类负责将客户端指定的最佳路径分析参数传递给服务端,并接收服务端返回的结果数据。 最佳路径分析结果通过该类支持的事件的监听函数参数获取,参数类型为 {SuperMap.REST.FindPathEventArgs}; 获取的结果包括 originResult 、result 两种, 其中,originResult 为服务端返回的用 JSON 对象表示的最佳路径分析结果数据,result 为服务端返回的最佳路径分析结果数据,保存在 {SuperMap.REST.FindPathResult} 对象中。

Inherits from

Summary
SuperMap.REST.FindPathService 最佳路径分析服务类。 最佳路径是在网络数据集中指定一些节点,按照节点的选择顺序, 顺序访问这些节点从而求解起止点之间阻抗最小的路经。 该类负责将客户端指定的最佳路径分析参数传递给服务端,并接收服务端返回的结果数据。 最佳路径分析结果通过该类支持的事件的监听函数参数获取,参数类型为 {SuperMap.REST.FindPathEventArgs}; 获取的结果包括 originResult 、result 两种, 其中,originResult 为服务端返回的用 JSON 对象表示的最佳路径分析结果数据,result 为服务端返回的最佳路径分析结果数据,保存在 {SuperMap.REST.FindPathResult} 对象中。
Constants
EVENT_TYPES {Array(String)} 此类支持的事件包括:
Properties
eventListeners {Object} 监听器对象,在构造函数中设置此参数(可选),对 FindPathService 支持的两个事件 processCompleted 、processFailed 进行监听,相当于调用 SuperMap.Events.on(eventListeners)。
events {SuperMap.Events} 在 FindPathService 类中处理所有事件的对象,支持 processCompleted 、processFailed 两种事件,服务端成功返回最佳路径分析结果时触发 processCompleted 事件,服务端返回最佳路径分析结果失败时触发 processFailed 事件。
Constructor
SuperMap.REST.FindPathService 最佳路径分析服务类构造函数。
Functions
destroy 释放资源,将引用资源的属性置空。
processAsync 负责将客户端的查询参数传递到服务端。

Constants

EVENT_TYPES

{Array(String)} 此类支持的事件包括:

  • processCompleted 服务端返回最佳路径分析结果触发该事件。
  • processFailed 服务端返回最佳路径分析结果失败触发该事件。

Properties

events

{SuperMap.Events} 在 FindPathService 类中处理所有事件的对象,支持 processCompleted 、processFailed 两种事件,服务端成功返回最佳路径分析结果时触发 processCompleted 事件,服务端返回最佳路径分析结果失败时触发 processFailed 事件。

例如:

var myFindPathService = new SuperMap.REST.FindPathService(url);
myFindPathService.events.on({
    "processCompleted": findPathCompleted,
    "processFailed": findPathError
    }
);
function findPathCompleted(findPathEventArgs){//todo};
function findPathError(findPathEventArgs){//todo};

eventListeners

{Object} 监听器对象,在构造函数中设置此参数(可选),对 FindPathService 支持的两个事件 processCompleted 、processFailed 进行监听,相当于调用 SuperMap.Events.on(eventListeners)。

Constructor

SuperMap.REST.FindPathService

最佳路径分析服务类构造函数。

例如:

var myFindPathService = new SuperMap.REST.FindPathService(url, {
    eventListeners: {
        "processCompleted": findPathCompleted,
        "processFailed": findPathError
        }
});

Parameters

url {String} 网络分析服务地址。请求网络分析服务,URL应为: http://{服务器地址}:{服务端口号}/iserver/services/{网络分析服务名}/rest/networkanalyst/{网络数据集@数据源}; 例如:”http://localhost:8090/iserver/services/components-rest/rest/networkanalyst/RoadNet@Changchun”。
options {Object} 参数。

Allowed options properties

eventListeners {Object} 需要被注册的监听器对象。

Functions

destroy

destroy: function()

释放资源,将引用资源的属性置空。

processAsync

processAsync: function( params )

负责将客户端的查询参数传递到服务端。

Parameters

params {SuperMap.REST.FindPathParameters}
最佳路径分析服务事件数据类。 类包含了从服务端传回的最佳路径分析结果数据。
最佳路径分析结果类。 从该类中可以获取一条或多条结果路径,以及表示这些路径的图片。
destroy: function()
释放资源,将引用资源的属性置空。
processAsync: function( params )
负责将客户端的查询参数传递到服务端。
服务基类。 抽象类,查询、量算等服务类均继承该类。
最佳路径分析参数类。 最佳路径是在网络数据集中指定一些结点,按照顺序访问结点从而求解起止点之间阻抗最小的路径。 例如如果要顺序访问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。 阻抗就是指从一点到另一点的耗费,在实际应用中我们可以将距离、时间、花费等作为阻抗条件。 阻抗最小也就可以理解为从一点到另一点距离最短、时间最少、花费最低等。当两点间距离最短时为最短路径,它是最佳路径问题的一个特例。 阻抗值通过 TransportationAnalystParameter.weightFieldName 设置。 计算最佳路径除了受阻抗影响外,还受转向字段的影响。转向值通过 TransportationAnalystParameter.turnWeightField 设置。
Close