URI

<dataset_uri>/parametricmodeling[.<format>]

支持的方法

GET、POST、HEAD

父资源

dataset

子资源

datasetParametricModelingResult

介绍

模型数据集参数化建模，该资源只针对模型数据集，根据指定参数化建模信息，构建得到模型对象。

该资源在基础版不可用。

对该资源发送POST请求，则可以创建一个参数化建模结果资源。

支持的方法：

  • GET：返回一个进行POST请求的表单。
  • POST：创建一个参数化建模结果资源。
  • HEAD：检查 parametricmodeling资源是否存在，或权限是否可以访问 parametricmodeling资源。

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

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/spatialAnalysis-BIM/restjsr/spatialanalyst/datasets/结构柱@8ExportModel/parametricmodeling.rjson

GET 请求

返回一个进行POST请求的表单。

POST 请求

创建一个参数化建模结果资源。

请求参数

请求体中需传递如下参数：

名称 类型 含义
sourceGeometryParam ModelBuilderParameter 

【必选参数】源几何对象构建参数，可以由不同几何对象经过布尔运算构建得到源几何对象。
operateGeometryParam ModelBuilderParameter 【必选参数】操作几何对象构建参数,，可以由不同几何对象经过布尔运算构建得到操作几何对象。
operationType BooleanOperator3DMode  【必选参数】操作类型,包含UNKNOWN（未知）、INTERSECT（交）、ERASE（差）、UNION（并）。若运算方式为UNKNOWN，则将sourceGeometryParam的运算结果保存至模型数据集；若两个建模参数有一方为空，则取另一方的运算结果。
createLOD boolean  是否为模型对象创建LOD（多细节层次）。
createTexCoord boolean  是否为模型对象计算纹理坐标。
materialParam MaterialParameter  材质信息。仅当创建纹理坐标后，用于为模型对象整体贴图。注意：模型对象未拆分为子对象，只能整体贴图。

响应结构

正常响应情况：响应码201。响应参数如下：

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

响应示例

对 资源：http://supermapiserver:8090/iserver/services/spatialAnalysis-BIM/restjsr/spatialanalyst/datasets/结构柱@8ExportModel/parametricmodeling.rjson，操作对象选择为数据集，执行 POST 请求，请求参数如下：

[{

   sourceGeometryParam : {

         sourceGeometry : {"type":"GEOCYLINDER" , "topRadius": 100,"bottomRadius":100,"height":100, "position":{"x":120.2123,"y":40.20,"z":5}},

         operateGeometry : {"type":"GEOCYLINDER" , "topRadius": 100,"bottomRadius":100,"height":100, "position":{"x":120.2124,"y":40.20,"z":5}},

         operationType : "INTERSECT"

    } ,

    operateGeometryParam : {

        sourceGeometry : {"type":"GEOCYLINDER" , "topRadius": 100,"bottomRadius":100,"height":100, "position":{"x":120.2123,"y":40.20,"z":5}},

        operateGeometry : {"type":"GEOBOX" , "length": 10,"width":10,"height":10, "position":{"x":120.2123,"y":40.20,"z":5},

        operationType : "ERASE”

    },

    operationType : "UNION",

    createTexCoord : true

}]

则返回的 rjson 格式的资源描述如下：

{

"postResultType":"CreateChild"

,"newResourceID":"f71",

"succeed":true,

"newResourceLocation":"http://supermapiserver:8090/iserver/services/spatialAnalysis-BIM/restjsr/spatialanalyst/datasets/结构柱@8ExportModel/parametricmodeling/f71"

}

HEAD 请求

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

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

请参见