tspPath


URI

<networkDataName_uri>/tsppath[.<format>]

支持的方法

GETHEAD

父资源

networkDataName

介绍

TSPPath 资源表示旅行商分析功能,设置参数后,对 tspPath 资源执行 GET 请求,可以获取旅行商分析的结果。

旅行商分析是查找经过指定一系列点的路径,无序的路径分析。旅行商可以自己决定访问结点的顺序,目标是旅行路线阻抗总和最小(或接近最小)。如果指定了终止点,则旅行商必须最后一个访问终止点,而其他经过点的访问次序有旅行商自己决定。

需要注意的是,进行旅行商分析时暂不考虑访问节点,即目标点的转向权重。

有关旅行商分析的详细介绍,请参见:旅行商分析

支持的方法:

支持的表述格式:rjson、json、jsonp、html、xml。

资源层次

resources.htm

HTTP 请求方法

对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名,RoadNet@Changchun 为可进行分析的网络数据名称。[2,6,9,18,25]为要进行分析的网络结点数组,即旅行商分析的站点为结点 2,6,9,18,25 所在的位置。

http://supermapiserver:8090/iserver/services/transportationanalyst-sample/rest/networkanalyst/RoadNet@Changchun/tsppath.rjson?nodes=[2,6,9,18,25]

GET 请求

获取旅行商分析的结果。

请求参数

对 tspPath 资源执行 GET 请求,需要在 URI 中包含一些参数,如下:

名称 类型 含义
nodes int[]/Point2D[] 【必选参数】
进行旅行商分析的访问结点,即目标点。
endNodeAssigned boolean 是否指定终止点。true 表示指定终止点,则旅行商必须最后一个访问终止点,即指定的途经点的最后一个点。
parameter TransportationAnalystParameter 交通网络分析通用参数。

响应结构

执行旅行商分析功能,返回的操作结果表述的结构如下(表述在响应消息的实体主体里):

字段 类型 说明
tspPathList List<TSPPath> 旅行商分析结果路径集合。

响应示例

对 RoadNet@Changchun 数据集执行旅行商分析,即对如下 URI 执行 GET 请求:

http://supermapiserver:8090/iserver/services/transportationanalyst-sample/rest/networkanalyst/RoadNet@Changchun/tsppath.rjson?nodes=[2,6,9,18,25]

获取的响应内容如下:

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。

HEAD 请求可以用来判断 tspPath 资源是否存在,或者客户端是否有权限访问 tspPath 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 tspPath 资源是否支持<format>格式的表述。

请参见