mtspPath


URI

<networkDataName_uri>/mtsppath[.<format>]

支持的方法

GETHEAD

父资源

networkDataName

介绍

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

多旅行商分析也称为物流配送,是指在网络数据集中,给定 M 个配送中心点和 N 个配送目的地(M,N 为大于零的整数),查找经济有效的配送路径,并给出相应的行走路线。

物流配送功能就是解决如何合理分配配送次序和送货路线,使配送总花费达到最小或每个配送中心的花费达到最小。 多旅行商分析的结果将给出每个配送中心所负责的配送目的地,和每个配送中心向其负责的配送目的地配送货物时,经过各个配送目的地的顺序和相应的行走路线。从而使各个配送中心的配送花费相对平均,或者使所有的配送中心的总花费最小。

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

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

支持的方法:

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

资源层次

resources.htm

HTTP 请求方法

对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名,RoadNet@Changchun 为可进行分析的网络数据名称。[2,50,100] 代表配送中心点在网络结点2,50,100所在的位置,[1,8,9,25,16,36,68,92,58,64,90,123,215,310]代表配送目的地在网络结点1,8,9,25,16,36,68,92,58,64,90,123,215,310 所在的位置。

http://supermapiserver:8090/iserver/services/transportationanalyst-sample/rest/networkanalyst/RoadNet@Changchun/mtsppath.rjson?centers=[2,50,100]&nodes=[1,8,9,25,16,36,68,92,58,64,90,123,215,310]

GET 请求

获取多旅行商分析的结果。

请求参数

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

名称 类型 含义
centers int[]/Point2D[] 【必选参数】
配送中心集合。
nodes int[]/Point2D[] 【必选参数】
配送目标集合。
hasLeastTotalCost boolean 配送模式是否为总花费最小方案。
parameter TransportationAnalystParameter 交通网络分析通用参数。

响应结构

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

字段 类型 说明
pathList List<MTSPPath> 配送中心的配送路线集合。

响应示例

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

http://supermapiserver:8090/iserver/services/transportationanalyst-sample/rest/networkanalyst/RoadNet@Changchun/mtsppath.rjson?centers=[2,50,100]&nodes=[1,8,9,25,16,36,68,92,58,64,90,123,215,310]

获取的响应内容如下:

HEAD 请求

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

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

请参见