三维模型图层（ModelLayer）

方法

addAxesHelper

添加模型辅助坐标轴，具体用法参考示例。

参数

名称	类型	描述
group	Object3D	必填Object3D 对象。
length	Number	必填坐标轴长度。

addBatchModel

同类模型大批量加载，可在回调函数中操作模型。具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array[Object] 必填点位数据。可添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填点位坐标，[经度,纬度,高度]。 model Object 必填三维模型资源，支持glb、gltf、obj、fbx类型加载。 名称 类型 描述 mtl String 必填材质文件路径，仅模型格式 type 为 "obj" 时生效。 type String 必填模型格式，值为 "gltf"、"glb"、"obj"、"fbx"。 url String 必填模型文件路径。 dracoUrl String 可选解压库文件路径，仅 type 为 "glb" 和 "gltf" 时生效。 opacity Number 1 可选不透明度，范围0-1之间。 scale Number 1 可选模型缩放比例。
callback	Function	可选模型加载完毕执行的回调函数 名称 类型 描述 group Object3D 必填Object3D 对象，包含一些列操作模型的方法。

addBoxHelper

添加模型外包盒，具体用法参考示例。

参数

名称	类型	默认值	描述
group	Object3D		必填Object3D 对象。
color	String	#ff0000	可选模型外包盒颜色。

addCircle

添加动态圆模型，返回模型组对象，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 center Array 必填圆心坐标，[经度,纬度,高度]。 type String 必填圆类型，值分为 "scan" 、 "spread" 、"radar" 和 "ripple" 代表扫描圆，扩散圆，雷达圆和波纹扩散。 color String #FFFFFF 可选颜色值。 isCW Boolean true 可选是否顺时针，仅 type 为 "radar" 时生效。 opacity Number 1 可选不透明度，范围0-1之间。 radius Number 10 可选圆半径,单位米，值为正数。 segment Number 256 可选构成圆的面片数。 speed Number 1 可选圆变化速度，值为正数。 turns Number 8 可选构成圆的条纹数，值为正整数，仅 type 为 "ripple" 时生效。

addDynamicWater

添加水面动态效果，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 baseTexture String 必填基础纹理资源路径。 data String 必填水面几何面数据。 noiseTexture String 必填噪声纹理资源路径。 opacity Number 0.8 可选透明度。 speed Number 0.01 可选水流运动速度。 altitude Number 0 可选海拔高度，单位米。

addFlame

添加火焰效果，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 描述 coordinate Array 必填火焰底部中心放置的位置，形如[经度，纬度，高度]。 size Array 必填火焰大小，可指定x、y、z三轴的大小，单位为米，形如[100,100,100]。 imgUrl String 必填火焰贴图路径。

addFlowLine

添加带有流动纹理的管线模型，返回模型组对象，具体用法参考示例。

参数

• 圆形管线

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Object 必填管道数据。可添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填组成管线的点位坐标，[[经度,纬度,高度],[经度,纬度,高度]]。 type String 必填圆形管口截面类型，值为 "Circle"。 closed Boolean false 可选管线模型是否首尾闭合。 color String #FFFFFF 可选颜色值。 image String undefined 可选纹理路径,要求长度和宽度一致。 opacity Number 1 可选不透明度，范围0-1之间。 radius Number 1 可选圆形管口半径，单位米。 repeatX Number 10 可选沿着管线路径方向重复数。 repeatY Number 1 可选环绕管线方向重复数。 side String FrontSide 可选材质贴图面设置，三种类型， "FrontSide" 前面、 "BackSide" 背面、 "DoubleSide" 双面。 speed Number 1 可选管线纹理流动速度。

