<geometry_uri>/routelocator[.<format>]
基于路由对象定位点(线)结果集资源。对该资源发送 POST 请求,则可以创建一个路由定位点(线)分析结果资源。
支持的方法:
支持的表述格式:(rjson、json、html、xml)。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/routelocator.rjson
html表述返回一个 POST 请求的表单,其他表述返回路由对象定位点(线)结果集列表。
返回创建的路由定位点(线)分析结果资源。
名称 | 类型 | 含义 |
sourceRoute | Route | 【必选参数】 路由对象。 |
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 格式请求体如下:
{
"sourceRoute": {
"type": "LINEM",
"parts": [4],
"points": [{
"measure": 0,
"y": -6674.466867067764,
"x": 3817.3527876130133
},
{
"measure": 199.57954019411724,
"y": -6670.830929417594,
"x": 3617.806369901496
},
{
"measure": 609.3656478634477,
"y": -6877.837541432356,
"x": 3264.1498746678444
},
{
"measure": 936.0174126282958,
"y": -7038.687780615184,
"x": 2979.846206068903
}]
},
"type": "POINT",
"measure": 10,
"offset": 0,
"isIgnoreGap": false
}
则返回的 rjson 格式结果如下:
{
"succeed": true,
"newResourceID": "ryw0x19a_478fb6d0164248c79e05fcb955a19dfe",
"postResultType": "CreateChild",
"newResourceLocation": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/routelocator/ryw0x19a_478fb6d0164248c79e05fcb955a19dfe"
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 routeLocatorResults 资源是否存在,或者客户端是否有权限访问 routeLocatorResults 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 routeLocatorResults 资源是否支持<format>格式的表述。