MapGIS数字孪生平台：添加实例化模型

前言

在三维数字孪生场景中，批量添加同类型模型（如树、车辆、建筑等）时，采用“实例化模型”技术可以极大提升渲染效率和内存利用率。本文介绍如何在 MapGIS 数字孪生平台中实现实例化模型的添加与管理。

主要流程

初始化场景

首先需通过 MapGISScene 类初始化三维场景，并完成基础配置（如 token、容器等）。
示例代码：

const zdScene = new MapGISCloudRender.MapGISScene(cloudRenderBaseUrl, 'container', { token: cloudRenderServiceToken });
zdScene.loadScene().then(() => {
  // 场景加载完成后的操作
});

构建实例化模型参数

实例化模型的核心是通过 MapGISInstanceModel 类，将同一模型的多份实例以最优方式批量添加。主要参数包括：

• symbol：模型符号名。
• positions：实例化模型的位置数组，每个元素为 Cartesian3 坐标。
• scales（可选）：每个实例的缩放比例。
• rotations（可选）：每个实例的旋转角度。

示例代码片段：

const positions = [
  new MapGISCloudRender.Cartesian3(114.391, 31.098, 550),
  new MapGISCloudRender.Cartesian3(114.392, 31.099, 550),
  // ...更多坐标
];
const instanceModel = new MapGISCloudRender.MapGISInstanceModel('22Trees35', positions);

添加实例化模型到场景

通过 addCovering 方法将实例化模型对象添加到场景中：

zdScene.addCovering(instanceModel);

动态增删实例

实例化模型支持动态增删实例点位。可通过相关方法（如 addInstance、removeInstance）实现对实例的管理。
例如，添加新实例：

instanceModel.addInstance(new MapGISCloudRender.Cartesian3(114.393, 31.100, 550));

常见问题

• 符号资源：确保所用 symbol 名称在平台资源库中存在，否则模型无法正常显示。
• 性能优势：实例化模型适合大批量同类对象的场景，能显著提升渲染效率。
• 属性控制：可为每个实例单独设置缩放、旋转等属性，满足多样化展示需求。