• 矩形管线

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Object 必填管道数据。可添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填组成管线的点位坐标，[[经度,纬度,高度],[经度,纬度,高度]]。 rectangle Array 必填矩形管口边长，如 [a,b]，单位米。 type String 必填矩形管口截面类型,值为 "Rectangle"。 color String #FFFFFF 可选颜色值。 image String undefined 可选纹理路径。 opacity Number 1 可选不透明度，范围0-1之间。 repeatX Number 10 可选沿着管线路径方向重复数。 repeatY Number 1 可选环绕管线方向重复数。 side String FrontSide 可选材质贴图面设置，三种类型， "FrontSide" 前面、 "BackSide" 背面、 "DoubleSide" 双面。 speed Number 1 可选管线纹理流动速度。 steps Number 10 可选用于沿拉伸样条曲线深度细分线段的点数，可与 repeatX 属性一起使用。

• 轨迹线

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Object 必填线数据。可添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填组成轨迹线的点位坐标，[[经度,纬度,高度],[经度,纬度,高度]]。 type String 必填轨迹线类型，值为 "trail"。 color String #003CFF 可选颜色值。 opacity Number 1 可选不透明度。 speed Number 3 可选流动速度。 width Number 10 可选线宽。

• 飞线

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Object 必填线数据。可添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填组成飞线的点位坐标，[[经度,纬度,高度],[经度,纬度,高度]]。 type String 必填飞线类型，值为 "flow"。 color String #ffff00 可选颜色值。 gradient Number 0.02 可选背景透明度。 opacity Number 1 可选不透明度。 percent Number 0.08 可选流动部分占比。 speed Number 3 可选流动速度。 width Number 10 可选线宽。

• 动态图案线

  具体用法请参考示例。

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Object 必填线数据。可添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填组成动态图案线的点位坐标，[[经度,纬度,高度],[经度,纬度,高度]]。 image String 必填图片资源路径。 type String 必填动态图案线类型，值为 "image"。 color String #FFFFFF 可选颜色值。 opacity String 1 可选不透明度。 depthTest Boolean true 可选是否开启深度测试，即是否开启遮挡。 speed Number 3 可选流动速度。 width Number 10 可选线宽。 textureFactor Number 6 可选贴图在流动方向上的压缩系数，值越大压缩强度越大，范围 0-10。 towards String screen 可选流动线表达方式，值为 "screen" 始终朝向屏幕，值为 "ground" 时贴地。

addGeoFencing

添加三维地理围栏模型，返回模型组对象，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Object 必填围栏数据。可添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填组成围栏的点位坐标，[[经度,纬度,高度],[经度,纬度,高度]]。 name String 可选围栏名称。 type String 必填三维地理围栏类型，值分为 "diffuse" 、"fade" 和 "outLine"，代表显隐轨迹围栏和轮廓线围栏。 color String #FFFFFF 可选颜色值。 height Number 1 可选围栏高度。 opacity Number 1 可选不透明度，范围0-1之间。 speed Number 3.0 可选围栏变化速度。 imageUrl String 可选贴图路径，仅在 type 为 "outLine" 时生效。 imageColor String rgb(0,255,255) 可选贴图图案的颜色。要求贴图中图案颜色为纯白，背景色为纯黑，仅在 type 为 "outLine" 时生效。 imageSpeed Number 0.0015 可选贴图移动速度，范围 0-1，仅在 type 为 "outLine" 时生效。 gradientColor String rgb(0,255,255) 可选渐变色的颜色，仅在 type 为 "outLine" 时生效。 gradientSpeed Number 0.015 可选渐变色移动速度，仅在 type 为 "outLine" 时生效。

addInstancedModel

同类模型大批量高性能加载，可在回调函数中通过updateInstancedModel和updateInstancedModelById方法更新模型位置、颜色和角度信息。具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array[Object] 必填点位坐标数据。 名称 类型 默认值 描述 coordinate Array[Number] 必填点位坐标，[经度,纬度,高度]。 id String 可选唯一标识符信息。与updateInstancedModelById方法配套使用时，此参数必填。 color String 原模型颜色 可选单个模型的颜色信息，形如"#ffffff"。 rotation Array[Number] [0,0,0] 可选单个模型绕坐标轴的旋转角度，逆时针方向为正，角度取值范围为 [0,360]，X轴正方向为正东，Y轴正方向为垂直地面向上，Z轴正方向为正北。 model Object 必填三维模型资源。 名称 类型 描述 type String 必填模型格式，值为 "gltf"、"glb"。 url String 必填模型文件路径。 dracoUrl String 可选解压库文件路径。 maxCount Number 99999 可选设置可显示的最大模型数量。 opacity Number 1 可选设置模型材质的不透明度，范围0-1。 project String undefined 可选加载的三维模型坐标系。默认以米为单位的坐标系统，加载EPSG:3857坐标系模型时参数设置为"3857"。 rotation Array[Number] [0,0,0] 可选初始模型旋转参数，形如[x,y,z]。 scale Number 1 可选初始模型缩放倍数。
callback	Function	可选模型加载完毕执行的回调函数 名称 类型 描述 group Object3D 必填Object3D 对象，通过updateInstancedModel和updateInstancedModelById方法更新模型位置信息。

