routeLocatorResults


URI

<geometry_uri>/routelocator[.<format>]

支持的方法

GETPOSTHEAD

父资源

geometry

子资源

routeLocatorResult

介绍

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

支持的方法:

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

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/routelocator.rjson

GET 请求

html表述返回一个 POST 请求的表单,其他表述返回路由对象定位点(线)结果集列表。

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"

}

HEAD 请求

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

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

请参见