前言

本文简要介绍如何在 MapGIS 数字孪生平台中集成和使用声呐扫描（Sonar Detection）特效接口，帮助开发者快速实现三维场景下的声呐探测可视化效果。

主要流程

1. 引入 MapGIS CloudRender API 及相关资源。
2. 初始化场景，设置基础地图、地形和相机视角。
3. 创建并添加声呐探测特效对象。
4. 可选：加载飞机模型等其他覆盖物。

关键代码示例

// 1. 初始化场景
const scene = new MapGISCloudRender.MapGISScene(cloudRenderBaseUrl, 'container', { token: cloudRenderServiceToken });
scene.loadScene().then(() => {
  // 2. 添加底图、地形、相机视角
  scene.addCovering(addTdt('img'));
  addTerrainLayer();
  scene.camera.flyTo(114.3914213470, 31.098175337284736, 1000, { az: 320, pitch: -45 });
  // 3. 添加声呐探测
  addSonarDetection();
});

// 4. 声呐探测效果
function addSonarDetection() {
  const position = new MapGISCloudRender.Cartesian3(114.3914213470, 31.098175337284736, 550);
  const sonar = new MapGISCloudRender.MapGISSonarDetection(position, {
    deep: 50,           // 探测深度
    fieldAngle: 40.0,   // 探测角度
    speedFactor: 8.0,   // 探测速度
    numCircle: 6        // 探测圈数
  });
  scene.addCovering(sonar);
}

接口参数说明

new MapGISCloudRender.MapGISSonarDetection(position, options)

• position (Cartesian3)：声呐探测中心位置（经纬度+高程）。
• options (Object)：可选参数对象，常用参数如下：