addLines

添加三维线，返回模型组对象，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array[Object] 必填线数据。可添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填组成线的点位坐标，[[经度,纬度,高度],[经度,纬度,高度]]。 image String 必填图片资源路径，仅在 type 为 "image" 时生效。 color String #FFFFFF 可选颜色值 。 opacity Number 1 可选不透明度，范围0-1之间。 repeat Object {x: 1, y: 1} 可选图片在x、y方向上的平铺数量，仅在 type 为 "image" 时生效。 type String pipe 可选三维线类型，支持管线（pipe）、实线（solid）、虚线（dash）、图案线（image）类型。 width Number 1/10 可选线宽，当 type 为 "pipe" 时，默认为1，其他类型默认为10。

addMarker

批量添加三维点位标注，需要与options.funcRender一同使用，返回包含标注的dom元素组的对象，可通过remove()方法批量移除，可通过update()方法批量更新位置，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array 必填批量标注数据。 名称 类型 描述 element HTMLElement 必填作为标记的DOM元素。 position Array 必填标注点位坐标，[经度,纬度,高度]。 id String 必填标注层的id，唯一。 avoidance Boolean false 可选是否开启标签避让。

addMarker3D

批量添加三维立体标签，需要引入html2canvas.min.js，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array 必填标签位置、id和朝向的数组。 名称 类型 默认值 描述 coordinate Array 必填标签的坐标，形如：[经度,纬度,高度]。 id String 可选标签的属性信息。 rotationOffset Number 0 可选表示三维标签正面朝向与正北方向在水平方向的夹角，范围为-180~180，以逆时针为正方向。 element HTMLElement 必填自定义dom元素，dom元素分辨率越大标签越清晰。 width Number 必填标签的宽度，单位为米。 height Number 必填标签的宽度，单位为米。 depthTest Boolean true 可选是否启用深度测试。
callback	Function	可选加载完毕执行的回调函数。 名称 类型 描述 group Object3D 必填Object3D 对象，可与renderMarker3D和getMarker3DId接口结合实现三维立体标签始终面向屏幕和获取绑定的属性信息功能。

addModel

可在回调函数中加载以米为单位的模型并操作模型。

参数

名称	类型	默认值	描述
models	Array		必填初始加载的三维模型资源。 名称 类型 描述 model Object 必填单个三维模型资源，支持glb、gltf、obj、fbx类型加载。 名称 类型 描述 mtl String 必填材质文件路径，仅 type 为 "obj" 时生效。 type String 必填模型格式，值为 "gltf"、"glb"、"obj"、"fbx"。 url String 必填模型文件路径。 dracoUrl String 可选解压库文件路径，仅 type 为 "glb" 和 "gltf" 时生效。 ktx2ParseUrl String 可选 KTX 2.0纹理解压库文件路径，仅 type 为 "glb" 和 "gltf" 时生效。具体参考示例加载带KTX 2.0纹理的3D模型。
center	Array	[0, 0, 0]	可选设置三维模型世界原点所在地理空间坐标，坐标系统使用WGS84坐标。如果设置models，则必须设置。例：[lng, lat, height]，如果缺省height，默认为0。
callback	Function		可选模型加载完毕执行的回调函数。 名称 类型 描述 group Object3D 必填Object3D对象，包含一些列操作模型的方法。 layer ModelLayer 必填三维图层实例。

