path

 URI

<networkDataName_uri>/path[.<format>]

支持的方法

GET、HEAD

父资源

networkDataName

介绍

path 资源表示最佳路径分析功能，设置参数后，对 path 资源执行 GET 请求，可以获取一个最佳路径分析的结果。有关最佳路径分析的详细介绍，请参见：最佳路径分析。

支持的方法：

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

资源层次

resources.htm

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 交通网络分析通用参数，有以下参数可供设置：
  • barrierEdgeIDs：障碍弧段 ID 列表。
  • barrierNodeIDs：障碍结点 ID 的集合。
  • barrierPoints：障碍坐标数组。您可以用坐标的形式设置障碍。
  • resultSetting：分析结果内应包含内容的设置，包括：
1）returnEdgeFeatures：是否在分析结果中包含弧段要素集合。
2）returnEdgeGeometry：是否在分析结果中返回的弧段要素集合中包含几何对象信息。
3）returnEdgeIDs：返回分析结果中是否包含经过弧段 ID 的集合。
4）returnNodeFeatures：是否在分析结果中包含结点要素集合。
5）returnNodeGeometry：是否在分析结果中返回的结点要素集合中包含几何对象信息。
6）returnNodeIDs：返回分析结果中是否包含经过的结点 ID 集合。
7）returnPathGuides：返回分析结果中是否包含行驶导引集合。
8）returnRoutes：返回分析结果中是否包含路径对象的集合，即 Route 集合。
请注意，1）设置以上参数后不影响结分析结果，但设置后将导致分析耗时增加。 2）当启用 SSC 分析模型并以结点坐标作为输入值时，以上参数除路径对象外均不会在结果中返回。
  • turnWeightField：转向权值字段的名称。
  • uCross：U型道路禁行限制字段。
  • weightFieldName：权值字段信息的名称，标识了进行网络分析时所使用的权值字段。默认为环境中设置的第一个字段。

响应结构

执行最佳路径分析功能，返回的操作结果表述的结构如下（表述在响应消息的实体主体里）：

字段 类型 说明
pathList List<Path> 最佳路径分析结果集合（目前集合中只有一个元素）。

响应示例

对 RoadNet@Changchun 数据集执行最佳路径分析并返回路径信息（不包含行驶导引），即对如下 URI 执行 GET 请求：

http://supermapiserver:8090/iserver/services/transportationanalyst-sample/rest/networkanalyst/RoadNet@Changchun/path.rjson?nodes=[2,8]&parameter={"resultSetting":{"returnRoutes":true,"returnPathGuides":false}}

获取的响应内容如下：

HEAD 请求

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

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

请参见