| 包 | com.supermap.web.iServerJava6R.networkAnalystServices |
| 类 | public class FindClosestFacilitiesService |
| 继承 | FindClosestFacilitiesService  com.supermap.web.service.ServiceBase |
最近设施分析是指在网络上给定一个事件点和一组设施点，查找从事件点到设施点(或从设施点到事件点)以最小耗费能到达的最佳路径。设施点一般为学校、超市、加油站等服务设施；事件点为需要服务设施的事件位置。例如事件发生点是一起交通事故，要求查找在10分钟内能到达的最近医院，超过10分钟能到达的都不予考虑。此例中，事故发生地即是一个事件点，周边的医院则是设施点。最近设施查找实际上也是一种路径分析，因此对路径分析起作用的障碍边、障碍点、转向表、耗费等属性在最近设施分析时同样可设置。
最近设施查找属于网络分析的一种。网络分析是针对网络数据集的应用。网络数据集为具有拓扑关系的包含了一个网络结点子数据集的线图层，因此网络数据集拥有两个属性表，一个是记录弧段信息的属性表，一个是记录结点信息的属性表。
该类负责将客户端指定的最近设施分析参数传递给服务端，并接收服务端返回的结果数据，将最终结果存放于 FindClosestFacilitiesResult 中。用户若需获取服务端返回的原始结果，需监听 FindClosestFacilitiesEvent.PROCESS_COMPLETE 事件。该事件中既存有服务端返回的原始结果，又存有可在客户端显示的最终结果（FindClosestFacilitiesResult）。
| 方法 | 定义方 | ||
|---|---|---|---|
|
FindClosestFacilitiesService(url:String)
使用网络分析服务地址 URL 初始化 FindClosestFacilitiesService 的新实例。
|
FindClosestFacilitiesService | ||
|
processAsync(parameters:FindClosestFacilitiesParameters, responder:IResponder = null):AsyncToken
将客户端指定的最近设施查找参数传递给服务端，与服务端完成异步通讯。.
|
FindClosestFacilitiesService | ||
| 事件 | Summary | 定义方 | ||
|---|---|---|---|---|
| 当与服务端交互失败时触发该事件。 | FindClosestFacilitiesService | |||
| 当与服务端交互成功时触发该事件。 | FindClosestFacilitiesService | |||
| FindClosestFacilitiesService | () | 构造函数 |
public function FindClosestFacilitiesService(url:String)
使用网络分析服务地址 URL 初始化 FindClosestFacilitiesService 的新实例。
参数url:String — 网络分析服务地址。请求网络分析服务，URL应为：http://{服务器地址}:{服务端口号}/iserver/services/{网络分析服务名}/rest/networkanalyst/{网络数据集@数据源}； 例如:"http://localhost:8090/iserver/services/components-rest/rest/networkanalyst/RoadNet@Changchun"。 |
| processAsync | () | 方法 |
public function processAsync(parameters:FindClosestFacilitiesParameters, responder:IResponder = null):AsyncToken
将客户端指定的最近设施查找参数传递给服务端，与服务端完成异步通讯。.
与服务端完成异步通讯后，获取返回的结果有两种方式：
1. 通过 AsyncResponder 类获取（推荐使用）；
2. 通过监听 FindClosestFacilitiesEvent.PROCESS_COMPLETE 事件获取。
参数
parameters:FindClosestFacilitiesParameters — 最近设施查找参数类。 |
|
responder:IResponder (default = null) — 由 AsyncResponder 类实现。远程或异步请求服务完成时将调用的处理函数。使用方法为AsyncResponder(result:Function, fault:Function, token:Object = null) result:Function — 成功完成请求时应调用的函数。必须具有以下签名： public function (result:Object, token:Object = null):void; fault:Function — 请求完成但出错时应调用的函数。必须具有以下签名： public function (error:FaultEvent, token:Object = null):void; token:Object (default = null) — 与此请求相关的其他信息。 有关 AsyncResponder 类的详细信息请参见 “ActionScript 语言帮助文档”。 |
AsyncToken — 返回 AsyncToken 对象，它为异步 RPC 操作提供设置额外数据或标记级别数据的位置。它也允许为单独的调用附加 IResponder。可从 token 属性的 ResultEvent 和 FaultEvent 中引用 AsyncToken。有关 AsyncToken 类的详细信息请参见 “ActionScript 语言帮助文档”。 |
| fault | 事件 |
mx.rpc.events.FaultEvent当与服务端交互失败时触发该事件。
| processComplete | 事件 |
com.supermap.web.iServerJava6R.serviceEvents.FindClosestFacilitiesEvent当与服务端交互成功时触发该事件。