addModelEffect

添加三维模型特效，要求模型为Y轴朝上，具体用法参考示例。

参数

名称	类型	描述
model	Object3D	必填三维模型对象。
options	Array[Object]	必填模型特效数组，效果可叠加。 名称 类型 描述 option1 Object 必填参数 名称 类型 默认值 描述 type String 必填模型渐变类型，自下而上渐变，值为 "gradient"。 endColor String #FFFFFF 可选终止颜色值。 percent Number 0.5 可选渐变刻度，范围0-1之间。 startColor String #040912 可选起始颜色值。 option2 Object 必填参数 名称 类型 默认值 描述 type String 必填模型自身扫光效果类型，自下而上变化，值为 "flow"。 color String #339bf6 可选颜色值。 percent Number 0.01 可选扫光条宽度占模型整体的比例。 speed Number 3.0 可选扫光条移动速度。

addModelMercator

可在回调函数中加载3857坐标系下的模型并操作模型，参数models、center、callback 与上方描述一致。

addParticle

加载粒子，返回模型组对象。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array[Object] 必填点位数据。不支持添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填点位坐标，[经度,纬度,高度]，仅支持CGCS2000坐标。 color String rgb(255,255,255) 可选颜色值。 maxPoints Number 可选最大点数，如需使用 updateParticle 更新点数，请输入最大点数，默认为当前数据的所有点数。 opacity Number 1.0 可选不透明度，范围0-1之间。 size Number 1 可选粒子大小。

addPoints

批量添加三维点位模型，返回模型组对象，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array[Object] 必填点位数据。可添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填点位坐标，[经度,纬度,高度]。 type String 必填模型格式，值为 "cube" 立方体和 "sphere" 圆球。 color String/Number #FFFFFF 可选颜色值，颜色值接受字符串或者十六进制表示。 opacity Number 1 可选不透明度，范围0-1之间。 size Number 1 可选尺寸大小，单位米，分别代表棱长和半径。

addPolygons

添加三维面，返回模型组对象，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array[Object] 必填面数据。可添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填组成面的点位坐标，[[经度,纬度,高度],[经度,纬度,高度]]。 color String/Number #FFFFFF 可选颜色值，颜色值接受字符串或者十六进制表示。 opacity Number 1 可选不透明度，范围0-1之间。 side String FrontSide 可选材质贴图面设置，三种类型， "FrontSide" 前面、 "BackSide" 背面、 "DoubleSide" 双面。

addPolygonByLine

添加立体平面，返回模型组对象，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array 必填组成线的点位坐标，[[经度,纬度,高度],[经度,纬度,高度]]。 height Number 必填平面拉升高度。 color String/Number #FFFFFF 可选颜色值，颜色值接受字符串或者十六进制表示。 image String 可选纹理路径。 opacity Number 1 可选不透明度，范围0-1之间。

addPyramid

添加椎体模型，返回模型组对象，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 basePoints Array 必填棱锥底面数据，组成底面的点位坐标，[[经度,纬度,高度],[经度,纬度,高度]]，点位按照顺时针顺序。 topColor Array[String/Number] 必填棱锥侧面颜色数组，颜色值接受字符串或者十六进制表示，如 ["#FFFF00", "#00FF00"] ，表示从顶部到底部的颜色渐变，最多只接受两种颜色。 topPoint Array 必填棱锥顶点数据，[经度,纬度,高度]。 baseColor String/Number 可选棱锥底面颜色值，颜色值接受字符串或者十六进制表示，如 "#FFFFFF" 或者 0xFFFFFF，不设置时默认底部透明不可见。 opacity Number 1 可选不透明度，范围0-1之间。 side String FrontSide 可选材质贴图面设置，三种类型， "FrontSide" 前面、 "BackSide" 背面、 "DoubleSide" 双面。

addSphere

