geometryBufferResult

URI

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

支持的方法

GET、HEAD

父资源

geometryBufferResults

介绍

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

支持的方法：

支持的表述格式：RJSON、JSON、HTML、XML、FlatGeobuf。

资源层次

HTTP 请求方法

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

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

GET 请求

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

请求参数

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

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

响应结构

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

对资源执行 GET 请求后，响应参数如下：

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

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

响应示例

对资源执行 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 请求

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

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

请参见