URI

<geometryOverlayResults_uri>/{geometryOverlayResultID}[.<format>]

Supported methods

GETHEAD

Parent resource

geometryOverlayResults

Introduction

几何要素叠加分析结果资源,表示一个几何对象叠加分析的结果。

Supported methods:

  • GET:返回几何要素叠加分析结果的资源。
  • HEAD:检查 geometryOverlayResult resource exists, or if there is permission to access geometryOverlayResult 资源。

Supported output formats:RJSON、JSON、HTML、XML、FlatGeobuf。

GIS Services Resource Hierarchy

HTTP Request Methods

对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名,1为 geometryOverlayResults 资源创建的结果资源的 ID。

http://supermapiserver:8090/iserver/services/geometry/restjsr/v1/geometry/overlay/1.rjson

GET 请求

返回几何要素叠加分析结果资源。

Request parameters

对 geometryOverlayResult 资源执行 GET 请求,需要在 URI 中包含一些参数,如下:

Field Type Definition
withIndex boolean 当使用 FlatGeobuf 表述时该参数可选。表示返回的表述为 FlatGeobuf 的结果是否包含空间索引,默认为true。

Response structure

After performing a GET request on the resource, the response parameters are as follows:

Name Type Description
succeed boolean 叠加分析是否成功;成功则返回 true,否则返回 false。
image ImageResult 空间分析结果图片。表达了 SuperMap iServer 空间分析结果产生的图片以及图片信息相关的描述。
message String 叠加分析过程中产生的相关信息。
resultGeometry Geometry 空间分析结果几何对象。

Response structure

After performing a GET request on the resource, the response parameters are as follows:

Name Type Description
succeed boolean 叠加分析是否成功;成功则返回 true,否则返回 false。
image ImageResult

空间分析结果图片。表达了 SuperMap iServer 空间分析结果产生的图片以及图片信息相关的描述。

message String 叠加分析过程中产生的相关信息。
resultGeometry Geometry 空间分析结果几何对象。

Example of response

对资源执行 GET 请求后,返回的 json 结果如下:

{

  "image": null,

  "resultGeometry": {

    "center": {

      "x": 32.791666666666664,

      "y": 28.5

    },

    "parts": [4],

    "style": null,

    "prjCoordSys": null,

    "id": 0,

    "type": "REGION",

    "partTopo": [1],

    "points": [

      {

        "x": 23,

        "y": 23

      },

      {

        "x": 33,

        "y": 35

      },

      {

        "x": 43,

        "y": 22

      },

      {

        "x": 23,

        "y": 23

      }

    ]

  },

  "succeed": true,

  "message": null

}

HEAD 请求

Returns the same HTTP response headers as a GET request, but without the response body. This allows retrieving meta-information from the response headers without transporting the entire content. The meta-information includes the media type,字符编码,压缩编码,实体内容长度等。

A HEAD request can be used to check if geometryOverlayResult 资源是否存在,或者客户端是否有权限访问geometryOverlayResult 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 geometryOverlayResult 资源是否支持<format>格式的表述。

See