添加特效球模型，返回模型对象，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 center Array 必填球心坐标，[经度,纬度,高度]。 color String #ff0000 可选颜色值。 hSegment Number 16 可选构成球的垂直段的数量，最小值为2。 opacity Number 1 可选不透明度，范围0-1之间。 phiLength Number 360° 可选指定水平扫描角度大小。 phiStart Number 0 可选指定水平起始角度。 radius Number 10 可选球半径,单位米。 speed Number 3 可选球表面效果变化速度。 thetaLength Number 180° 可选指定垂直扫描角度大小。 thetaStart Number 0 可选指定垂直起始角度。 wSegment Number 32 可选构成球的水平段的数量，最小值为3。

addTextMarker

添加文字标签，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array 必填文本标签的数据参数。 名称 类型 默认值 描述 coordinate Array 必填文字标签的位置坐标，形如：[经度,纬度,高度]。 text String 必填文字标签的文本内容。 angle Array [0, 0, 0] 可选文字标签的旋转角度，分别绕X、Y、Z轴旋转，以顺时针方向旋转为正，在场景中，X轴正方向为正东，Y轴正方向为正南，Z轴正方向为垂直地面向上。 color String #000000 可选文本内容字体的颜色。 fontFamily String sans-serif 可选文本内容字体的类型，支持CSS字体类型名。 fontSize Number 10 可选文本内容字体的大小。 letterSpacing Number 0 可选文本内容字体之间的间距。 type String horizontal 可选文字标签的方向，取值为"horizontal"和"vertical"分别表示横向和纵向。

addTrackLines

添加人流轨迹线，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array 必填构成轨迹线的坐标数据。每条轨迹线由一个坐标点构成为圆点，由两个坐标点构成为线段，由三个以上坐标点构成为线段或曲线。具体数据格式见下方。 range Array 必填轨迹线显示区域范围，形如[ [经度,纬度],[经度,纬度],.....]。 height Number 0 可选轨迹线显示平面的高度，单位为米。 resolution Number 1024 可选画布宽度分辨率，越大轨迹线越清晰。 trackWidth Number 6 可选轨迹线的宽度，与resolution有关，分辨率越大，显示的线宽越小。 trackColor String #63E8FF 可选轨迹线的颜色。
callback	Function	可选轨迹线加载完毕执行的回调函数。 名称 类型 描述 updateTrackLines Function 可选更新轨迹线方法，参数为data，描述与上述data一致。

// 由一个坐标点构成的轨迹线数据
let data1 = [
    [
        [120, 30]
    ],
    [
        [120, 31]
    ],
    ......
]

// 由两个坐标点构成的轨迹线数据
let data2 = [
    [
        [120, 30],
        [120, 31]
    ],
    [
        [121, 31],
        [121, 30]
    ],
    ......
]

// 由三个即以上的坐标点构成的轨迹线数据
let data3 = [
    [
        [120, 30],
        [120, 31]，
        [120, 32],
        ......
    ],
    [
        [121, 31],
        [121, 30],
        [121, 32],
        ......
    ],
    ......
]

changeModelTexture

修改自动化批量构建的三维模型纹理，修改之前需要对纹理规则进行设置，通过上述setTextureRules(options)实现，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 描述 data Object 必填设置纹理名称和对应的模型编号数据，以键值对的形式表示。 名称 类型 描述 key String 必填设置纹理名称，对应 setTextureRules(options) 接口中 textureData 的 "key" 参数值。 value Array 必填设置需要改变纹理的模型编号数组，以数组形式表示如[0,10,100]，表示标号为第0个、第10个和第100的模型，纹理修改为 key 对应的纹理分割块。 model Group/Mesh 必填需要操作的模型对象。

exportModel

导出三维模型，具体用法参考示例。

参数

名称	类型	描述
model	Group	必填模型对象中对应 glb 文件的组织结构，每次可以导出单个模型。

fadeModels

实现模型上下浮现动画。

参数

名称	类型	描述
duartion	Number	必填模型动画持续时间，单位毫秒。
from	Object	必填模型运动初始状态。 名称 类型 描述 height Number 必填模型运动初始高度。 opacity Number 必填模型运动初始透明度。
models	Object3D	必填单个模型或者是模型组。
to	Object	必填模型运动结束状态。 名称 类型 描述 height Number 必填模型运动结束高度。 opacity Number 必填模型运动结束透明度。

