routeLocatorResults

URI

<linearReferencing_uri>/routelocator[.<format>]

支持的方法

GET、POST、HEAD

父资源

linearReferencing

子资源

routeLocatorResult

介绍

路由定位分析结果资源。

支持的方法：

GET：html表述返回一个 POST 请求的表单，其他表述返回路由定位分析结果集列表。
POST：返回创建的路由定位分析结果资源。有定位点和定位线两种类型。
HEAD：检查 routeLocatorResults 资源是否存在，或权限是否可以访问 routeLocatorResults 资源。

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

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/RouteDT_road@Changchun/linearreferencing/routelocator.rjson

GET 请求

html表述返回一个 POST 请求的表单，其他表述返回路由定位分析结果集列表。

POST 请求

基于路由对象定位点（线）结果集资源。对该资源发送 POST 请求，则可以创建一个路由定位点（线）分析结果资源。

请求参数

名称	类型	含义
RouteIDField	String	【必选参数】路由标识字段
RouteID	String	【必选参数】路由对象标识，和 RouteIDField 对应。
type	LocateType	【必选参数】类型：点 or 线。
measure	double	定位点的 M 值。只当路由对象定位点时有意义。
offset	double	定位点偏移量。只当路由对象定位点时有意义，默认为0。
isIgnoreGap	boolean	是否忽略子对象之间的距离。默认为 false，即不忽略子对象之间的距离。
startMeasure	double	定位线的起始 M 值。只当路由对象定位线时有意义。
endMeasure	double	定位线的终止 M 值。只当路由对象定位线时有意义。

响应结构

相应参数如下：

字段	类型	说明
succeed	boolean	创建分析结果是否成功。
newResourceID	String	分析结果资源的 ID。
postResultType	PostResultType	POST 请求的结果类型，枚举说明 POST 请求对目标资源的影响，即处理结果是什么样的。
newResourceLocation	String	创建的新资源的 URI。

响应示例

对 routeLocatorResults 资源 http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/routelocator.rjson，执行 POST 请求，进行一次路由定位点的操作，发送 rjson 格式请求体如下：

{

"routeIDField": "RouteID",

"routeID": "1580",

"type": "POINT",

"measure": 10,

"offset": 0,

"isIgnoreGap": false

}

则返回的 rjson 格式结果如下：

{

"succeed": true,

"newResourceID": "lrzw2mki_b7d2fbb3a0f94105968062126e49efff",

"postResultType": "CreateChild",

"newResourceLocation": "http://localhost:8090/iserver/services/spatialanalyst-changchun/restjsr/spatialanalyst/datasets/RouteDT_road@Changchun/linearreferencing/routelocator/lrzw2mki_b7d2fbb3a0f94105968062126e49efff"

}

HEAD 请求

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

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

URI