routeCalculateMeasureResults


URI

<geometry_uri>/calculatemeasure[.<format>]

支持的方法

GETPOSTHEAD

父资源

geometry

子资源

routeCalculateMeasureResult

介绍

基于路由对象计算指定点的 M 值。对该资源发送 POST 请求,则可以创建一个路由对象 M 值计算结果资源。

支持的方法:

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

资源层次

HTTP 请求方法

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

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

GET 请求

html表述返回一个 POST 请求的表单,其他表述返回路由对象 M 值计算结果集列表。

POST 请求

返回指定点的 M 值计算结果资源。

请求参数

名称 类型 含义
sourceRoute Route 【必选参数】
路由对象。
point Point2D 【必选参数】
点对象。
tolerance double 【可选参数】
容限值。
isIgnoreGap boolean 【可选参数】
是否忽略子对象之间的距离。默认为 false,即不忽略子对象之间的距离。

响应结构

响应参数如下:

字段 类型 说明

succeed

boolean 创建分析结果是否成功。
newResourceID String 分析结果资源的 ID。
postResultType PostResultType

POST 请求的结果类型,枚举说明 POST 请求对目标资源的影响,即处理结果是什么样的。

newResourceLocation String 创建的新资源的 URI。

响应示例

对 routeCalculateMeasureResults 资源 http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/calculatemeasure.rjson,执行 POST 请求,计算一个指定点的 M 值,发送 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

        }]

    },

    "tolerance": 1,

    "point": {

        "x": 3330.7754269417,

        "y": -6838.8394457216

    },

    "isIgnoreGap": false

}

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

{

    "succeed": true,

    "newResourceID": "ejqx9g7j_a3cf1644f4fe47669272e1c3b104fd5d",

    "postResultType": "CreateChild",

    "newResourceLocation": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/calculatemeasure/ejqx9g7j_a3cf1644f4fe47669272e1c3b104fd5d"

}

HEAD 请求

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

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

请参见