getInstancedModelId

根据屏幕坐标选取实例化模型，返回值为实例化模型所绑定的id属性信息，具体用法参考示例。

参数

名称	类型	描述
point	Object	必填屏幕坐标，如 {x: 1152, y: 643} 。
object	Object3D	必填addInstancedModel接口callback返回的模型对象。

getIntersectCoordinate

模型表面坐标拾取，返回值为[经度,纬度,高度]数组，具体用法参考示例。

参数

名称	类型	描述
data	Object	必填是 layer.selectModel(point) 返回结果数组的子项，如 layer.selectModel(point)[0]。

getMarker3DId

根据屏幕坐标获取三维立体标签的id属性，具体用法参考示例。

参数

名称	类型	描述
point	Object	必填屏幕坐标，形如 {x: 1152, y: 643}。
groups	Object/Array[Object]	必填addMarker3D接口回调函数中返回的group，或是包含多个group的数组。

getModelCenter

获取模型或者模型组的几何中心坐标,返回值为[经度,纬度,高度]数组，具体用法参考示例。

参数

名称	类型	描述
object	Object3D	必填模型或者模型组对象。

highlightMergeBatchModel

基于鼠标点击模型拾取结果实现对自动化批量构建的三维模型的高效拾取、高亮显示，返回拾取模型的编号属性，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 intersect Object 必填拾取模型信息，是 layer.selectModel(point) 返回结果数组的子项，如 layer.selectModel(point)[0] 。 name String 必填模型的name属性包含值，用于识别模型。 texture String 必填模型高亮显示的纹理贴图路径。 color String rgb(231,201,122) 可选模型高亮的颜色。 faceCount Number 2 可选每个模型三角面数量。

onAfterRender

监听已加载模型的首次渲染完成事件。具体用法参考示例。

参数

名称	类型	描述
group	Object3D	必填需要监听的模型对象或者模型组。
isAll	Boolean	可选表示是否监听整个 group ，该参数缺失或者为 false 时表示只监听当前屏幕范围内 group 部分。

outlineModel

模型轮廓高亮，同一图层高亮效果存在互斥，具体用法参考示例。

参数

名称	类型	描述
objects	Object3D	必填模型对象或者模型组。
options	Object	可选参数 名称 类型 默认值 描述 scope String default 可选模型高亮范围，可选值为："layer"：整个modelLayer，"model"：模型文件，比如glb，"default"：传入的object本身。 edgeStrength Number 3.0 可选轮廓强度系数。 edgeGlow Number 0.0 可选轮廓发光系数。 edgeColor Number #ffff00 可选轮廓颜色。 enableFillColor Boolean true 可选轮廓内部是否填充颜色。 fillColorOpacity Number 0.2 可选轮廓内部填充颜色不透明度。

recoveryModelTexture

恢复自动化批量构建的三维模型纹理。

参数

名称	类型	描述
model	Group/Mesh	必填需要操作的模型对象，来自上述 changeModelTexture(options) 接口中的 model 值。

removeModel

可在回调函数中移除已加载的模型。

参数

名称	类型	描述
group	Object3D	必填需要移除的模型。

removeModelByAttribute

根据模型设定的某个属性，移除场景中已加载的单个模型，具体用法参考示例。

参数

名称	类型	描述
key	String	必填数据中的关键属性名称。
value	String	必填需要移除模型的关键属性名称对应的值。

removeModelEffect

移除三维模型特效，具体用法参考示例。

renderMarker3D

实时渲染三维立体标签，使其始终面向屏幕，具体用法参考示例。

参数

名称	类型	描述
groups	Object/Array[Object]	必填addMarker3D接口回调函数中返回的group，或是包含多个group的数组。

selectModel

根据屏幕坐标选取模型，返回值为可选取的模型信息数组。

参数

名称	类型	描述
point	Object	必填屏幕坐标，如 {x: 1152, y: 643} 。
object	Object/Array[Object]	可选指定拾取的范围，可以是模型对象或者模型组，未指定参数时默认场景中所有的模型。

