DB21T 3734-2023城市信息模型（CIM）平台云管理与服务技术规程

辽宁省地方标准JXXXX–2023程2023-05-30发布202023-05-30发布辽宁省住房和城乡建设厅联合发布辽宁省市场监督管理局辽宁省地方标准城市信息模型(CIM)平台云管理与服务技术规程JXXXX–2023主编部门：辽宁省住房和城乡建设厅批准部门：辽宁省住房和城乡建设厅施行日期：2023年06月30日2023年沈阳前言为推动城市治理体系和治理能力现代化建设，贯彻落实《住房和城乡建设部工业和信息化部中央网信办关于开展城市信息模型(CIM)基础平台建设的指导意见》(建科〔2020〕59号)要求，按照《辽宁省人民政府办公厅关于印发辽宁省“十四五”城乡建设高质量发展规划的通知》(辽政办发〔2021〕40号)《关于印发2022年度辽宁省工程建设地方标准制修订计划的通知》(辽住建科〔2022〕11号)等文件要求，标准编制组经广泛调查研究，认真总结实践经验，参考有关国家标准和国外先进标准，并在广泛征求意见的基础上，编制了本规程。本规程的主要技术内容是：1.总则；2.术语和缩略语；3.基本规定；4.资源访问类服务；5.地图类服务；6.项目类服务；7.三维模型类服务；8.BIM类服务；9.控件类服务；10.事件类服务；11.模拟推演类服务；12.实时感知类服务；13.数据交换类服务；14.数据分析类服务；15.平台管理类服务。本规程由辽宁省住房和城乡建设厅负责管理，奥格科技股份有限公司编制并负责技术解释。执行过程中如有意见或建议，请寄送奥格科技股份有限公司(地址：广州市天河区高普路1029、1031号二楼；邮政编码：510663)。本规程主编单位：奥格科技股份有限公司本规程参编单位：中国建筑东北设计研究院有限公司辽宁省城乡建设规划设计院有限责任公司辽宁省产品质量监督检验院辽宁省市政工程设计研究院有限责任公司上海邮电设计咨询研究院有限公司大连市市政设计研究院有限责任公司沈阳市规划设计研究院有限公司本规程主要起草人员：赵伟峰包世泰孔宪娟谭淑樱杨超姚玲欧阳芳何颖王亚胜叶子铭陈本强陈宏福孙禹韩朝杨日清刘俊峰周环宇李鹏飞马健王若冰潘高峰周全李儒耕韩丹陈一龙顾琼侯家帅本规程主要审查人员：陈德龙徐向飞王峰葛宇王永会范凯张海东 4.2获取专题下资源接口 54.3查询目录下的图层接口 54.4获取图层和图层字段列表信息接口 6 5.8超图瓦片数据加载接口 155.9必应瓦片数据加载接口 17 BIM结构列表接口 27 6.4获取材质构件列表接口 28 数据接口 297.3三维数据样式渲染接口 307.4三维样式渲染条件设置接口 32 8.2BIM模型构件操作接口 358.3修改构件材质接口 38 接口 42 12.3查看最新动态接口 60 接口 62 13.5通过平台提供的参数进行坐标转换接口 63 14.3获取数据集下信息接口 68 Contens 2.2Acronyms 3 3.1GeneralRequirements 43.2ServiceRequirements 4 4.1ServiceDescription 54.2ObtainTheResourceInterfacesUnderTheTopic 54.3LayerInterfaceUnderTheQueryDirectory 54.4InterfaceofGettingtheLayerandLayerFieldsListInformation 6 5.1ServiceDescription 75.2TheWFSLoadingInterface 75.3SuperMapWFSLoadingInterface 85.4DynamicWFSLoadingInterface 95.5DynamicWMSLoadingInterface 115.6SuperMapWMSLoadingInterface 125.7TileDatasLoadingInterface 145.8TileDatasofSuperMapLoadingInterface 155.9BingTileDatasLoadingInterface 175.10ArcgisTileDatasLoadingInterface 185.11MapboxTileDatasLoadingInterface 205.12MapWorldTileDatasLoadingInterface 215.133DTilesDatasLoadingInterface 225.14I3SDatasLoadingInterface 245.15S3MDatasLoadingInterface 25 6.1ServiceDescription 276.2InterfaceofGettingtheBIMProjectTreeStructureList 276.3InterfaceofModifingTheBIMReviewProject 276.4InterfaceofGettingtheMaterialComponentList 28 7.1ServiceDescription 297.23DDatasInterface 297.3Interfaceof3DData-StyleRendering 307.4Interfaceof3DStyleRenderingConditionsSetting 32 8.1ServiceDescription 358.2InterfaceofBIMmodelingComponentOperation 358.3InterfaceofModifingtheComponentMaterial 388.4InterfaceofMaterialViewInterface 39 9.1ServiceDescription 409.2SectioningInterface 409.3TerrainExcavationInterface 42 10.1ServiceDescription 4410.2MouseEventInterface 4410.3CameraEventInterface 47 11.1ServiceDescription 5211.2WaterSimulationInterface 5211.3WeatherSimulationInterface 5311.4SubmergenceSimulationInterface 55 12.1ServiceDescription 6012.2QueryAccessInterface 6012.3ViewtheLatestStatusInterface 6012.4DataParsingAccessInterface 6112.5DataCleaningAccessInterface 61 13.1ServiceDescription 6213.2GetMetadataInterface 6213.3CIMDatasDownloadInterface 6213.4LayerAuthorizationInterface 6313.5InterfaceofCoordinateTransformationbytheParametersProvidedbythePlatform 6313.6CoordinateTransformationInterface 64 14.1ServiceDescription 6814.2ClusterAnalysisInterface 6814.3InterfaceofGettheInformationUndertheDataset 6814.4OverlayAnalysisInterface 69 15.1ServiceDescription 7015.2UserAuthorizationInterface 7015.3PostAuthorizationInterface 7015.4OrganizationAuthorizationInterface 7115.5UserUsageOverviewInterface 71 11.0.1为规范辽宁省城市信息模型(CIM)平台服务接口规格和内容，促进信息资源的接入获取，制定本规程。1.0.2本规程适用于指导辽宁省城市信息模型(CIM)平台服务接口的二次开发和应用。1.0.3辽宁省城市信息模型(CIM)平台服务接口的规格和内容除应符合本规程外，尚应符合国家、行业和本省现行有关标准的规定。22术语和缩略语2.1术语2.1.1平台云管理platformcloudmanagement依托云计算技术和其他相关技术，实现数据和计算资源物理分布、逻辑集中的管理模式，并通过严密的权限管理和安全机制来实现数据和信息管理的系统。2.1.2资源访问类服务resourceretrieveservice提供CIM元数据、模型信息查询、目录服务接口、服务配置和融合等功能，实现信息资源的发现、检索和管理。2.1.3地图类服务mapservice提供不同级别不同尺度CIM调用、加载、渲染、场景漫游及属性查询、符号化等功能。2.1.4项目类服务projectservice管理CIM应用的工程建设项目全周期信息，提供信息查询、进展跟踪、信息编辑、模型与资料关联等操作功能。2.1.5三维模型类服务3DModelService提供三维模型的资源描述、调用与交互操作功能。2.1.6BIM类服务BIMservice提供模型信息查询、剖切、批注、绘制、测量、编辑等操作和分析功能。2.1.7控件类服务controlservice提供CIM基础平台中控件功能的调用等功能。2.1.8事件类服务eventservice提供在CIM场景交互中侦听和触发事件等服务。2.1.9模拟推演类服务simulationdeductionservice提供基于CIM的典型应用场景过程模拟、情景再现、预案推演等功能。2.1.10实时感知类服务real-timeperceptionservice提供物联网感知设备定位、接入、监测解译、监测数据推送和调取等服务。2.1.11数据交换类服务datatransformservice提供CIM元数据查询、模型预览、授权访问、数据上传下载和数据格式转换等功能。2.1.12数据分析类服务dataanalysisservice3提供时间、空间和指标等多维度数据对比分析、大数据挖掘分析等功能。2.1.13平台管理类服务platformmanagementservice提供用户认证、权限管理、资源申请和授权审核等管理功能。2.1.14接口interface描述实体行为特征的命名操作集合。2.2缩略语2.2.1下列缩略语适用于本文件。CIM—城市信息模型CityInformationModel/ModelingBIM—建筑信息模型BuildingInformationModel/ModelingI3S——索引三维场景图层Indexed3DSceneLayerS3M——三维空间数据规范Spatial3DModel3DTiles——三维瓦片服务3DTileServiceWMS——网络地图服务WebMapServiceWMTS——网络地图瓦片服务WebMapTileServiceWFS——网络要素服务WebFeatureService43基本规定3.1一般规定3.1.1CIM平台汇聚信息资源宜符合辽宁省现行《城市信息模型(CIM)平台数据采集建库技术规程》的规定。3.1.2CIM平台对外提供信息服务应符合国家、行业及地方相关保密规定，涉密数据应按规定脱密处理。3.1.3CIM平台对外提供信息服务时应提供网络环境、安全要求、硬件条件等参数信息，各参数信息宜符合下列规定：1网络环境：应描述包括IP网络拓扑、IP地址、域名、平台部署位置等信息；2安全要求：应描述安全防护方案；3硬件条件：应提供包括云平台、负载均衡设备等硬件信息。3.2服务规定3.2.1CIM平台应提供数据和服务访问的接口，满足业务协同、信息联动和应用扩展的要求。求3.2.2CIM平台提供的接口宜分为数据类和功能类服务接口，宜通过平台云管理实现接口的访问、调用等服务。1数据类服务接口宜包括资源访问类、地图类、项目类、三维模型类、BIM类服务。2功能类服务接口宜包括控件类、事件类、模拟推演类、实时感知类、数据交换类、数据分析类、平台管理类服务。3.2.3接口使用需求方通过服务接口访问CIM平台时，平台云管理应提供自动监管和异常处理能力，并统一管理管控服务接口参数。3.2.4接口返回值内容应包括接口返回状态、状态提示信息及接口数据内容，接口返回值宜以json数组格式返回。3.2.5CIM平台提供的服务接口可根据实际需求进行扩展，服务安全应符合现行标准及相关国家政策的规定。54资源访问类服务4.1服务描述资源访问类服务应按功能提供获取专题下资源接口、查询目录下的图层接口、获取图层和图层字段列表信息接口。4.2获取专题下资源接口4.2.1接口描述根据专题名称获取专题下的数据资源。4.2.2请求参数获取专题下资源接口请求参数见表4.2.2。表4.2.2获取专题下资源接口请求参数参数名称类型参数说明备注projectNamestring专题名称userIdstringemptydirboolean是否返回空目录默认为true，true返回空目录，false不返回空目录4.2.3返回数据内容专题目录及其下的图层数据。4.3查询目录下的图层接口4.3.1接口描述查询专题目录下的图层。4.3.2请求参数查询目录下的图层接口请求参数见表4.3.2。表4.3.2查询目录下的图层接口请求参数参数名称类型参数说明备注IdstringNamestring图层名称6参数名称类型参数说明备注ProjectNameboolean是否返回专题名称默认为true，true返回空目录，false不返回空目录4.3.3返回数据内容目录及其下的图层数据。4.4获取图层和图层字段列表信息接口4.4.1接口描述查询获取图层和图层字段列表信息。4.4.2请求参数获取图层和图层字段列表信息接口请求参数见表4.4.2。表4.4.2获取图层和图层字段列表信息接口请求参数参数名称类型参数说明备注Idstring图层表id4.4.3返回数据内容图层和图层字段列表数据。包括专题目录，图层名称等。75地图类服务5.1服务描述地图类服务宜按功能提供WFS加载接口、超图WFS加载接口、动态WFS加载接口、动态WMS加载接口、超图WMS加载接口、瓦片数据加载接口、超图瓦片数据加载接口、必应瓦片数据加载接口、Arcgis瓦片数据加载接口、Mapbox瓦片数据加载、天地图瓦片数据加载接口、3DTiles数据加载接口、I3S数据加载接口、S3M数据加载接口。5.2WFS加载接口5.2.1接口描述对地理空间数据库中地理要素的插入、更新、删除、检索和发现等服务进行加载。5.2.2属性列表WFS加载接口属性列表见表5.2.2。表5.2.2WFS加载接口属性列表名称类型备注optionobject初始化参数5.2.3方法列表WFS加载接口方法列表见表5.2.3。表5.2.3WFS加载接口方法列表名称返回类型方法描述constructor(options)无初始化添加图层5.2.4方法详情constructor(options)参数说明：见表5.2.4。表5.2.4参数说明名称类型描述urlstring必填参数，图层链接layerTablestring可选参数，图层名称8名称类型描述spatialReferenceobject可选参数，图层坐标系详细参数layerIndexnumber可选参数，图层叠放顺序，默认undefinedqueryParametersobject可选参数，图层查询参数queryParameters.cql_filterstring可选参数，图层查询过滤条件返回数据内容：无。示例：123456789}}5.3超图WFS加载接口5.3.1接口描述对超图地理空间数据库中地理要素的插入、更新、删除、检索和发现等服务进行加载。5.3.2属性列表超图WFS加载接口属性列表见表5.3.2。表5.3.2超图WFS加载接口属性列表名称类型备注constructor(options)无构造函数5.3.3方法列表9超图WFS加载接口方法列表见表5.3.3。表5.3.3WFS加载接口方法列表名称返回类型方法描述constructor(options)无构造函数5.3.4方法详情constructor(options)参数说明：见表5.3.4。表5.3.4参数说明名称类型描述urlstring必填参数，图层链接layerTablestring可选参数，图层名称spatialReferenceobject可选参数，图层坐标系详细参数versionstring可选参数，图层服务版本，默认“1.0.0”queryParametersobject可选参数，图层查询参数queryParameters.maxFeaturesnumber可选参数，图层查询返回的最大要素数量，默返回数据内容：无。示例：123456789}5.4动态WFS加载接口5.4.1接口描述对动态地理空间数据库中地理要素的插入、更新、删除、检索和发现等服务进行加载。5.4.2属性列表动态WFS加载接口属性列表见表5.4.2。表5.4.2动态WFS加载接口属性列表名称类型备注optionsobject初始化参数5.4.3方法列表动态WFS加载接口方法列表见表5.4.3。表5.4.3动态WFS加载接口方法列表名称返回类型方法描述constructor(options)无构造函数5.4.4方法详情constructor(options)参数说明：见表5.4.4。表5.4.4参数说明名称类型备注urlstring必填参数，图层链接layerTablestring可选参数，图层名称spatialReferenceobject可选参数，图层坐标系详细参数crsstring可选参数，图层WFS请求CRS参数queryParametersobject可选参数，图层查询参数queryParameters.maxFeaturesnumber可选参数，图层查询返回的最大要素数量，默认5000返回数据内容：无。示例：12345}67895.5动态WMS加载接口5.5.1接口描述对以图像格式返回的相同空间参照系叠加组合形成的动态地理空间数据等服务进行加载。5.5.2属性列表动态WMS加载接口属性列表见表5.5.2。表5.5.2动态WMS加载接口属性列表名称类型备注optionsobject初始化参数5.5.3方法列表动态WMS加载接口方法列表见表5.5.3。表5.5.3动态WMS加载接口方法列表名称返回类型方法描述constructor(options)无构造函数5.5.4方法详情constructor(options)参数说明：见表5.5.4。表5.5.4参数说明名称类型描述urlstring必填参数，图层链接layerTablestring必填参数，图层名称名称类型描述spatialReferenceobject可选参数，图层坐标系详细参数layerIndexnumber可选参数，图层叠放顺序，默认undefinedcrsstring可选参数，图层WFS请求CRS参数queryParametersobject可选参数，图层查询参数queryParameters.widthnumber可选参数，图层查询返回图片宽度，默认1280queryParameters.heightnumber可选参数，图层查询返回图片高度，默认1280queryParameters.formatstring可选参数，图层服务图片查询输出格式，默认"image/png"queryParameters.versionstring可选参数，图层服务版本，默认1.3.0queryParameters.stylesstring可选参数，图层服务渲染样式名称，默认""queryParameters.transparentboolean可选参数，图层服务图片背景是否透明，默认true返回数据内容：无。示例：123456789}5.6超图WMS加载接口5.6.1接口描述对以图像格式返回的相同空间参照系叠加组合形成的超图地理空间数据等服务进行加载。5.6.2属性列表超图WMS加载接口属性列表见表5.2.2。表5.6.2超图WMS加载接口属性列表名称类型备注optionsobject初始化参数5.6.3方法列表超图WMS加载接口方法列表见表5.6.3。表5.6.3超图WMS加载接口方法列表名称返回类型方法描述constructor(options)无构造函数5.6.4方法详情constructor(options)参数说明：见表5.6.4。表5.6.4参数说明名称类型描述urlstring必填参数，图层链接layerTablestring必填参数，图层名称spatialReferenceobject可选参数，图层坐标系详细参数layerIndexnumber可选参数，图层叠放顺序，默认undefinedcrsstring可选参数，图层WFS请求CRS参数queryParametersobject可选参数，图层查询参数queryParameters.formatstring可选参数，图层服务图片查询输出格式，默认"image/png"queryParameters.stylesstring可选参数，图层服务渲染样式名称，默认""queryParameters.transparentboolean可选参数，图层服务图片背景是否透明，默认true返回数据内容：无。示例：123456789}5.7瓦片数据加载接口5.7.1接口描述瓦片数据加载。5.7.2属性列表瓦片数据加载接口属性列表见表5.7.2。表5.7.2瓦片数据加载接口属性列表名称类型备注optionsobject初始化参数5.7.3方法列表瓦片数据加载接口方法列表见表5.7.3。表5.7.3瓦片数据加载接口方法列表名称返回类型方法描述constructor(options)无初始化图层5.7.4方法详情constructor(options)参数说明：见表5.7.4。表5.7.4参数说明名称类型描述urlstring必填参数，图层链接layerTablestring必填参数，图层名称名称类型描述spatialReferenceobject可选参数，图层坐标系详细参数layerIndexnumber可选参数，图层叠放顺序，默认undefinedtileMatrixSetstring可选参数，图层矩阵集tileMatrixLabelsarray可选参数，图层切片分级名称数组，默认自动读取tileWidthnumber可选参数，切片宽度，默认256tileHeightnumber可选参数，切片高度，默认256tileOriginXnumber可选参数，切片原点X坐标，默认自动读取tileOriginYnumber可选参数，切片原点Y坐标，默认自动读取minimumLevelnumber可选参数，最小可见级，默认0maximumLevelnumber可选参数，最大可见级，默认不限制返回数据内容：无。示例：123456789}5.8超图瓦片数据加载接口5.8.1接口描述超图瓦片数据加载。5.8.2属性列表超图瓦片数据加载接口属性列表见表5.8.2。表5.8.2超图瓦片数据加载接口属性列表名称类型备注名称类型备注optionsobject初始化参数5.8.3方法列表超图瓦片数据加载接口方法列表见表5.8.3。表5.8.3超图瓦片数据加载接口方法列表名称返回类型方法描述constructor(options)无初始化图层5.8.4方法详情constructor(options)参数说明：见表5.8.4。表5.8.4参数说明名称类型描述urlstring必填参数，图层链接layerTablestring必填参数，图层名称spatialReferenceobject可选参数，图层坐标系详细参数layerIndexnumber可选参数，图层叠放顺序，默认undefinedtileMatrixSetstring可选参数，图层矩阵集tileMatrixLabelsarray可选参数，图层切片分级名称数组，默认自动读取tile0Resolutionnumber可选参数，切片第0级分辨率，默认自动读取tileWidthnumber可选参数，切片宽度，默认256tileHeightnumber可选参数，切片高度，默认256tileOriginXnumber可选参数，切片原点X坐标，默认自动读取tileOriginYnumber可选参数，切片原点Y坐标，默认自动读取minimumLevelnumber可选参数，最小可见级，默认0maximumLevelnumber可选参数，最大可见级，默认不限制返回数据内容：无。示例：123456789}5.9必应瓦片数据加载接口5.9.1接口描述必应瓦片数据加载。5.9.2属性列表必应瓦片数据加载接口属性列表见表5.9.2。表5.9.2必应瓦片数据加载接口属性列表名称类型备注optionsobject初始化参数5.9.3方法列表必应瓦片数据加载接口方法列表见表5.9.3。表5.9.3必应瓦片数据加载接口方法列表名称返回类型方法描述constructor(options)无初始化图层5.9.4方法详情constructor(options)参数说明：见表5.9.4。表5.9.4参数说明名称类型描述urlstring必填参数，图层链接layerIndexnumber可选参数，图层叠放顺序，默认undefinedtokenstring可选参数，必应地图服务访问许可key值名称类型描述culturestring必应服务的区域语言代码，默认'zh-Hans'mapStylebingmapsstyle服务使用样式，默认Cesium.BingMapsStyle.AERIAL返回数据内容：无。示例：123456789}5.10Arcgis瓦片数据加载接口5.10.1接口描述Arcgis瓦片数据加载。5.10.2属性列表Arcgis瓦片数据加载接口属性列表见表5.10.2。表5.10.2Arcgis瓦片数据加载接口属性列表名称类型备注optionsobject初始化参数5.10.3方法列表Arcgis瓦片数据加载接口方法列表见表5.10.3。表5.10.3Arcgis瓦片数据加载接口方法列表名称返回类型方法描述constructor(options)无初始化图层5.10.4方法详情constructor(options)名称类型描述urlstring必填参数，图层链接spatialReferenceobject可选参数，图层坐标系详细参数layerIndexnumber可选参数，图层叠放顺序，默认undefinedtileWidthnumber可选参数，切片宽度，默认256tileHeightnumber可选参数，切片高度，默认256tileOriginXnumber可选参数，切片原点X坐标，默认自动读取tileOriginYnumber可选参数，切片原点Y坐标，默认自动读取centerLonnumber可选参数，坐标系中心点经度，默认自动读取centerLatnumber可选参数，坐标系中心点纬度，默认自动读取返回数据内容：无。示例：123456789}205.11.1接口描述Mapbox瓦片数据加载。Mapbox瓦片数据加载接口5.11.2属性列表Mapbox瓦片数据加载接口属性列表见表5.11.2。表5.11.2Mapbox瓦片数据加载接口属性列表名称类型备注optionsobject初始化参数5.11.3方法列表Mapbox瓦片数据加载接口方法列表见表5.11.3。表5.11.3Mapbox瓦片数据加载接口方法列表名称返回类型方法描述constructor(options)无初始化图层5.11.4方法详情constructor(options)options参数说明：见表5.11.4。名称类型描述urlstring必填参数，图层链接layerTablestring必填参数，图层名称，对应usernamelayerIndexnumber可选参数，图层叠放顺序，默认undefinedtokenstring可选参数，地图服务访问许可token，对应accessTokenstyleIdstring可选参数，Mapbox样式IDminimumLevelnumber可选参数，最小可见级，默认0maximumLevelnumber可选参数，最大可见级，默认不限制返回数据内容：无。示例：21123456789}5.12天地图瓦片数据加载接口5.12.1接口描述天地图瓦片数据加载。5.12.2属性列表天地图瓦片数据加载接口属性列表见表5.12.2。表5.12.2天地图瓦片数据加载接口属性列表名称类型备注optionsobject初始化参数5.12.3方法列表天地图瓦片数据加载接口方法列表见表5.12.3。表5.12.3天地图瓦片数据加载接口方法列表名称返回类型方法描述constructor(options)无初始化图层5.12.4方法详情constructor(options)名称类型描述urlstring必填参数，图层链接22名称类型描述spatialReferencestring必填参数，图层坐标系详细参数layerIndexnumber可选参数，图层叠放顺序，默认undefinedminimumLevelnumber可选参数，最小可见级，默认0maximumLevelnumber可选参数，最大可见级，默认不限制返回数据内容：无。示例：123456789}5.133DTiles数据加载接口5.13.1接口描述3DTiles数据加载。5.13.2属性列表3DTiles数据加载接口属性列表见表5.13.2。表5.13.23DTiles数据加载接口属性列表名称类型备注optionsobject初始化参数5.13.3方法列表3DTiles数据加载接口方法列表见表5.13.3。23表5.13.33DTiles数据加载接口方法列表名称返回类型方法描述constructor(options)无初始化图层setStyle(styleExpression)无设置3dtiles的样式5.13.4方法详情1constructor(options)名称类型描述urlstring3dtiles图层服务链接optionobject可选参数，tileset具体属性信息styleIdobject可选参数，运维后台配置的图层样式ID返回数据内容：无。示例：123456789}2setStyle(styleExpression)表5.13.4-2。数说明名称类型描述styleExpressionobject要设置的样式返回数据内容：无。24示例：123456789],}}5.14I3S数据加载接口5.14.1接口描述I3S数据加载。5.14.2属性列表I3S数据加载接口属性列表见表5.14.2。表5.14.2I3S数据加载接口属性列表名称类型备注optionsobject初始化参数5.14.3方法列表I3S数据加载接口方法列表见表5.14.3。表5.14.3I3S数据加载接口方法列表名称返回类型方法描述constructor(options)无构造函数255.14.4方法详情constructor(options)名称类型描述urlstring必填参数，图层服务地址spatialReferenceobject可选参数，图层坐标系详细参数返回数据内容：无。示例：123456789}5.15S3M数据加载接口5.15.1接口描述S3M数据加载。5.15.2属性列表S3M数据加载接口属性列表见表5.15.2。表5.15.2S3M数据加载接口属性列表名称类型备注optionsobject初始化参数对象265.15.3方法列表S3M数据加载接口方法列表见表5.15.3。表5.15.3S3M数据加载接口方法列表名称返回类型方法描述constructor(options)无构造函数5.15.4方法详情constructor(options)名称类型描述urlstring必填参数，S3M图层服务地址tilesetOptionobject可选参数，常规的tileset的选项tilesetOption.maxVisibleDistancenumber可选参数，默认值number.MAX_VALUEtilesetOption.minVisibleDistancenumber可选参数，默认值0.0tilesetOption.lodRangeScalenumber可选参数，默认值1.0返回数据内容：无。示例：123456789}276项目类服务6.1服务描述项目类服务宜按功能提供获取BIM项目树结构列表接口、修改BIM审查项目接口、获取材质构建列表接口。6.2获取BIM项目树结构列表接口6.2.1接口描述获取所有项目信息数据，并用树目录形式查询，根据类型筛选。6.2.2请求参数获取BIM项目树结构列表接口请求参数见表6.2.2。表6.2.2获取BIM项目树结构列表接口请求参数参数名称类型参数说明备注Typestring项目类型6.2.3返回数据内容目录及其下的项目信息。6.3修改BIM审查项目接口6.3.1接口描述修改审查项目的各类信息。6.3.2请求参数修改BIM审查项目接口请求参数见表6.3.2。表6.3.2修改BIM审查项目接口请求参数参数名称类型参数说明备注idstringnamestring审查项目名serverContents[0].bldgIdstring房屋建筑统一编码serverContents[0].buildingTypestring实体分类28参数名称类型参数说明备注serverContents[0].fileIdstring文件包含的文件数量serverContents[0].makeTypestring制作方式serverContents[0].sourceRelIdstring文件来源关联的业务ID6.3.3返回数据内容无。无6.4获取材质构件列表接口6.4.1接口描述根据空间或者属性筛选获取构件列表。6.4.2请求参数获取材质构件列表接口请求参数见表6.4.2。表6.4.2获取材质构件列表接口请求参数参数名称类型参数说明备注boundingboxstring包围盒信息，如果为房间，还包含组成房间的所有边界catagorystring构件分类(字典的code值)categorypathstring类目编码codefamilynamestring族名称familytypestring族类型levelstring标高professionstring专业：消防，电气，管道6.4.3返回数据内容构件材质信息。297.1服务描述三维模型类服务宜按功能提供三维数据接口、三维数据样式渲染接口、三维样式渲染条件设置接口。7.2三维数据接口7.2.1接口描述将三维数据进行高亮显示。7.2.2方法列表三维数据接口方法列表见表7.2.2。表7.2.2三维数据接口方法列表名称返回类型方法描述add()无添加高亮效果remove()无移除高亮效果7.2.3方法详情1Add(pickedFeature,viewer,color)参数说明：见表7.2.3。表7.2.3参数说明名称类型描述pickedFeatureobject由pick方法获取的对象viewer.scene.pick(movement.position)viewerviewer地图viewer对象colorcolor高亮颜色，默认Color.YELLOW返回数据内容：无。示例：123302remove()参数说明：名称类型描述viewerviewer地图viewer对象返回数据内容：无。示例：17.3三维数据样式渲染接口7.3.1接口描述设置三维数据样式和渲染效果。7.3.2方法列表三维数据样式渲染接口方法列表见表7.3.2。表7.3.2三维数据样式渲染接口方法列表名称返回类型方法描述setMaterialFromImage()无设置对象的材质为图片setOpacity()无设置对象透明度setTilesetColor()无设置三维瓦片的颜色样式setTilesetModelColor()无设置三维瓦片的模型的颜色样式7.3.3方法详情1setMaterialFromImage(primitive,img).3-1。名称类型描述primitiveprimitive要改变样式的primitive对象imgstring图片的base64字符串或者文件路径返回数据内容：无。示例：13122setOpacity(primitive,alpha)参数说明：见表7.3.3-2。表7.3.3-2参数说明名称类型描述primitiveprimitive要改变样式的primitive对象alphanumber透明度值，0-1返回数据内容：无。示例：13setTilesetColor(tileSet,color)参数说明：见表7.3.3-3。表7.3.3-3参数说明名称类型描述tileSetcesium3DTileset要改变样式的3dtiles对象colorcolor颜色返回数据内容：无。示例：14setTilesetModelColor(tileSet,color)参数说明：见表7.3.3-4。表7.3.3-4参数说明名称类型描述tileSetcesium3DTileset要改变样式的3dtiles对象colorcolor颜色返回数据内容：无。示例：32127.4三维样式渲染条件设置接口7.4.1接口描述设置三维样式渲染条件。7.4.2属性列表三维样式渲染条件设置接口属性列表见表7.4.2。表7.4.2三维样式渲染条件设置接口属性列表名称类型备注tilesetcesium3DTileset要改变样式3dtiles对象7.4.3方法列表三维样式渲染条件设置接口方法列表见表7.4.3。表7.4.3三维样式渲染条件设置接口方法列表名称返回类型方法描述addShowCondition()无添加显示条件addHideCondition()无添加隐藏条件setShowStyle()无设置3dtiles显隐setColorStyle()无设置颜色样式setOpacity()无设置3dtiles透明度7.4.4方法详情1addShowCondition(condition).4-1。名称类型描述conditionstring显示条件，一个表达式"${id}===1&&${level}===1"返回数据内容：无。示例：12332addHideCondition(condition)参数说明：见表7.4.4-2。表7.4.4-2参数说明名称类型描述conditionstring隐藏条件，一个表达式"${id}===1&&${level}===1"返回数据内容：无。示例：123setShowStyle(condition)参数说明：见表7.4.4-3。表7.4.4-3参数说明名称类型描述conditionarray显隐条件，一个数组[["${id}===1",true]]返回数据内容：无。示例：124setColorStyle(condition)参数说明：见表7.4.4-4。表7.4.4-4参数说明名称类型描述conditionarray样式条件，一个数组[["${id}===1",color('WHITE')]]返回数据内容：无。示例：13425setOpacity(opacity)参数说明：见表7.4.4-5。表7.4.4-5参数说明名称类型描述opacitynumber透明度(0-1之间的数值)返回数据内容：无。示例：12358BIM类服务8.1服务描述BIM类服务宜按功能提供BIM模型构件操作接口、修改构件材质接口、材质查看接口。8.2BIM模型构件操作接口8.2.1接口描述主要用于对模型构件进行定位、获取构件的坐标矩阵、从BIM的局部坐标系转到笛卡尔(Cartesian3)坐标系、获取构件尺寸、标注构件尺寸等。8.2.2方法列表BIM模型构件操作接口方法列表见表8.2.2。表8.2.2BIM模型构件操作接口方法列表名称返回类型方法描述flyTo()无构件定位，根据定位类型将相机移动到构件位置getModelMatrix()无获取构件坐标矩阵，用于获取替换构件的坐标矩阵(假设替换构件的朝向都是面朝正南方向)getWorldPosition()cartesian3获取世界坐标，用于获取从BIM的局部坐标转换的Cartesian3坐标markingSize()无尺寸标注，用于标注构件尺寸getSizes()Size获取构件尺寸，用于获取构件尺寸信息isSuitable()boolean判断构件尺寸，用于判断替换的构件尺寸是否合适getClippingPlane()clippingplanecollection获取剖切面，用于获取墙体的剖切面板createBoundingBox()boundingsphere创建包围盒，通过包围盒数据创建包围盒getBoundingBox()axisalignedboundingbox获取包围盒，用于获取aabb包围盒信息removeMark()无移除标记，用来移除构件尺寸标记368.2.3方法详情1flyTo(data,tileset,type,viewer).3-1。名称类型描述dataobject数据库查询的包围盒、拓扑等信息tilesetcesium3DTileset定位的模型构件typestring定位的类型：Element、Room、Levelviewerviewer当前活动的视图对象返回数据内容：无。2getModelMatrix(modelMatrix,data)参数说明：见表8.2.3-2。表8.2.3-2参数说明名称类型描述modelMatrixmatrix4(四维矩阵)3dtiles的坐标矩阵dataobject构件包围盒、拓扑信息返回数据内容：计算后构件的坐标矩阵。3getWorldPosition(localCoordinates,modelMatrix,scale=1,face)参数说明：见表8.2.3-3。表8.2.3-3参数说明名称类型描述localCoordinatesobjectBIM模型局部坐标系modelMatrixmatrix43dtiles的坐标矩阵scalenumber以米为换算单位，如为英寸则传入0.3048facestring(可选)构件朝向，仅在计算尺寸标注时需要传入37返回数据内容：转换后的笛卡尔坐标。4markingSize(data,modelMatrix,color)参数说明：见表8.2.3-4。表8.2.3-4参数说明名称类型描述dataobject数据库查询到的构件拓扑信息modelMatrixmatrix43dtiles的坐标矩阵colorcolor标注的颜色返回数据内容：无。5getSizes(data)参数说明：见表8.2.3-5。表8.2.3-5参数说明名称类型描述dataobject构件对象返回数据内容：构件的宽×高信息。6isSuitable(modelData,wallData,repaceData)参数说明：见表8.2.3-6。表8.2.3-6参数说明名称类型描述modelDataobject构件对象wallDatamatrix43dtiles的坐标矩阵repaceDatastring要替换的窗户或门的尺寸：宽×高返回数据内容：true合适，false不合适。7getClippingPlane(wallData,winData,size)参数说明：见表8.2.3-7。38表8.2.3-7参数说明名称类型描述wallDataobject墙体数据winDataobject窗户数据sizestring要替换的窗户或门的尺寸：宽×高返回数据内容：ClippingPlaneCollection剖切面集合。8createBoundingBox(boundingBox)参数说明：见表8.2.3-8。表8.2.3-8参数说明名称类型描述boundingBoxobject构成包围盒的坐标数组返回数据内容：BoundingSphere：certer包围盒中心。9getBoundingBox(data)参数说明：见表8.2.3-9。表8.2.3-9参数说明名称类型描述dataarray构成包围盒的坐标数组返回数据内容：AxisAlignedBoundingBox：certer包围盒中心。10removeMark()参数说明：无。返回数据内容：无。8.3修改构件材质接口8.3.1接口描述修改构件材质详细信息。8.3.2请求参数修改构件材质接口请求参数见表8.3.2。39表8.3.2修改构件材质接口请求参数参数名称类型参数说明备注idstringuserIdstringboundingboxstring包围盒信息，如果为房间，还包含组成房间的所有边界familynamestring族名称familytypestring族类型levelstring标高professionstring业：消防，电气，管道smallCodestring小类(小类代码)tableCodestring分类名称8.3.3返回数据内容无。无8.4材质查看接口8.4.1接口描述查看已经入库的构件材质信息。8.4.2请求参数材质查看接口请求参数见表8.4.2。表8.4.2材质查看接口请求参数参数名称类型参数说明备注idstringtypestringtype=1预览图片；type=2预览构件8.4.3返回数据内容无。无409控件类服务9.1服务描述控件类服务宜按功能提供剖切接口、地形开挖接口。9.2剖切接口9.2.1接口描述用于对地图中指定的图层进行切割，显示其内部构造。9.2.2属性列表剖切接口属性列表见表9.2.2。表9.2.2剖切接口属性列表名称类型备注viewerviewer当前活动的视图对象9.2.3方法列表剖切接口方法列表见表9.2.3。表9.2.3剖切接口方法列表名称返回类型方法描述createClippingPlane()无创建剖切面updateClippingPlane()无更新剖切面removeClippingPlane()无移除剖切面9.2.4方法详情1createClippingPlane(layer,centerPoint,options).4-1。名称类型描述layerobject执行剖切的图层centerPointcartesian3剖切中心点optionsobject剖切配置对象例：{forward:5.0，afterward:5.0，left:5.0，right:5.0，top:5.0}41返回数据内容：clippingPlaneCollection剖切面集合。示例：1234567892updateClippingPlane(direction,clippingPlaneCollection,distance,angle)参数说明：见表9.2.4-2。表9.2.4-2参数说明名称类型描述directionstringforwardafterwardleft、right、topclippingPlaneCollectionobject剖切面集合distancenumber剖切方向上的距离anglenumber旋转角度返回数据内容：无。42示例：123removeClippingPlane()参数说明：无。返回数据内容：无。示例：19.3地形开挖接口9.3.1接口描述用来在地形表面，开挖出一定范围的区域，显示地形下的场景，如城市管网、地下沟渠，排污通道等地下设施等。9.3.2属性列表地形开挖接口属性列表见表9.3.2。表9.3.2地形开挖接口属性列表名称类型备注viewerviewer当前活动的视图对象9.3.3方法列表地形开挖接口方法列表见表9.3.3。表9.3.3地形开挖接口方法列表名称返回类型方法描述add()无添加地形开挖面remove()无移除开挖面9.3.4方法详情1add(points,height)参数说明：见表9.3.4。43表9.3.4参数说明名称类型描述pointsarray逆时针方向笛卡尔坐标数组heightnumber开挖深度，以米为单位返回数据内容：无。示例：1234567892remove()参数说明：无。返回数据内容：无。示例：14410事件类服务服务描述事件类服务宜按功能提供鼠标事件接口、相机事件接口。10.2鼠标事件接口10.2.1接口描述地图点击事件帮助类，用于管理鼠标在地图上操作相关事件。10.2.2属性列表鼠标