<geometry_uri>/calculatemeasure[.<format>]
基于路由对象计算指定点的 M 值。对该资源发送 POST 请求,则可以创建一个路由对象 M 值计算结果资源。
支持的方法:
支持的表述格式:(rjson、json、html、xml)。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/calculatemeasure.rjson
html表述返回一个 POST 请求的表单,其他表述返回路由对象 M 值计算结果集列表。
返回指定点的 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"
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 routeCalculateMeasureResults 资源是否存在,或者客户端是否有权限访问 routeCalculateMeasureResults 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 routeCalculateMeasureResults 资源是否支持<format>格式的表述。