setRenderPassSync

设置渲染队列同步参数是否开启。

参数

名称	类型	描述
renderPassSync	Boolean	必填适用于加载显示地下三维模型，开启该参数后，不透明材质模型将先于半透明地表渲染，从而达到正确的三维空间效果，但该模式下渲染性能将受到一定影响。

setTextureRules

设置自动化批量构建的三维模型纹理规则，具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 描述 faceCount Number 必填每个模型三角面数量。 model Scene/Mesh 必填绑定操作的模型对象,如果是 Scene 类型时，其children中必须只含有一个 Mesh。 size Array 必填贴图纹理均匀分割的行列号数量，以数组形式表示，如[3,3]，表示该纹理图片具有3行3列的分割。 textureData Object 必填设置纹理名称和对应的纹理坐标，以键值对的形式表示。 名称 类型 描述 key String 必填设置纹理名称。 value Array 必填设置纹理坐标，以二维数组形式表示，自左向右，自上而下，如[0,0]，表示第一行第一列的纹理分割块。 textureUrl String 必填纹理贴图路径。其纹理存放规则必须为均匀分割的图片资源，其左上角的分割块必须为对应模型自身的纹理。

unhighlightMergeBatchModel

移除自动化批量构建模型的高亮显示。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 描述 name String 必填模型的name属性包含值，用于识别模型。 object Object 可选移除高亮效果的模型层级所在范围，可用于快速定位所在的层级，未设置则在全场景中查找。

unOutlineModel

取消模型轮廓高亮，具体用法参考示例。

updateInstancedModel

大批量模型整体更新，更新之前会对整体效果进行清除，适用于大批量散点数据快速更新与展示。该接口与addInstancedModel配套使用。具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array[Object] 必填点位坐标数据。 名称 类型 默认值 描述 coordinate Array[Number] 必填点位坐标，[经度,纬度,高度]。 id String 可选唯一标识符信息。 color String 原模型颜色 可选单个模型的颜色信息，形如"#ffffff"。 rotation Array[Number] [0,0,0] 可选单个模型绕坐标轴的旋转角度，逆时针方向为正，角度取值范围为 [0,360]，X轴正方向为正东，Y轴正方向为垂直地面向上，Z轴正方向为正北。 model Object3D 必填addInstancedModel接口callback返回的模型对象。 scale Number 1 可选模型缩放倍数。

updateInstancedModelById

根据Id更改单个模型的属性信息，包括位置、颜色和角度。适用于模型单体化操作，支持模型颜色复原。该接口可与addInstancedModel配套使用。具体用法参考示例。

参数

名称	类型	描述
options	Object	必填参数 名称 类型 默认值 描述 data Array[Object] 必填点位坐标数据。 名称 类型 描述 id String 必填唯一标识符信息，为addInstancedModel接口中相应的id。 coordinate Array[Number] 必填点位坐标，[经度,纬度,高度]。 color String/null 可选单个模型的颜色信息，形如"#ffffff"或null，当参数为null时，颜色为模型原始颜色。 rotation Array[Number] 可选单个模型绕坐标轴的旋转角度，逆时针方向为正，角度取值范围为 [0,360]，X轴正方向为正东，Y轴正方向为垂直地面向上，Z轴正方向为正北。 scale Number 可选模型缩放倍数。 model Object3D 必填addInstancedModel接口callback返回的模型对象。 clearColor Boolean true 可选是否清除已设置的模型颜色。

updateParticle

更新粒子，可更新粒子坐标、大小、透明度和颜色，具体用法参考示例。

参数

名称	类型	描述
group	Object3D	必填 addParticle 的返回值。
options	Object	必填参数 名称 类型 默认值 描述 data Array[Object] 必填点位数据。不支持添加自定义属性。 名称 类型 描述 coordinate Array[Number] 必填点位坐标，[经度,纬度,高度]。 color String rgb(255,255,255) 可选颜色值。 opacity Number 1.0 可选不透明度，范围0-1之间。 size Number 1 可选粒子大小。