URI

<geometry_uri>/3d/convexhull[.<format>]

Supported methods

GETPOSTHEAD

Parent resource

geometry

Child resources

geometryConvexHullResult

Introduction

基于模型对象的凸包运算。对该资源发送POST请求,则可以Creates a凸包结果资源。

Supported methods:

  • GET:Returns a form for the POST request.
  • POST:Creates a凸包结果资源。
  • HEAD:检查convexhullresource exists, or if there is permission to accessconvexhull资源。

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

GIS Services Resource Hierarchy

 

HTTP Request Methods

Perform an HTTP request on the following URI, using the rjson output format as an example. Here, supermapiserver is the server name.

http://supermapiserver:8090/iserver/services/spatialAnalysis-BIM/restjsr/spatialanalyst/geometry/3d/convexhull.rjson

GET 请求

Returns a form for the POST request.

POST 请求

Creates a凸包结果资源。

Request parameters

Parameters in the request body are as follows:

Field Type Definition
model GeoModel3D [Required parameter]源模型对象,即凸包计算中被操作的模型对象
resultSetting GeometrySpatialAnalystResultSetting 凸包计算结果设置,即模型对象凸包结果设置

Response structure

Normal response code(s): 201. The response parameters are as follows:

Name Type Description
postResultType postResultType POST 请求的结果类型,枚举说明 POST 请求对目标资源的影响,即处理结果是什么样的。
newResourceID String 分析结果资源的 ID。
succeed boolean 分析是否成功。
newResourceLocation String 创建的新资源的 URI。

Example of response

对geometryConvexHullResults资源:http://supermapiserver:8090/iserver/services/spatialAnalysis-BIM2/restjsr/spatialanalyst/geometry/3d/convexhull.rjson,执行 POST 请求,请求参数如下:

{

"model":{"type":"GEOMODEL3D", "modelUrl":"http://supermapiserver:8090/SampleData/AirPlane.s3m", "position":{"x":120.2, "y":40.2, "z":10}}

}

The returned resource description in rjson format is shown below:

{

"postResultType":"CreateChild",

"newResourceID":"ca097"

,"succeed":true,

"newResourceLocation":"http://supermapiserver:8090/iserver/services/spatialAnalysis-BIM/restjsr/spatialanalyst/geometry/3d/convexhull/ca097"

}

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

See