URI

<geometryBufferResults_uri>/{geometryBufferResultID}[.<format>]

Supported methods

GET、HEAD

Parent resource

geometryBufferResults

Introduction

几何要素缓冲区分析结果资源，表示一个几何对象缓冲区分析的结果。

Supported methods:

  • GET：返回几何要素缓冲区分析结果资源的信息。
  • HEAD：检查 geometryBufferResult resource exists, or if there is permission to access geometryBufferResult 资源。

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

GIS Services Resource Hierarchy

HTTP Request Methods

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

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

GET 请求

返回几何要素缓冲区分析结果资源的信息。

Request parameters

对 geometryBufferResult 资源执行 GET 请求，需要在 URI 中包含一些参数，如下：

名称 类型 含义
withIndex boolean 当使用 FlatGeobuf 表述时该参数可选。表示返回的表述为 FlatGeobuf 的结果是否包含空间索引，默认为true。

Response structure

正常响应情况：响应码200。

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

字段 类型 说明
succeed boolean 缓冲区分析是否成功；成功则返回 true，否则返回 false。
image ImageResult

空间分析结果图片。表达了 SuperMap iServer 空间分析结果产生的图片以及图片信息相关的描述。
message String 缓冲区分析过程中产生的相关信息。
resultGeometry Geometry 空间分析结果几何对象。

Example of response

对资源执行 GET 请求后，返回的 rjson 结果如下：

{

  "image": null,

  "resultGeometry": {

    "center": {

      "x": 33,

      "y": 30.680303808392814

    },

    "parts": [15],

    "style": null,

    "prjCoordSys": null,

    "id": 0,

    "type": "REGION",

    "partTopo": [1],

    "points": [

      {

        "x": -48.3733471206735,

        "y": 95.12381937190963

      },

      {

        "x": 33.00000000000001,

        "y": 137

      },

      {

        "x": 114.3733471206735,

        "y": 95.12381937190963

      },

      {

        "x": 124.3733471206735,

        "y": 81.12381937190963

      },

      {

        "x": 141.63939238321439,

        "y": 6.560101269464273

      },

      {

        "x": 101.12381937190965,

        "y": -58.373347120673486

      },

      {

        "x": 47.040562859425755,

        "y": -70.89691727857755

      },

      {

        "x": 39.439898730535745,

        "y": -75.63939238321437

      },

      {

        "x": 33,

        "y": -74.14816332708227

      },

      {

        "x": 26.56010126946427,

        "y": -75.63939238321437

      },

      {

        "x": 18.959437140574273,

        "y": -70.89691727857756

      },

      {

        "x": -35.123819371909626,

        "y": -58.373347120673515

      },

      {

        "x": -75.63939238321437,

        "y": 6.560101269464251

      },

      {

        "x": -58.3733471206735,

        "y": 81.12381937190963

      },

      {

        "x": -48.3733471206735,

        "y": 95.12381937190963

      }

    ]

  },

  "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 geometryBufferResult 资源是否存在，或者客户端是否有权限访问 geometryBufferResult 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 geometryBufferResult 资源是否支持<format>格式的表述。

See