@kq_npm/client3d_webgl_vue 4.5.56 → 4.5.57

package/airspacegridoccupancyquery/index.js

@@ -1062,11 +1062,21 @@ var _message = _interopRequireDefault(__webpack_require__(71323));
 var _loading = _interopRequireDefault(__webpack_require__(90724));
 var _useGlobalConfig = __webpack_require__(22686);
 class AirspaceGridOccupancyQueryViewModel {
+  // 全屏加载实例
+
+  /** @description 构造函数，初始化视图模型
+   * @param {Object} scenceView 场景视图对象，包含 _viewer、_drawManager 等
+   * @param {Object} options 用户传入的查询参数
+   */
   constructor(scenceView, options) {
     this._viewer = null;
+    // Cesium 场景视图实例
     this._mapTarget = null;
+    // 地图容器 DOM id
     this._options = {};
+    // 当前生效的查询参数
     this._defaultOptions = {
+      // 默认查询参数
       queryUrl: "",
       calcLevel: 23,
       heightType: "trueHeight",
@@ -1076,10 +1086,15 @@ class AirspaceGridOccupancyQueryViewModel {
       merge: true
     };
     this._drawManager = null;
+    // 绘制管理器，负责矩形绘制交互
     this._language = null;
+    // 多语言资源对象
     this._htmlTag = null;
+    // HTML 标签对象（保留字段）
     this._clickGirdPrimitive = null;
+    // 点击拾取的网格图元（保留字段）
     this._queryGrids = [];
+    // 已添加到场景中的查询网格图元集合
     this._loading = null;
     const {
       locale
@@ -1093,9 +1108,12 @@ class AirspaceGridOccupancyQueryViewModel {
     this._viewer.postProcessStages.fxaa.enabled = true;
     this._viewer.scene.logarithmicDepthBuffer = true;
   }
+
+  // 启动查询：校验参数后启动矩形绘制交互（无参数）
   start() {
     const that = this;
     const queryUrl = this._options.queryUrl || "";
+    // 校验查询服务地址是否配置
     if (!queryUrl.trim()) {
       (0, _message.default)({
         message: that._language.value.webgl["gridOccupancyQueryUrlEmpty"] || "请配置查询服务地址",
@@ -1105,6 +1123,7 @@ class AirspaceGridOccupancyQueryViewModel {
     }
     const startH = Number(this._options.startHeight);
     const endH = Number(this._options.endHeight);
+    // 校验起始高度不能大于结束高度
     if (!isNaN(startH) && !isNaN(endH) && startH > endH) {
       (0, _message.default)({
         message: that._language.value.webgl["airspaceGridOccupancyQueryHeightError"] || "起始高度不能大于结束高度",
@@ -1114,6 +1133,7 @@ class AirspaceGridOccupancyQueryViewModel {
     }
     this.removeData();
     if (!this._drawManager) return;
+    // 启动矩形绘制，绘制完成后回调中执行查询
     this._drawManager.startDraw("rectangle", {
       fill: true,
       clampToGround: false
@@ -1125,6 +1145,10 @@ class AirspaceGridOccupancyQueryViewModel {
       that._drawManager.clearDrawGroup("AirspaceGridOccupancyQueryDraw");
     }, "AirspaceGridOccupancyQueryDraw");
   }
+
+  /** @description 根据绘制的矩形区域执行空域网格占用查询并绘制结果
+   * @param {Object} shape 绘制得到的矩形几何对象
+   */
   showAirspaceGridOccupancyQuery(shape) {
     this.removeData();
     const that = this;
@@ -1134,6 +1158,8 @@ class AirspaceGridOccupancyQueryViewModel {
     const endHeight = this._options.endHeight || 100;
     const buffer = this._options.buffer || 0;
     const merge = this._options.merge !== undefined ? this._options.merge : true;
+
+    // 将矩形弧度边界转为角度经纬度
     const minLon = shape.rectangle.west / Math.PI * 180;
     const maxLon = shape.rectangle.east / Math.PI * 180;
     const minLat = shape.rectangle.south / Math.PI * 180;
@@ -1143,6 +1169,8 @@ class AirspaceGridOccupancyQueryViewModel {
     // 客户端计算矩形范围内的三维网格编码列表，用作轮廓打底
     const codeList = Module.calcGeoSotGBCode3DListOfRectZ(minLon, minLat, startHeight, maxLon, maxLat, endHeight, level - 1);
     this.drawGridsOutlineFromCodeList(codeList, Cesium.Color.GREEN.withAlpha(0.3));
+
+    // 构造查询请求体
     const body = {
       geom: {
         type: "FeatureCollection",
@@ -1161,6 +1189,8 @@ class AirspaceGridOccupancyQueryViewModel {
       merge: merge
     };
     this._showLoading();
+
+    // 请求服务端获取占用网格并绘制
     fetch(queryUrl + "/airspaceOccupyRegion", {
       method: "POST",
       headers: {
@@ -1197,6 +1227,11 @@ class AirspaceGridOccupancyQueryViewModel {
       });
     });
   }
+
+  /** @description 根据网格编码列表绘制实心网格图元
+   * @param {Array} codeList 网格编码数组
+   * @param {Cesium.Color} color 网格填充颜色
+   */
   drawGridsFromCodeList(codeList, color) {
     let instances = [];
     for (let i = 0; i < codeList.length; i++) {
@@ -1204,6 +1239,7 @@ class AirspaceGridOccupancyQueryViewModel {
       const index = (code.length + 1) / 2;
       const grid = Module.decodeGeoSotGBCodeToBox(code.substring(0, index), code.substring(index));
       if (grid) {
+        // 限制经纬度边界到合法范围
         if (grid.minx < -180) grid.minx = -180;
         if (grid.maxx > 180) grid.maxx = 180;
         if (grid.miny < -90) grid.miny = -90;
@@ -1225,6 +1261,8 @@ class AirspaceGridOccupancyQueryViewModel {
         }));
       }
     }
+
+    // 存在几何实例时创建 Primitive 添加到场景
     if (instances.length > 0) {
       const primitive = this._viewer.scene.primitives.add(new Cesium.Primitive({
         geometryInstances: instances,
@@ -1251,6 +1289,11 @@ class AirspaceGridOccupancyQueryViewModel {
       this._queryGrids.push(primitive);
     }
   }
+
+  /** @description 根据网格编码列表绘制网格轮廓线
+   * @param {Array} codeList 网格编码数组（可能是数组或类 Map 结构）
+   * @param {Cesium.Color} color 轮廓颜色
+   */
   drawGridsOutlineFromCodeList(codeList, color) {
     const outlineColor = Cesium.ColorGeometryInstanceAttribute.fromColor(color);
     const instances = [];
@@ -1258,6 +1301,7 @@ class AirspaceGridOccupancyQueryViewModel {
     for (let i = 0; i < size; i++) {
       const code = codeList.get ? codeList.get(i) : codeList[i];
       const index = (code.length + 1) / 2;
+      // 优先使用 3D 编码解码方法，兼容旧版二维解码
       const grid = Module.decodeGeoSotGBCode3DToBox ? Module.decodeGeoSotGBCode3DToBox(code) : Module.decodeGeoSotGBCodeToBox(code.substring(0, index), code.substring(index));
       if (grid) {
         if (grid.minx < -180) grid.minx = -180;
@@ -1284,6 +1328,8 @@ class AirspaceGridOccupancyQueryViewModel {
         }));
       }
     }
+
+    // 存在几何实例时创建轮廓 Primitive 添加到场景
     if (instances.length > 0) {
       const primitive = this._viewer.scene.primitives.add(new Cesium.Primitive({
         geometryInstances: instances,
@@ -1299,6 +1345,8 @@ class AirspaceGridOccupancyQueryViewModel {
       this._queryGrids.push(primitive);
     }
   }
+
+  // 显示全屏加载动画（无参数）
   _showLoading() {
     this._loading = _loading.default.service({
       lock: true,
@@ -1307,27 +1355,51 @@ class AirspaceGridOccupancyQueryViewModel {
       target: this._mapTarget ? document.getElementById(this._mapTarget) : null
     });
   }
+
+  // 关闭全屏加载动画（无参数）
   _hideLoading() {
     if (this._loading) {
       this._loading.close();
       this._loading = null;
     }
   }
+
+  /** @description 设置查询服务地址
+   * @param {String} val 查询服务地址
+   */
   setQueryUrl(val) {
     this._options.queryUrl = val;
   }
+
+  /** @description 设置计算层级
+   * @param {Number} val 计算层级
+   */
   setCalcLevel(val) {
     this._options.calcLevel = Number(val);
   }
+
+  /** @description 设置高度类型
+   * @param {String} val 高度类型
+   */
   setHeightType(val) {
     this._options.heightType = val;
   }
+
+  /** @description 设置起始高度
+   * @param {Number} val 起始高度
+   */
   setStartHeight(val) {
     this._options.startHeight = Number(val);
   }
+
+  /** @description 设置结束高度
+   * @param {Number} val 结束高度
+   */
   setEndHeight(val) {
     this._options.endHeight = Number(val);
   }
+
+  // 移除已添加的 HTML 标签与查询网格图元（无参数）
   removeData() {
     if (this._htmlTag) {
       this._htmlTag.destroy();
@@ -1340,12 +1412,16 @@ class AirspaceGridOccupancyQueryViewModel {
       this._queryGrids = [];
     }
   }
+
+  // 清除查询结果、关闭加载并停止绘制（无参数）
   clear() {
     this.removeData();
     this._hideLoading();
     this._drawManager?.stopDraw();
     this._drawManager?.clearDrawGroup("AirspaceGridOccupancyQueryDraw");
   }
+
+  // 销毁视图模型，释放所有资源（无参数）
   destroy() {
     this.clear();
   }
@@ -1412,6 +1488,8 @@ const _hoisted_1 = {
 const _hoisted_2 = {
   class: "kq3d-airspace-grid-occupancy-query-footer"
 };
+// 组件属性定义
+
 const __default__ = {
   name: "Kq3dAirspaceGridOccupancyQuery"
 };
@@ -1459,6 +1537,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     const {
       settingParams = {}
     } = props || {};
+    // 表单参数响应式状态，保存用户输入的查询参数
     let formItem = (0, _vue.reactive)({
       collapseValue: settingParams.collapseValue === "" ? "" : settingParams.collapseValue ?? "setting",
       queryUrl: settingParams.queryUrl ?? "",
@@ -1467,34 +1546,47 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       startHeight: settingParams.startHeight ?? 0,
       endHeight: settingParams.endHeight ?? 100
     });
-    let viewModel = null;
-    let boxRef = (0, _vue.ref)(null);
-    let headerTemp = (0, _vue.ref)();
-    let headerTempRef = (0, _vue.ref)();
+    let viewModel = null; // 视图模型实例，承担核心业务逻辑
+    let boxRef = (0, _vue.ref)(null); // 组件根容器引用
+    let headerTemp = (0, _vue.ref)(); // 头部模板动态组件
+    let headerTempRef = (0, _vue.ref)(); // 头部模板组件实例引用
+
+    // 组件挂载后初始化定位、监听与视图模型
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
+      // 监听位置变化，实时更新组件位置
       (0, _vue.watch)(() => props.position, (newVal, oldVal) => {
         (0, _util.updatePosition)(boxRef.value, props);
       });
       watchCreateHeaderTemp();
+      // 监听是否显示头部模板，变化时重建头部模板
       (0, _vue.watch)(() => props.showHeaderTemp, (newVal, oldVal) => {
         (0, _vue.nextTick)(() => {
           watchCreateHeaderTemp();
         });
       });
+
+      // 获取地图场景视图后实例化视图模型
       _gisUtils.utils.getWebMap(props.mapTarget, scenceView => {
         if (scenceView) {
           viewModel = new _AirspaceGridOccupancyQueryViewModel.default(scenceView, formItem);
         }
       });
     });
+
+    // 根据属性创建头部模板（无参数）
     const watchCreateHeaderTemp = () => {
       if (props.showHeaderTemp) {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.airspaceGridOccupancyQuery");
       }
     };
+
+    /** @description 参数变更处理，根据变更的字段同步到视图模型
+     * @param {String} key 变更的参数字段名
+     */
     function paramsChanged(key) {
       if (!viewModel) return;
+      // 高度参数变更时校验起始高度不能大于结束高度
       if (key === "startHeight" || key === "endHeight") {
         const startH = Number(formItem.startHeight);
         const endH = Number(formItem.endHeight);
@@ -1506,6 +1598,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           return;
         }
       }
+      // 根据字段名调用对应 setter 同步参数到视图模型
       switch (key) {
         case "queryUrl":
           viewModel.setQueryUrl(formItem.queryUrl);
@@ -1526,9 +1619,12 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           break;
       }
     }
+
+    // 执行空域网格占用查询（无参数）
     function query() {
       let startH = Number(formItem.startHeight);
       let endH = Number(formItem.endHeight);
+      // 高度值必须为数字
       if (isNaN(startH) || isNaN(endH)) {
         (0, _message.default)({
           message: locale.value.webgl["airspaceGridOccupancyQueryHeightError"] || "高度值必须为数字",
@@ -1536,6 +1632,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         });
         return;
       }
+      // 起始高度不能大于结束高度
       if (startH > endH) {
         (0, _message.default)({
           message: locale.value.webgl["airspaceGridOccupancyQueryHeightError"] || "起始高度不能大于结束高度",
@@ -1545,9 +1642,13 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
       viewModel && viewModel.start();
     }
+
+    // 清除查询结果（无参数）
     function clearResult() {
       viewModel && viewModel.clear();
     }
+
+    // 组件卸载前销毁视图模型释放资源
     (0, _vue.onBeforeUnmount)(() => {
       viewModel && viewModel.destroy();
     });
@@ -1758,11 +1859,11 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.kq_npm_client_leaflet_vue = exports.kq_npm_client_common_vue = exports.kq_npm_client3d_webgl_vue = void 0;
-let kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
+const kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
 __webpack_require__.g.kq_npm_client_common_vue = kq_npm_client_common_vue;
-let kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
+const kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
 __webpack_require__.g.kq_npm_client_leaflet_vue = kq_npm_client_leaflet_vue;
-let kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
+const kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
 __webpack_require__.g.kq_npm_client3d_webgl_vue = kq_npm_client3d_webgl_vue;
 
 /***/ })

package/airspaceprofileanalysis/index.js

@@ -919,6 +919,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     const {
       settingParams = {}
     } = props || {};
+    // 表单参数响应式状态，保存用户输入的分析参数
     let formItem = (0, _vue.reactive)({
       collapseValue: settingParams.collapseValue === "" ? "" : settingParams.collapseValue ?? "setting",
       queryUrl: settingParams.queryUrl ?? "",
@@ -926,21 +927,27 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       heightType: settingParams.heightType ?? "trueHeight",
       height: settingParams.height ?? 120
     });
-    let viewModel = null;
-    let boxRef = (0, _vue.ref)(null);
-    let headerTemp = (0, _vue.ref)();
-    let headerTempRef = (0, _vue.ref)();
+    let viewModel = null; // 视图模型实例，承担核心业务逻辑
+    let boxRef = (0, _vue.ref)(null); // 组件根容器引用
+    let headerTemp = (0, _vue.ref)(); // 头部模板动态组件
+    let headerTempRef = (0, _vue.ref)(); // 头部模板组件实例引用
+
+    // 组件挂载后初始化定位、监听与视图模型
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
+      // 监听位置变化，实时更新组件位置
       (0, _vue.watch)(() => props.position, (newVal, oldVal) => {
         (0, _util.updatePosition)(boxRef.value, props);
       });
       watchCreateHeaderTemp();
+      // 监听是否显示头部模板，变化时重建头部模板
       (0, _vue.watch)(() => props.showHeaderTemp, (newVal, oldVal) => {
         (0, _vue.nextTick)(() => {
           watchCreateHeaderTemp();
         });
       });
+
+      // 获取地图场景视图后实例化视图模型
       _gisUtils.utils.getWebMap(props.mapTarget, scenceView => {
         if (scenceView) {
           let options = {
@@ -953,13 +960,20 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         }
       });
     });
+
+    // 根据属性创建头部模板（无参数）
     const watchCreateHeaderTemp = () => {
       if (props.showHeaderTemp) {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.airspaceProfileAnalysis");
       }
     };
+
+    /** @description 参数变更处理，根据变更的字段同步到视图模型
+     * @param {String} key 变更的参数字段名
+     */
     function paramsChanged(key) {
       if (!viewModel) return;
+      // 根据字段名调用对应 setter 同步参数到视图模型
       switch (key) {
         case "queryUrl":
           viewModel.setQueryUrl(formItem.queryUrl);
@@ -977,8 +991,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           break;
       }
     }
+
+    // 执行空域剖面分析（无参数）
     function query() {
       let heightVal = Number(formItem.height);
+      // 校验高度值必须为有效正数
       if (isNaN(heightVal) || heightVal <= 0) {
         (0, _message.default)({
           message: "请输入有效的高度值",
@@ -988,9 +1005,13 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
       viewModel && viewModel.start();
     }
+
+    // 清除分析结果（无参数）
     function clearResult() {
       viewModel && viewModel.clear();
     }
+
+    // 组件卸载前销毁视图模型释放资源
     (0, _vue.onBeforeUnmount)(() => {
       viewModel && viewModel.destroy();
     });
@@ -1373,20 +1394,34 @@ var _message = _interopRequireDefault(__webpack_require__(71323));
 var _loading = _interopRequireDefault(__webpack_require__(90724));
 var _useGlobalConfig = __webpack_require__(22686);
 class AirspaceProfileAnalysisViewModel {
+  // 全屏加载实例
+
+  /** @description 构造函数，初始化视图模型
+   * @param {Object} scenceView 场景视图对象，包含 _viewer、_drawManager 等
+   * @param {Object} options 用户传入的分析参数
+   */
   constructor(scenceView, options) {
     this._viewer = null;
+    // Cesium 场景视图实例
     this._mapTarget = null;
+    // 地图容器 DOM id
     this._options = {};
+    // 当前生效的分析参数
     this._defaultOptions = {
+      // 默认分析参数
       queryUrl: "",
       calcLevel: 23,
       heightType: "trueHeight",
       height: 120
     };
     this._drawManager = null;
+    // 绘制管理器，负责矩形绘制交互
     this._language = null;
+    // 多语言资源对象
     this._htmlTag = null;
+    // HTML 标签对象（保留字段）
     this._queryGrids = [];
+    // 已添加到场景中的网格图元集合
     this._loading = null;
     const {
       locale
@@ -1400,9 +1435,12 @@ class AirspaceProfileAnalysisViewModel {
     this._viewer.postProcessStages.fxaa.enabled = true;
     this._viewer.scene.logarithmicDepthBuffer = true;
   }
+
+  // 启动分析：校验参数后启动矩形绘制交互（无参数）
   start() {
     const that = this;
     const queryUrl = this._options.queryUrl || "";
+    // 校验查询服务地址是否配置
     if (!queryUrl.trim()) {
       (0, _message.default)({
         message: that._language.value.webgl["gridOccupancyQueryUrlEmpty"] || "请配置查询服务地址",
@@ -1412,6 +1450,7 @@ class AirspaceProfileAnalysisViewModel {
     }
     this.removeData();
     if (!this._drawManager) return;
+    // 启动矩形绘制，绘制完成后回调中执行分析
     this._drawManager.startDraw("rectangle", {
       fill: true,
       clampToGround: false
@@ -1423,12 +1462,18 @@ class AirspaceProfileAnalysisViewModel {
       that._drawManager.clearDrawGroup("AirspaceProfileAnalysisDraw");
     }, "AirspaceProfileAnalysisDraw");
   }
+
+  /** @description 根据绘制的矩形区域执行空域剖面分析并绘制结果
+   * @param {Object} shape 绘制得到的矩形几何对象
+   */
   showAirspaceProfileAnalysis(shape) {
     this.removeData();
     const that = this;
     const queryUrl = this._options.queryUrl || "";
     const level = this._options.calcLevel || 23;
     const height = Number(this._options.height) || 120;
+
+    // 将矩形弧度边界转为角度经纬度
     const minLon = shape.rectangle.west / Math.PI * 180;
     const maxLon = shape.rectangle.east / Math.PI * 180;
     const minLat = shape.rectangle.south / Math.PI * 180;
@@ -1438,6 +1483,8 @@ class AirspaceProfileAnalysisViewModel {
     // 客户端计算矩形范围内的三维网格编码列表
     const codeList = Module.calcGeoSotGBCode3DListOfRectZ(minLon, minLat, height, maxLon, maxLat, height, level - 1);
     this.drawGridsOutlineFromCodeList(codeList, Cesium.Color.GREEN.withAlpha(0.3));
+
+    // 构造查询请求体
     const body = {
       geom: {
         type: "FeatureCollection",
@@ -1454,6 +1501,8 @@ class AirspaceProfileAnalysisViewModel {
       level: Number(level)
     };
     this._showLoading();
+
+    // 请求服务端获取剖面网格并绘制
     fetch(queryUrl + "/airspaceOccupyRegion", {
       method: "POST",
       headers: {
@@ -1469,6 +1518,7 @@ class AirspaceProfileAnalysisViewModel {
         if (data.content) {
           const results = data.content;
           let hasResult = false;
+          // 按类型绘制剖面网格
           for (const key in results) {
             const typeCodes = results[key];
             if (typeCodes && typeCodes.length > 0) {
@@ -1487,6 +1537,11 @@ class AirspaceProfileAnalysisViewModel {
       });
     });
   }
+
+  /** @description 根据网格编码列表绘制实心网格图元
+   * @param {Array} codeList 网格编码数组
+   * @param {Cesium.Color} color 网格填充颜色
+   */
   drawGridsFromCodeList(codeList, color) {
     let instances = [];
     for (let i = 0; i < codeList.length; i++) {
@@ -1494,6 +1549,7 @@ class AirspaceProfileAnalysisViewModel {
       const index = (code.length + 1) / 2;
       const grid = Module.decodeGeoSotGBCodeToBox(code.substring(0, index), code.substring(index));
       if (grid) {
+        // 限制经纬度边界到合法范围
         if (grid.minx < -180) grid.minx = -180;
         if (grid.maxx > 180) grid.maxx = 180;
         if (grid.miny < -90) grid.miny = -90;
@@ -1515,6 +1571,8 @@ class AirspaceProfileAnalysisViewModel {
         }));
       }
     }
+
+    // 存在几何实例时创建 Primitive 添加到场景
     if (instances.length > 0) {
       const primitive = this._viewer.scene.primitives.add(new Cesium.Primitive({
         geometryInstances: instances,
@@ -1541,6 +1599,11 @@ class AirspaceProfileAnalysisViewModel {
       this._queryGrids.push(primitive);
     }
   }
+
+  /** @description 根据网格编码列表绘制网格轮廓线
+   * @param {Array} codeList 网格编码数组（可能是数组或类 Map 结构）
+   * @param {Cesium.Color} color 轮廓颜色
+   */
   drawGridsOutlineFromCodeList(codeList, color) {
     const outlineColor = Cesium.ColorGeometryInstanceAttribute.fromColor(color);
     const instances = [];
@@ -1548,6 +1611,7 @@ class AirspaceProfileAnalysisViewModel {
     for (let i = 0; i < size; i++) {
       const code = codeList.get ? codeList.get(i) : codeList[i];
       const index = (code.length + 1) / 2;
+      // 优先使用 3D 编码解码方法，兼容旧版二维解码
       const grid = Module.decodeGeoSotGBCode3DToBox ? Module.decodeGeoSotGBCode3DToBox(code) : Module.decodeGeoSotGBCodeToBox(code.substring(0, index), code.substring(index));
       if (grid) {
         if (grid.minx < -180) grid.minx = -180;
@@ -1574,6 +1638,8 @@ class AirspaceProfileAnalysisViewModel {
         }));
       }
     }
+
+    // 存在几何实例时创建轮廓 Primitive 添加到场景
     if (instances.length > 0) {
       const primitive = this._viewer.scene.primitives.add(new Cesium.Primitive({
         geometryInstances: instances,
@@ -1589,6 +1655,8 @@ class AirspaceProfileAnalysisViewModel {
       this._queryGrids.push(primitive);
     }
   }
+
+  // 显示全屏加载动画（无参数）
   _showLoading() {
     this._loading = _loading.default.service({
       lock: true,
@@ -1597,24 +1665,44 @@ class AirspaceProfileAnalysisViewModel {
       target: this._mapTarget ? document.getElementById(this._mapTarget) : null
     });
   }
+
+  // 关闭全屏加载动画（无参数）
   _hideLoading() {
     if (this._loading) {
       this._loading.close();
       this._loading = null;
     }
   }
+
+  /** @description 设置查询服务地址
+   * @param {String} val 查询服务地址
+   */
   setQueryUrl(val) {
     this._options.queryUrl = val;
   }
+
+  /** @description 设置计算层级
+   * @param {Number} val 计算层级
+   */
   setCalcLevel(val) {
     this._options.calcLevel = Number(val);
   }
+
+  /** @description 设置高度类型
+   * @param {String} val 高度类型
+   */
   setHeightType(val) {
     this._options.heightType = val;
   }
+
+  /** @description 设置分析高度
+   * @param {Number} val 分析高度
+   */
   setHeight(val) {
     this._options.height = Number(val);
   }
+
+  // 移除已添加的查询网格图元（无参数）
   removeData() {
     if (this._queryGrids && this._queryGrids.length > 0) {
       for (let i = 0; i < this._queryGrids.length; i++) {
@@ -1623,12 +1711,16 @@ class AirspaceProfileAnalysisViewModel {
       this._queryGrids = [];
     }
   }
+
+  // 清除分析结果、关闭加载并停止绘制（无参数）
   clear() {
     this.removeData();
     this._hideLoading();
     this._drawManager?.stopDraw();
     this._drawManager?.clearDrawGroup("AirspaceProfileAnalysisDraw");
   }
+
+  // 销毁视图模型，释放所有资源（无参数）
   destroy() {
     this.clear();
   }
@@ -1673,11 +1765,11 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.kq_npm_client_leaflet_vue = exports.kq_npm_client_common_vue = exports.kq_npm_client3d_webgl_vue = void 0;
-let kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
+const kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
 __webpack_require__.g.kq_npm_client_common_vue = kq_npm_client_common_vue;
-let kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
+const kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
 __webpack_require__.g.kq_npm_client_leaflet_vue = kq_npm_client_leaflet_vue;
-let kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
+const kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
 __webpack_require__.g.kq_npm_client3d_webgl_vue = kq_npm_client3d_webgl_vue;
 
 /***/ })