URI
<networkDataName_uri>/path[.<format>]
支持的方法
父资源
介绍
path 资源表示最佳路径分析功能,设置参数后,对 path 资源执行 GET 请求,可以获取一个最佳路径分析的结果。有关最佳路径分析的详细介绍,请参见:最佳路径分析。
支持的方法:
支持的表述格式:rjson、json、html、xml。
资源层次
HTTP 请求方法
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名,RoadNet@Changchun 为可进行最佳路径分析的网络数据名称。[2,8]为要进行路径分析的网络结点数组,即求的是结点2到结点8之间的最佳路径。
http://supermapiserver:8090/iserver/services/transportationanalyst-sample/rest/networkanalyst/RoadNet@Changchun/path.rjson?nodes=[2,8]
GET 请求
获取最佳路径分析的结果。
请求参数
对 path 资源执行 GET 请求,需要在 URI 中包含一些参数,数如下:
名称 | 类型 | 含义 |
nodes | int[]/Point2D[] |
【必选参数】 进行最佳路径分析的点集合。 注意:只有当传入结点坐标时才会启用 SSC 分析模式;若传入的为结点 ID 数组,则仍然使用普通分析模式 |
hasLeastEdgeCount | boolean |
是否按弧段数最少的模式查询。 |
parameter | TransportationAnalystParameter |
交通网络分析通用参数,有以下参数可供设置:
|
响应结构
执行最佳路径分析功能,返回的操作结果表述的结构如下(表述在响应消息的实体主体里):
字段 | 类型 | 说明 |
pathList | List<Path> |
最佳路径分析结果集合(目前集合中只有一个元素)。 |
响应示例
对 RoadNet@Changchun 数据集执行最佳路径分析并返回路径信息(不包含行驶导引),即对如下 URI 执行 GET 请求:
http://supermapiserver:8090/iserver/services/transportationanalyst-sample/rest/networkanalyst/RoadNet@Changchun/path.rjson?nodes=[2,8]¶meter={"resultSetting":{"returnRoutes":true,"returnPathGuides":false}}
获取的响应内容如下:
HEAD 请求
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 path 资源是否存在,或者客户端是否有权限访问 path 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 path 资源是否支持<format>格式的表述。
请参见