cesium-xs-sdk 1.0.8 → 1.0.9

package/dist/cesium-xs-sdk.cjs.js

@@ -3047,6 +3047,9 @@ class GraphicModule {
       return false;
     }
 
+    // 清理可能存在的 outline 等关联 entity
+    this.removeOutline(graphicId);
+
     const entity = this.graphicMap.get(graphicId);
     this.viewer.entities.remove(entity);
     this.graphicMap.delete(graphicId);
@@ -3062,6 +3065,160 @@ class GraphicModule {
   getGraphic(graphicId) {
     return this.graphicMap.get(graphicId);
   }
+
+  /**
+   * 从 entity 中提取顶点坐标
+   * 支持 point / polyline / polygon
+   * @private
+   * @param {Cesium.Entity} entity 图元实体
+   * @returns {Cesium.Cartesian3[]} 顶点坐标数组
+   */
+  _getEntityPositions(entity) {
+    const getValue = (prop) => {
+      if (prop == null) return undefined;
+      return typeof prop.getValue === 'function' ? prop.getValue(Cesium$e.JulianDate.now()) : prop;
+    };
+
+    // 优先按 geometry 类型取顶点，避免 polygon/polyline 也带 position 时只拿到中心点
+    if (entity.polygon?.hierarchy) {
+      const hierarchy = getValue(entity.polygon.hierarchy);
+      if (Array.isArray(hierarchy)) return hierarchy;
+      if (Array.isArray(hierarchy?.positions)) return hierarchy.positions;
+      return [];
+    }
+    if (entity.polyline?.positions) {
+      return getValue(entity.polyline.positions) ?? [];
+    }
+    if (entity.position) {
+      const p = getValue(entity.position);
+      return p ? [p] : [];
+    }
+    return [];
+  }
+
+  /**
+   * 获取图元顶点坐标
+   * @param {string|Cesium.Entity} graphicIdOrEntity 图元ID或实体
+   * @returns {Cesium.Cartesian3[]} 顶点坐标数组
+   */
+  getPositions(graphicIdOrEntity) {
+    const entity = typeof graphicIdOrEntity === 'string'
+      ? this.getGraphic(graphicIdOrEntity)
+      : graphicIdOrEntity;
+    return entity ? this._getEntityPositions(entity) : [];
+  }
+
+  /**
+   * 获取图元包围球
+   * @param {string|Cesium.Entity} graphicIdOrEntity 图元ID或实体
+   * @returns {Cesium.BoundingSphere|null} 包围球
+   */
+  getBoundingSphere(graphicIdOrEntity) {
+    const positions = this.getPositions(graphicIdOrEntity);
+    if (!positions.length) return null;
+
+    const sphere = Cesium$e.BoundingSphere.fromPoints(positions);
+    // 点图元只有单个坐标，radius 为 0，给一个最小可视半径避免相机钻进点里
+    if (positions.length === 1 && sphere.radius === 0) {
+      sphere.radius = 5000;
+    }
+    return sphere;
+  }
+
+  /**
+   * 飞行定位到图元
+   * @param {string|Cesium.Entity} graphicIdOrEntity 图元ID或实体
+   * @param {object} options 配置项 { pitch?, padding?, duration? }
+   * @returns {Promise<boolean>}
+   */
+  flyTo(graphicIdOrEntity, options = {}) {
+    const entity = typeof graphicIdOrEntity === 'string'
+      ? this.getGraphic(graphicIdOrEntity)
+      : graphicIdOrEntity;
+    if (!entity || !this.viewer) return Promise.resolve(false);
+
+    const sphere = this.getBoundingSphere(entity);
+    if (!sphere) return Promise.resolve(false);
+
+    const pitch = options.pitch ?? -Cesium$e.Math.PI_OVER_TWO;
+    const padding = options.padding ?? 2;
+    const fovy = this.viewer.camera.frustum.fovy;
+    const range = (sphere.radius / Math.tan(fovy / 2)) * padding;
+
+    return this.viewer.camera.flyToBoundingSphere(sphere, {
+      duration: options.duration ?? 1.5,
+      offset: new Cesium$e.HeadingPitchRange(0, pitch, range),
+    }).then(() => true).catch((err) => {
+      console.error('图元定位失败', err);
+      return false;
+    });
+  }
+
+  /**
+   * 瞬间定位到图元（无动画）
+   * @param {string|Cesium.Entity} graphicIdOrEntity 图元ID或实体
+   * @param {object} options 配置项 { pitch?, padding? }
+   */
+  zoomTo(graphicIdOrEntity, options = {}) {
+    const entity = typeof graphicIdOrEntity === 'string'
+      ? this.getGraphic(graphicIdOrEntity)
+      : graphicIdOrEntity;
+    if (!entity || !this.viewer) return;
+
+    const sphere = this.getBoundingSphere(entity);
+    if (!sphere) return;
+
+    const pitch = options.pitch ?? -Cesium$e.Math.PI_OVER_TWO;
+    const padding = options.padding ?? 2;
+    const fovy = this.viewer.camera.frustum.fovy;
+    const range = (sphere.radius / Math.tan(fovy / 2)) * padding;
+
+    this.viewer.camera.viewBoundingSphere(sphere, new Cesium$e.HeadingPitchRange(0, pitch, range));
+  }
+
+  /**
+   * 为面图元设置/移除外边框（用 polyline 模拟，解决 Cesium 贴地 polygon 不支持 outline 的问题）
+   * @param {string} graphicId 图元ID
+   * @param {object} options 配置项 { enabled, color, width }
+   * @returns {boolean} 是否设置成功
+   */
+  setOutline(graphicId, options = {}) {
+    const entity = this.getGraphic(graphicId);
+    if (!entity || !entity.polygon || !this.viewer) return false;
+
+    // 先移除旧的
+    this.removeOutline(graphicId);
+
+    if (!options.enabled) return true;
+
+    const positions = this._getEntityPositions(entity);
+    if (positions.length < 3) return false;
+
+    const closedPositions = [...positions, positions[0]];
+    const outlineId = `${graphicId}_outline`;
+    const color = options.color ?? Cesium$e.Color.WHITE;
+    const width = options.width ?? 2;
+
+    this.viewer.entities.add({
+      id: outlineId,
+      polyline: {
+        positions: closedPositions,
+        width,
+        material: color,
+        clampToGround: true,
+      },
+    });
+    return true;
+  }
+
+  /**
+   * 移除面图元的外边框
+   * @param {string} graphicId 图元ID
+   */
+  removeOutline(graphicId) {
+    if (!this.viewer) return;
+    this.viewer.entities.removeById(`${graphicId}_outline`);
+  }
 }
 
 const Cesium$d = getCesium();
@@ -6886,563 +7043,563 @@ class GeoCalcUtil {
     }
 }
 
-const Cesium$6 = getCesium();
-
-/**
- * 测量类型枚举
- */
-const MeasureType = {
-  DISTANCE: 'distance',
-  AREA: 'area'
-};
-
-/**
- * 测量工具
- * 支持交互式测距（折线）和测面积（多边形）。
- * 左键加点，右键 / Enter 完成，Esc 取消，Backspace 撤销上一点。
- */
-class MeasureTool extends BaseTool {
-  constructor(editorModule, options = {}) {
-    super(editorModule, options);
-
-    this._measureType = options.measureType || MeasureType.DISTANCE;
-    this._positions = [];          // 已点击的经纬度点
-    this._mousePos = null;         // 当前鼠标位置（经纬度）
-    this._isMeasuring = false;     // 是否正在一次测量中
-    this._lastResult = null;       // 最后一次测量结果
-
-    // 临时图元引用
-    this._pointEntities = [];      // 点击点标记
-    this._previewLine = null;      // 测距预览线
-    this._previewPolygon = null;   // 测面积预览面
-    this._previewOutline = null;   // 测面积预览轮廓线
-    this._previewCartesians = [];  // 当前预览几何的笛卡尔坐标数组（CallbackProperty 共享引用）
-    this._segmentLabelEntities = []; // 测距每段标注
-    this._totalLabelEntity = null; // 总距离 / 面积标注
-
-    // 已完成的测量结果图元分组，支持一次激活中保留多个测量结果
-    this._finishedResults = [];
-  }
-
-  /**
-   * 设置测量类型
-   * @param {string} type MeasureType
-   */
-  setMeasureType(type) {
-    this._measureType = type;
-    return this;
-  }
-
-  /**
-   * 获取当前测量类型
-   */
-  getMeasureType() {
-    return this._measureType;
-  }
-
-  /**
-   * 获取最后一次测量结果
-   */
-  getLastResult() {
-    return this._lastResult;
-  }
-
-  onActivate() {
-    this.registerObserver('mouse:click', this._onClick.bind(this));
-    this.registerObserver('mouse:move', this._onMove.bind(this));
-    this.registerObserver('mouse:rightclick', this._onRightClick.bind(this));
-    this.registerObserver('keyboard:keydown', this._onKeyDown.bind(this));
-  }
-
-  onDeactivate() {
-    this.clearMeasurements();
-  }
-
-  _onClick(lngLat) {
-    if (!lngLat) return;
-
-    this._isMeasuring = true;
-    this._positions.push(lngLat);
-    this._addPointMarker(lngLat);
-    this._updateMeasurement();
-  }
-
-  _onMove(data) {
-    const screenPos = data.position || data.endPosition;
-    if (!screenPos) return;
-
-    const lonLat = this.screenToLonLat({ x: screenPos.x, y: screenPos.y });
-    if (!lonLat) return;
-
-    this._mousePos = lonLat;
-    if (this._isMeasuring) {
-      this._updateMeasurement();
-    }
-  }
-
-  _onRightClick() {
-    this._finishMeasurement();
-  }
-
-  _onKeyDown(data) {
-    if (data.key === 'Escape') {
-      this.cancelMeasurement();
-      return;
-    }
-
-    if (data.key === 'Enter') {
-      this._finishMeasurement();
-      return;
-    }
-
-    if (data.key === 'Backspace' && this._isMeasuring && this._positions.length > 0) {
-      this._positions.pop();
-      const lastPoint = this._pointEntities.pop();
-      if (lastPoint) {
-        this.removeTempEntity(lastPoint);
-      }
-      this._updateMeasurement();
-    }
-  }
-
-  /**
-   * 完成当前测量
-   */
-  _finishMeasurement() {
-    const minPoints = this._measureType === MeasureType.AREA ? 3 : 2;
-    if (this._positions.length < minPoints) return;
-
-    this._isMeasuring = false;
-    this._mousePos = null;
-    this._updateMeasurement();
-
-    const result = this._computeResult(this._positions);
-    this._lastResult = result;
-
-    // 将当前测量结果保留在场景中，并清空工作态以便继续下一次测量
-    this._commitCurrentResult();
-
-    this._emitMeasureComplete(result);
-  }
-
-  /**
-   * 把当前测量图元归档为已完成结果，重置工作态
-   */
-  _commitCurrentResult() {
-    const finalCartesians = this._previewCartesians.slice();
-
-    // 将动态 CallbackProperty 替换为常量几何，避免归档后随 _previewCartesians 变化而消失
-    if (this._previewLine) {
-      this._previewLine.polyline.positions = finalCartesians.length > 0 ? finalCartesians : [];
-    }
-    if (this._previewPolygon) {
-      this._previewPolygon.polygon.hierarchy = finalCartesians.length >= 3
-        ? new Cesium$6.PolygonHierarchy(finalCartesians)
-        : new Cesium$6.PolygonHierarchy([]);
-    }
-    if (this._previewOutline) {
-      this._previewOutline.polyline.positions = finalCartesians.length >= 3
-        ? [...finalCartesians, finalCartesians[0]]
-        : [];
-    }
-
-    this._finishedResults.push({
-      pointEntities: this._pointEntities,
-      segmentLabels: this._segmentLabelEntities,
-      totalLabel: this._totalLabelEntity,
-      previewLine: this._previewLine,
-      previewPolygon: this._previewPolygon,
-      previewOutline: this._previewOutline
-    });
-
-    this._positions = [];
-    this._mousePos = null;
-    this._isMeasuring = false;
-    this._previewCartesians = [];
-
-    this._pointEntities = [];
-    this._segmentLabelEntities = [];
-    this._totalLabelEntity = null;
-    this._previewLine = null;
-    this._previewPolygon = null;
-    this._previewOutline = null;
-  }
-
-  /**
-   * 取消当前测量
-   */
-  cancelMeasurement() {
-    this.clearMeasurements();
-    this._emitMeasureCancel();
-  }
-
-  /**
-   * 清空所有测量结果与临时图元
-   */
-  clearMeasurements() {
-    this._positions = [];
-    this._mousePos = null;
-    this._isMeasuring = false;
-    this._lastResult = null;
-    this._previewCartesians = [];
-
-    this._pointEntities.forEach(e => this.removeTempEntity(e));
-    this._pointEntities = [];
-
-    this._segmentLabelEntities.forEach(e => this.removeTempEntity(e));
-    this._segmentLabelEntities = [];
-
-    if (this._totalLabelEntity) {
-      this.removeTempEntity(this._totalLabelEntity);
-      this._totalLabelEntity = null;
-    }
-
-    if (this._previewLine) {
-      this.removeTempEntity(this._previewLine);
-      this._previewLine = null;
-    }
-
-    if (this._previewPolygon) {
-      this.removeTempEntity(this._previewPolygon);
-      this._previewPolygon = null;
-    }
-
-    if (this._previewOutline) {
-      this.removeTempEntity(this._previewOutline);
-      this._previewOutline = null;
-    }
-
-    this._finishedResults.forEach(group => {
-      group.pointEntities.forEach(e => this.removeTempEntity(e));
-      group.segmentLabels.forEach(e => this.removeTempEntity(e));
-      if (group.totalLabel) this.removeTempEntity(group.totalLabel);
-      if (group.previewLine) this.removeTempEntity(group.previewLine);
-      if (group.previewPolygon) this.removeTempEntity(group.previewPolygon);
-      if (group.previewOutline) this.removeTempEntity(group.previewOutline);
-    });
-    this._finishedResults = [];
-  }
-
-  /**
-   * 更新预览几何与标注
-   */
-  _updateMeasurement() {
-    if (this._positions.length === 0) return;
-
-    const positions = [...this._positions];
-    if (this._isMeasuring && this._mousePos) {
-      positions.push(this._mousePos);
-    }
-
-    if (this._measureType === MeasureType.DISTANCE) {
-      this._updateDistancePreview(positions);
-    } else {
-      this._updateAreaPreview(positions);
-    }
-
-    if (this._isMeasuring) {
-      this._emitMeasureProgress(this._computeResult(positions));
-    }
-  }
-
-  _updateDistancePreview(positions) {
-    const cartesians = positions.length >= 2
-      ? positions.map(p => Cesium$6.Cartesian3.fromDegrees(...p))
-      : [];
-    this._previewCartesians = cartesians;
-
-    // 预览线
-    if (!this._previewLine) {
-      this._previewLine = this.createTempEntity(this.generateId('measure_line'), {
-        polyline: {
-          positions: new Cesium$6.CallbackProperty(() => this._previewCartesians, false),
-          material: Cesium$6.Color.YELLOW,
-          width: 2,
-          clampToGround: true
-        }
-      });
-    }
-    this._previewLine.show = cartesians.length >= 2;
-
-    // 每段标注
-    const segmentCount = Math.max(0, positions.length - 1);
-    this._ensureSegmentLabels(segmentCount);
-
-    let total = 0;
-    for (let i = 0; i < segmentCount; i++) {
-      const p1 = positions[i];
-      const p2 = positions[i + 1];
-      const dist = GeoCalcUtil.calcDistance(p1, p2);
-      total += dist;
-
-      const mid = Cesium$6.Cartesian3.midpoint(
-        Cesium$6.Cartesian3.fromDegrees(...p1),
-        Cesium$6.Cartesian3.fromDegrees(...p2),
-        new Cesium$6.Cartesian3()
-      );
-
-      const label = this._segmentLabelEntities[i];
-      label.position = mid;
-      label.label.text = this._formatDistance(dist).text;
-      label.show = true;
-    }
-
-    // 总距离标注
-    const lastCartesian = cartesians[cartesians.length - 1];
-    if (positions.length >= 2) {
-      if (!this._totalLabelEntity) {
-        this._totalLabelEntity = this._createLabelEntity(
-          this.generateId('measure_total'),
-          lastCartesian,
-          `总长：${this._formatDistance(total).text}`
-        );
-      } else {
-        this._totalLabelEntity.position = lastCartesian;
-        this._totalLabelEntity.label.text = `总长：${this._formatDistance(total).text}`;
-        this._totalLabelEntity.show = true;
-      }
-    } else if (this._totalLabelEntity) {
-      this._totalLabelEntity.show = false;
-    }
-  }
-
-  _updateAreaPreview(positions) {
-    const cartesians = positions.map(p => Cesium$6.Cartesian3.fromDegrees(...p));
-    this._previewCartesians = cartesians;
-
-    if (positions.length >= 3) {
-      // 显示面 + 闭合轮廓
-      if (!this._previewPolygon) {
-        this._previewPolygon = this.createTempEntity(this.generateId('measure_polygon'), {
-          polygon: {
-            hierarchy: new Cesium$6.CallbackProperty(() => new Cesium$6.PolygonHierarchy(this._previewCartesians), false),
-            material: Cesium$6.Color.YELLOW.withAlpha(0.2),
-            outline: false
-          }
-        });
-        this._previewOutline = this.createTempEntity(this.generateId('measure_outline'), {
-          polyline: {
-            positions: new Cesium$6.CallbackProperty(() => this._previewCartesians.length > 0
-              ? [...this._previewCartesians, this._previewCartesians[0]]
-              : [], false),
-            material: Cesium$6.Color.YELLOW,
-            width: 2,
-            clampToGround: true
-          }
-        });
-      }
-      this._previewPolygon.show = true;
-      this._previewOutline.show = true;
-      if (this._previewLine) {
-        this._previewLine.show = false;
-      }
-
-      const area = GeoCalcUtil.calcArea(positions);
-      const centroid = this._computeCentroid(cartesians);
-
-      if (!this._totalLabelEntity) {
-        this._totalLabelEntity = this._createLabelEntity(
-          this.generateId('measure_area'),
-          centroid,
-          `面积：${this._formatArea(area).text}`
-        );
-      } else {
-        this._totalLabelEntity.position = centroid;
-        this._totalLabelEntity.label.text = `面积：${this._formatArea(area).text}`;
-        this._totalLabelEntity.show = true;
-      }
-    } else {
-      // 不足 3 点时只显示连线，并隐藏已有的面、轮廓、面积标注
-      if (this._previewPolygon) {
-        this._previewPolygon.show = false;
-      }
-      if (this._previewOutline) {
-        this._previewOutline.show = false;
-      }
-      if (this._totalLabelEntity) {
-        this._totalLabelEntity.show = false;
-      }
-
-      if (!this._previewLine) {
-        this._previewLine = this.createTempEntity(this.generateId('measure_line'), {
-          polyline: {
-            positions: new Cesium$6.CallbackProperty(() => this._previewCartesians, false),
-            material: Cesium$6.Color.YELLOW,
-            width: 2,
-            clampToGround: true
-          }
-        });
-      }
-      this._previewLine.show = positions.length >= 2;
-    }
-  }
-
-  _ensureSegmentLabels(count) {
-    // 移除多余的标注
-    while (this._segmentLabelEntities.length > count) {
-      const label = this._segmentLabelEntities.pop();
-      this.removeTempEntity(label);
-    }
-
-    // 创建缺少的标注
-    while (this._segmentLabelEntities.length < count) {
-      const label = this._createLabelEntity(
-        this.generateId('measure_segment'),
-        Cesium$6.Cartesian3.ZERO,
-        ''
-      );
-      this._segmentLabelEntities.push(label);
-    }
-  }
-
-  _createLabelEntity(id, position, text) {
-    return this.createTempEntity(id, {
-      position,
-      label: {
-        text,
-        font: '14px Microsoft YaHei',
-        fillColor: Cesium$6.Color.WHITE,
-        outlineColor: Cesium$6.Color.BLACK,
-        outlineWidth: 2,
-        style: Cesium$6.LabelStyle.FILL_AND_OUTLINE,
-        verticalOrigin: Cesium$6.VerticalOrigin.BOTTOM,
-        horizontalOrigin: Cesium$6.HorizontalOrigin.CENTER,
-        heightReference: Cesium$6.HeightReference.CLAMP_TO_GROUND,
-        disableDepthTestDistance: Number.POSITIVE_INFINITY,
-        pixelOffset: new Cesium$6.Cartesian2(0, -10)
-      }
-    });
-  }
-
-  _addPointMarker(lonLat) {
-    const point = this.createTempEntity(this.generateId('measure_point'), {
-      position: Cesium$6.Cartesian3.fromDegrees(...lonLat),
-      point: {
-        color: Cesium$6.Color.YELLOW,
-        pixelSize: 8,
-        outlineColor: Cesium$6.Color.BLACK,
-        outlineWidth: 1,
-        heightReference: Cesium$6.HeightReference.CLAMP_TO_GROUND,
-        disableDepthTestDistance: Number.POSITIVE_INFINITY
-      }
-    });
-    this._pointEntities.push(point);
-  }
-
-  _computeResult(positions) {
-    if (this._measureType === MeasureType.DISTANCE) {
-      let total = 0;
-      for (let i = 0; i < positions.length - 1; i++) {
-        total += GeoCalcUtil.calcDistance(positions[i], positions[i + 1]);
-      }
-      const fmt = this._formatDistance(total);
-      return {
-        type: MeasureType.DISTANCE,
-        value: total,
-        unit: fmt.unit,
-        formatted: fmt.text,
-        positions: positions.slice()
-      };
-    }
-
-    const area = GeoCalcUtil.calcArea(positions);
-    const fmt = this._formatArea(area);
-    return {
-      type: MeasureType.AREA,
-      value: area,
-      unit: fmt.unit,
-      formatted: fmt.text,
-      positions: positions.slice()
-    };
-  }
-
-  _computeCentroid(cartesians) {
-    const center = new Cesium$6.Cartesian3(0, 0, 0);
-    for (const c of cartesians) {
-      Cesium$6.Cartesian3.add(center, c, center);
-    }
-    return Cesium$6.Cartesian3.multiplyByScalar(center, 1 / cartesians.length, center);
-  }
-
-  _formatDistance(meters) {
-    if (meters >= 1000) {
-      return { text: `${(meters / 1000).toFixed(2)} km`, unit: 'km' };
-    }
-    return { text: `${meters.toFixed(2)} m`, unit: 'm' };
-  }
-
-  _formatArea(squareMeters) {
-    if (squareMeters >= 1000000) {
-      return { text: `${(squareMeters / 1000000).toFixed(3)} km²`, unit: 'km²' };
-    }
-    return { text: `${squareMeters.toFixed(2)} m²`, unit: 'm²' };
-  }
-
-  _emitMeasureProgress(result) {
-    if (this._options.onMeasureProgress) {
-      this._options.onMeasureProgress(result);
-    }
-  }
-
-  _emitMeasureComplete(result) {
-    if (this._options.onMeasureComplete) {
-      this._options.onMeasureComplete(result);
-    }
-  }
-
-  _emitMeasureCancel() {
-    if (this._options.onMeasureCancel) {
-      this._options.onMeasureCancel();
-    }
-  }
-}
-
+const Cesium$6 = getCesium();
+
 /**
- * 工具名称枚举
+ * 测量类型枚举
  */
-const ToolName = {
-  DRAW: 'draw',
-  EDIT: 'edit',
-  SELECT: 'select',
-  DELETE: 'delete',
-  MEASURE: 'measure'
+const MeasureType = {
+  DISTANCE: 'distance',
+  AREA: 'area'
 };
 
 /**
- * 编辑器模块
- * 负责工具的注册、切换、激活管理
+ * 测量工具
+ * 支持交互式测距（折线）和测面积（多边形）。
+ * 左键加点，右键 / Enter 完成，Esc 取消，Backspace 撤销上一点。
  */
-class EditorModule {
-  constructor(viewer, options = {}) {
-    this.viewer = viewer;
-    this.config = Config.getInstance().getConfig();
-    this.graphicModule = null;  // 依赖注入
-    this.eventModule = null;     // 依赖注入
-    this.toolMap = new Map();   // 工具缓存
-    this.currentTool = null;    // 当前激活的工具
-    this.currentToolName = null;
-    this._isActive = false;
+class MeasureTool extends BaseTool {
+  constructor(editorModule, options = {}) {
+    super(editorModule, options);
+
+    this._measureType = options.measureType || MeasureType.DISTANCE;
+    this._positions = [];          // 已点击的经纬度点
+    this._mousePos = null;         // 当前鼠标位置（经纬度）
+    this._isMeasuring = false;     // 是否正在一次测量中
+    this._lastResult = null;       // 最后一次测量结果
+
+    // 临时图元引用
+    this._pointEntities = [];      // 点击点标记
+    this._previewLine = null;      // 测距预览线
+    this._previewPolygon = null;   // 测面积预览面
+    this._previewOutline = null;   // 测面积预览轮廓线
+    this._previewCartesians = [];  // 当前预览几何的笛卡尔坐标数组（CallbackProperty 共享引用）
+    this._segmentLabelEntities = []; // 测距每段标注
+    this._totalLabelEntity = null; // 总距离 / 面积标注
+
+    // 已完成的测量结果图元分组，支持一次激活中保留多个测量结果
+    this._finishedResults = [];
   }
 
   /**
-   * 设置依赖模块
-   * @param {object} deps 依赖模块 { graphicModule, eventModule }
+   * 设置测量类型
+   * @param {string} type MeasureType
    */
-  setDependencies(deps) {
-    this.graphicModule = deps.graphicModule;
-    this.eventModule = deps.eventModule;
+  setMeasureType(type) {
+    this._measureType = type;
     return this;
   }
 
   /**
-   * 初始化编辑器，注册所有内置工具
+   * 获取当前测量类型
    */
-  init() {
-    // 注册内置工具
-    this.registerTool(ToolName.DRAW, new DrawTool(this));
-    this.registerTool(ToolName.EDIT, new EditTool(this));
-    this.registerTool(ToolName.SELECT, new SelectTool(this));
-    this.registerTool(ToolName.DELETE, new DeleteTool(this));
+  getMeasureType() {
+    return this._measureType;
+  }
+
+  /**
+   * 获取最后一次测量结果
+   */
+  getLastResult() {
+    return this._lastResult;
+  }
+
+  onActivate() {
+    this.registerObserver('mouse:click', this._onClick.bind(this));
+    this.registerObserver('mouse:move', this._onMove.bind(this));
+    this.registerObserver('mouse:rightclick', this._onRightClick.bind(this));
+    this.registerObserver('keyboard:keydown', this._onKeyDown.bind(this));
+  }
+
+  onDeactivate() {
+    this.clearMeasurements();
+  }
+
+  _onClick(lngLat) {
+    if (!lngLat) return;
+
+    this._isMeasuring = true;
+    this._positions.push(lngLat);
+    this._addPointMarker(lngLat);
+    this._updateMeasurement();
+  }
+
+  _onMove(data) {
+    const screenPos = data.position || data.endPosition;
+    if (!screenPos) return;
+
+    const lonLat = this.screenToLonLat({ x: screenPos.x, y: screenPos.y });
+    if (!lonLat) return;
+
+    this._mousePos = lonLat;
+    if (this._isMeasuring) {
+      this._updateMeasurement();
+    }
+  }
+
+  _onRightClick() {
+    this._finishMeasurement();
+  }
+
+  _onKeyDown(data) {
+    if (data.key === 'Escape') {
+      this.cancelMeasurement();
+      return;
+    }
+
+    if (data.key === 'Enter') {
+      this._finishMeasurement();
+      return;
+    }
+
+    if (data.key === 'Backspace' && this._isMeasuring && this._positions.length > 0) {
+      this._positions.pop();
+      const lastPoint = this._pointEntities.pop();
+      if (lastPoint) {
+        this.removeTempEntity(lastPoint);
+      }
+      this._updateMeasurement();
+    }
+  }
+
+  /**
+   * 完成当前测量
+   */
+  _finishMeasurement() {
+    const minPoints = this._measureType === MeasureType.AREA ? 3 : 2;
+    if (this._positions.length < minPoints) return;
+
+    this._isMeasuring = false;
+    this._mousePos = null;
+    this._updateMeasurement();
+
+    const result = this._computeResult(this._positions);
+    this._lastResult = result;
+
+    // 将当前测量结果保留在场景中，并清空工作态以便继续下一次测量
+    this._commitCurrentResult();
+
+    this._emitMeasureComplete(result);
+  }
+
+  /**
+   * 把当前测量图元归档为已完成结果，重置工作态
+   */
+  _commitCurrentResult() {
+    const finalCartesians = this._previewCartesians.slice();
+
+    // 将动态 CallbackProperty 替换为常量几何，避免归档后随 _previewCartesians 变化而消失
+    if (this._previewLine) {
+      this._previewLine.polyline.positions = finalCartesians.length > 0 ? finalCartesians : [];
+    }
+    if (this._previewPolygon) {
+      this._previewPolygon.polygon.hierarchy = finalCartesians.length >= 3
+        ? new Cesium$6.PolygonHierarchy(finalCartesians)
+        : new Cesium$6.PolygonHierarchy([]);
+    }
+    if (this._previewOutline) {
+      this._previewOutline.polyline.positions = finalCartesians.length >= 3
+        ? [...finalCartesians, finalCartesians[0]]
+        : [];
+    }
+
+    this._finishedResults.push({
+      pointEntities: this._pointEntities,
+      segmentLabels: this._segmentLabelEntities,
+      totalLabel: this._totalLabelEntity,
+      previewLine: this._previewLine,
+      previewPolygon: this._previewPolygon,
+      previewOutline: this._previewOutline
+    });
+
+    this._positions = [];
+    this._mousePos = null;
+    this._isMeasuring = false;
+    this._previewCartesians = [];
+
+    this._pointEntities = [];
+    this._segmentLabelEntities = [];
+    this._totalLabelEntity = null;
+    this._previewLine = null;
+    this._previewPolygon = null;
+    this._previewOutline = null;
+  }
+
+  /**
+   * 取消当前测量
+   */
+  cancelMeasurement() {
+    this.clearMeasurements();
+    this._emitMeasureCancel();
+  }
+
+  /**
+   * 清空所有测量结果与临时图元
+   */
+  clearMeasurements() {
+    this._positions = [];
+    this._mousePos = null;
+    this._isMeasuring = false;
+    this._lastResult = null;
+    this._previewCartesians = [];
+
+    this._pointEntities.forEach(e => this.removeTempEntity(e));
+    this._pointEntities = [];
+
+    this._segmentLabelEntities.forEach(e => this.removeTempEntity(e));
+    this._segmentLabelEntities = [];
+
+    if (this._totalLabelEntity) {
+      this.removeTempEntity(this._totalLabelEntity);
+      this._totalLabelEntity = null;
+    }
+
+    if (this._previewLine) {
+      this.removeTempEntity(this._previewLine);
+      this._previewLine = null;
+    }
+
+    if (this._previewPolygon) {
+      this.removeTempEntity(this._previewPolygon);
+      this._previewPolygon = null;
+    }
+
+    if (this._previewOutline) {
+      this.removeTempEntity(this._previewOutline);
+      this._previewOutline = null;
+    }
+
+    this._finishedResults.forEach(group => {
+      group.pointEntities.forEach(e => this.removeTempEntity(e));
+      group.segmentLabels.forEach(e => this.removeTempEntity(e));
+      if (group.totalLabel) this.removeTempEntity(group.totalLabel);
+      if (group.previewLine) this.removeTempEntity(group.previewLine);
+      if (group.previewPolygon) this.removeTempEntity(group.previewPolygon);
+      if (group.previewOutline) this.removeTempEntity(group.previewOutline);
+    });
+    this._finishedResults = [];
+  }
+
+  /**
+   * 更新预览几何与标注
+   */
+  _updateMeasurement() {
+    if (this._positions.length === 0) return;
+
+    const positions = [...this._positions];
+    if (this._isMeasuring && this._mousePos) {
+      positions.push(this._mousePos);
+    }
+
+    if (this._measureType === MeasureType.DISTANCE) {
+      this._updateDistancePreview(positions);
+    } else {
+      this._updateAreaPreview(positions);
+    }
+
+    if (this._isMeasuring) {
+      this._emitMeasureProgress(this._computeResult(positions));
+    }
+  }
+
+  _updateDistancePreview(positions) {
+    const cartesians = positions.length >= 2
+      ? positions.map(p => Cesium$6.Cartesian3.fromDegrees(...p))
+      : [];
+    this._previewCartesians = cartesians;
+
+    // 预览线
+    if (!this._previewLine) {
+      this._previewLine = this.createTempEntity(this.generateId('measure_line'), {
+        polyline: {
+          positions: new Cesium$6.CallbackProperty(() => this._previewCartesians, false),
+          material: Cesium$6.Color.YELLOW,
+          width: 2,
+          clampToGround: true
+        }
+      });
+    }
+    this._previewLine.show = cartesians.length >= 2;
+
+    // 每段标注
+    const segmentCount = Math.max(0, positions.length - 1);
+    this._ensureSegmentLabels(segmentCount);
+
+    let total = 0;
+    for (let i = 0; i < segmentCount; i++) {
+      const p1 = positions[i];
+      const p2 = positions[i + 1];
+      const dist = GeoCalcUtil.calcDistance(p1, p2);
+      total += dist;
+
+      const mid = Cesium$6.Cartesian3.midpoint(
+        Cesium$6.Cartesian3.fromDegrees(...p1),
+        Cesium$6.Cartesian3.fromDegrees(...p2),
+        new Cesium$6.Cartesian3()
+      );
+
+      const label = this._segmentLabelEntities[i];
+      label.position = mid;
+      label.label.text = this._formatDistance(dist).text;
+      label.show = true;
+    }
+
+    // 总距离标注
+    const lastCartesian = cartesians[cartesians.length - 1];
+    if (positions.length >= 2) {
+      if (!this._totalLabelEntity) {
+        this._totalLabelEntity = this._createLabelEntity(
+          this.generateId('measure_total'),
+          lastCartesian,
+          `总长：${this._formatDistance(total).text}`
+        );
+      } else {
+        this._totalLabelEntity.position = lastCartesian;
+        this._totalLabelEntity.label.text = `总长：${this._formatDistance(total).text}`;
+        this._totalLabelEntity.show = true;
+      }
+    } else if (this._totalLabelEntity) {
+      this._totalLabelEntity.show = false;
+    }
+  }
+
+  _updateAreaPreview(positions) {
+    const cartesians = positions.map(p => Cesium$6.Cartesian3.fromDegrees(...p));
+    this._previewCartesians = cartesians;
+
+    if (positions.length >= 3) {
+      // 显示面 + 闭合轮廓
+      if (!this._previewPolygon) {
+        this._previewPolygon = this.createTempEntity(this.generateId('measure_polygon'), {
+          polygon: {
+            hierarchy: new Cesium$6.CallbackProperty(() => new Cesium$6.PolygonHierarchy(this._previewCartesians), false),
+            material: Cesium$6.Color.YELLOW.withAlpha(0.2),
+            outline: false
+          }
+        });
+        this._previewOutline = this.createTempEntity(this.generateId('measure_outline'), {
+          polyline: {
+            positions: new Cesium$6.CallbackProperty(() => this._previewCartesians.length > 0
+              ? [...this._previewCartesians, this._previewCartesians[0]]
+              : [], false),
+            material: Cesium$6.Color.YELLOW,
+            width: 2,
+            clampToGround: true
+          }
+        });
+      }
+      this._previewPolygon.show = true;
+      this._previewOutline.show = true;
+      if (this._previewLine) {
+        this._previewLine.show = false;
+      }
+
+      const area = GeoCalcUtil.calcArea(positions);
+      const centroid = this._computeCentroid(cartesians);
+
+      if (!this._totalLabelEntity) {
+        this._totalLabelEntity = this._createLabelEntity(
+          this.generateId('measure_area'),
+          centroid,
+          `面积：${this._formatArea(area).text}`
+        );
+      } else {
+        this._totalLabelEntity.position = centroid;
+        this._totalLabelEntity.label.text = `面积：${this._formatArea(area).text}`;
+        this._totalLabelEntity.show = true;
+      }
+    } else {
+      // 不足 3 点时只显示连线，并隐藏已有的面、轮廓、面积标注
+      if (this._previewPolygon) {
+        this._previewPolygon.show = false;
+      }
+      if (this._previewOutline) {
+        this._previewOutline.show = false;
+      }
+      if (this._totalLabelEntity) {
+        this._totalLabelEntity.show = false;
+      }
+
+      if (!this._previewLine) {
+        this._previewLine = this.createTempEntity(this.generateId('measure_line'), {
+          polyline: {
+            positions: new Cesium$6.CallbackProperty(() => this._previewCartesians, false),
+            material: Cesium$6.Color.YELLOW,
+            width: 2,
+            clampToGround: true
+          }
+        });
+      }
+      this._previewLine.show = positions.length >= 2;
+    }
+  }
+
+  _ensureSegmentLabels(count) {
+    // 移除多余的标注
+    while (this._segmentLabelEntities.length > count) {
+      const label = this._segmentLabelEntities.pop();
+      this.removeTempEntity(label);
+    }
+
+    // 创建缺少的标注
+    while (this._segmentLabelEntities.length < count) {
+      const label = this._createLabelEntity(
+        this.generateId('measure_segment'),
+        Cesium$6.Cartesian3.ZERO,
+        ''
+      );
+      this._segmentLabelEntities.push(label);
+    }
+  }
+
+  _createLabelEntity(id, position, text) {
+    return this.createTempEntity(id, {
+      position,
+      label: {
+        text,
+        font: '14px Microsoft YaHei',
+        fillColor: Cesium$6.Color.WHITE,
+        outlineColor: Cesium$6.Color.BLACK,
+        outlineWidth: 2,
+        style: Cesium$6.LabelStyle.FILL_AND_OUTLINE,
+        verticalOrigin: Cesium$6.VerticalOrigin.BOTTOM,
+        horizontalOrigin: Cesium$6.HorizontalOrigin.CENTER,
+        heightReference: Cesium$6.HeightReference.CLAMP_TO_GROUND,
+        disableDepthTestDistance: Number.POSITIVE_INFINITY,
+        pixelOffset: new Cesium$6.Cartesian2(0, -10)
+      }
+    });
+  }
+
+  _addPointMarker(lonLat) {
+    const point = this.createTempEntity(this.generateId('measure_point'), {
+      position: Cesium$6.Cartesian3.fromDegrees(...lonLat),
+      point: {
+        color: Cesium$6.Color.YELLOW,
+        pixelSize: 8,
+        outlineColor: Cesium$6.Color.BLACK,
+        outlineWidth: 1,
+        heightReference: Cesium$6.HeightReference.CLAMP_TO_GROUND,
+        disableDepthTestDistance: Number.POSITIVE_INFINITY
+      }
+    });
+    this._pointEntities.push(point);
+  }
+
+  _computeResult(positions) {
+    if (this._measureType === MeasureType.DISTANCE) {
+      let total = 0;
+      for (let i = 0; i < positions.length - 1; i++) {
+        total += GeoCalcUtil.calcDistance(positions[i], positions[i + 1]);
+      }
+      const fmt = this._formatDistance(total);
+      return {
+        type: MeasureType.DISTANCE,
+        value: total,
+        unit: fmt.unit,
+        formatted: fmt.text,
+        positions: positions.slice()
+      };
+    }
+
+    const area = GeoCalcUtil.calcArea(positions);
+    const fmt = this._formatArea(area);
+    return {
+      type: MeasureType.AREA,
+      value: area,
+      unit: fmt.unit,
+      formatted: fmt.text,
+      positions: positions.slice()
+    };
+  }
+
+  _computeCentroid(cartesians) {
+    const center = new Cesium$6.Cartesian3(0, 0, 0);
+    for (const c of cartesians) {
+      Cesium$6.Cartesian3.add(center, c, center);
+    }
+    return Cesium$6.Cartesian3.multiplyByScalar(center, 1 / cartesians.length, center);
+  }
+
+  _formatDistance(meters) {
+    if (meters >= 1000) {
+      return { text: `${(meters / 1000).toFixed(2)} km`, unit: 'km' };
+    }
+    return { text: `${meters.toFixed(2)} m`, unit: 'm' };
+  }
+
+  _formatArea(squareMeters) {
+    if (squareMeters >= 1000000) {
+      return { text: `${(squareMeters / 1000000).toFixed(3)} km²`, unit: 'km²' };
+    }
+    return { text: `${squareMeters.toFixed(2)} m²`, unit: 'm²' };
+  }
+
+  _emitMeasureProgress(result) {
+    if (this._options.onMeasureProgress) {
+      this._options.onMeasureProgress(result);
+    }
+  }
+
+  _emitMeasureComplete(result) {
+    if (this._options.onMeasureComplete) {
+      this._options.onMeasureComplete(result);
+    }
+  }
+
+  _emitMeasureCancel() {
+    if (this._options.onMeasureCancel) {
+      this._options.onMeasureCancel();
+    }
+  }
+}
+
+/**
+ * 工具名称枚举
+ */
+const ToolName = {
+  DRAW: 'draw',
+  EDIT: 'edit',
+  SELECT: 'select',
+  DELETE: 'delete',
+  MEASURE: 'measure'
+};
+
+/**
+ * 编辑器模块
+ * 负责工具的注册、切换、激活管理
+ */
+class EditorModule {
+  constructor(viewer, options = {}) {
+    this.viewer = viewer;
+    this.config = Config.getInstance().getConfig();
+    this.graphicModule = null;  // 依赖注入
+    this.eventModule = null;     // 依赖注入
+    this.toolMap = new Map();   // 工具缓存
+    this.currentTool = null;    // 当前激活的工具
+    this.currentToolName = null;
+    this._isActive = false;
+  }
+
+  /**
+   * 设置依赖模块
+   * @param {object} deps 依赖模块 { graphicModule, eventModule }
+   */
+  setDependencies(deps) {
+    this.graphicModule = deps.graphicModule;
+    this.eventModule = deps.eventModule;
+    return this;
+  }
+
+  /**
+   * 初始化编辑器，注册所有内置工具
+   */
+  init() {
+    // 注册内置工具
+    this.registerTool(ToolName.DRAW, new DrawTool(this));
+    this.registerTool(ToolName.EDIT, new EditTool(this));
+    this.registerTool(ToolName.SELECT, new SelectTool(this));
+    this.registerTool(ToolName.DELETE, new DeleteTool(this));
     this.registerTool(ToolName.MEASURE, new MeasureTool(this));
 
     return this;
@@ -8266,137 +8423,137 @@ class LocationBar extends BaseControl {
   }
 }
 
-const Cesium$4 = getCesium();
-
-/**
- * 缩放控件
- * 提供放大/缩小两个按钮，默认挂到 SDK 统一工具栏（xs3d-viewer-toolbar）。
- */
-class Zoom extends BaseControl {
-  /**
-   * @param {object} options
-   * @param {number} [options.duration=0.5] 缩放动画时长（秒）
-   */
-  constructor(options = {}) {
-    super({
-      type: 'zoom',
-      ...options
-    });
-
-    this._duration = options.duration ?? 0.5;
-  }
-
-  _createContainer() {
-    const div = super._createContainer();
-    div.className += ' xs3d-zoom';
-    // 只有在统一工具栏内才使用 display: contents，让按钮直接参与工具栏 flex 布局；
-    // 自定义容器挂载时保留正常 absolute 定位，支持 top/left/right/bottom。
-    if (this._parentContainer?.classList?.contains('xs3d-viewer-toolbar')) {
-      div.style.display = 'contents';
-    }
-    return div;
-  }
-
-  _getParentContainer() {
-    if (this._options.container) {
-      return super._getParentContainer();
-    }
-    return this._getOrCreateToolbar();
-  }
-
-  _mount() {
-    this._clearAbsolutePositionIfInToolbar();
-
-    this._zoomInBtn = this._createButton('+', '放大');
-    this._zoomOutBtn = this._createButton('-', '缩小');
-
-    this._container.appendChild(this._zoomInBtn);
-    this._container.appendChild(this._zoomOutBtn);
-  }
-
-  _createButton(label, title) {
-    const btn = document.createElement('button');
-    btn.type = 'button';
-    btn.title = title;
-    btn.className = 'cesium-button cesium-toolbar-button xs3d-zoom-button';
-    btn.textContent = label;
-    btn.style.width = '32px';
-    btn.style.height = '32px';
-    btn.style.lineHeight = '1';
-    btn.style.fontSize = '18px';
-    btn.style.fontWeight = 'bold';
-    btn.style.display = 'flex';
-    btn.style.alignItems = 'center';
-    btn.style.justifyContent = 'center';
-    btn.style.cursor = 'pointer';
-    // 在统一工具栏内按 order 排列：指南针 -1，放大 1，缩小 2
-    btn.style.order = label === '+' ? '1' : '2';
-    return btn;
-  }
-
-  _bindEvents() {
-    this._addDomEvent(this._zoomInBtn, 'click', (e) => {
-      e.stopPropagation();
-      this._zoomIn();
-    });
-
-    this._addDomEvent(this._zoomOutBtn, 'click', (e) => {
-      e.stopPropagation();
-      this._zoomOut();
-    });
-  }
-
-  _zoomIn() {
-    this._zoomBy(1);
-  }
-
-  _zoomOut() {
-    this._zoomBy(-1);
-  }
-
-  /**
-   * 按地图层级步进缩放
-   * @param {number} levelDelta 层级变化量，+1 放大一级，-1 缩小一级
-   */
-  _zoomBy(levelDelta) {
-    const camera = this._viewer.camera;
-    const cartographic = camera.positionCartographic;
-    const currentLevel = this._getZoomLevel();
-    const targetLevel = Math.max(0, Math.min(24, currentLevel + levelDelta));
-    const targetHeight = this._getHeightByZoomLevel(targetLevel);
-
-    camera.flyTo({
-      destination: Cesium$4.Cartesian3.fromRadians(
-        cartographic.longitude,
-        cartographic.latitude,
-        targetHeight
-      ),
-      orientation: {
-        heading: camera.heading,
-        pitch: camera.pitch,
-        roll: camera.roll
-      },
-      duration: this._duration
-    });
-  }
-
-  _getZoomLevel() {
-    const positionCartographic = this._viewer.camera.positionCartographic;
-    const surfaceCartesian = Cesium$4.Cartesian3.fromRadians(
-      positionCartographic.longitude,
-      positionCartographic.latitude,
-      0
-    );
-    const distance = Cesium$4.Cartesian3.distance(this._viewer.camera.position, surfaceCartesian);
-    if (!distance || distance <= 0 || !Number.isFinite(distance)) return 0;
-    const equatorCircumference = 6378137 * 2 * Math.PI;
-    return Math.max(0, Math.floor(Math.log2(equatorCircumference / distance)) + 1);
-  }
-
-  _getHeightByZoomLevel(level) {
-    const equatorCircumference = 6378137 * 2 * Math.PI;
-    return equatorCircumference / Math.pow(2, Math.max(0, level - 1));
-  }
+const Cesium$4 = getCesium();
+
+/**
+ * 缩放控件
+ * 提供放大/缩小两个按钮，默认挂到 SDK 统一工具栏（xs3d-viewer-toolbar）。
+ */
+class Zoom extends BaseControl {
+  /**
+   * @param {object} options
+   * @param {number} [options.duration=0.5] 缩放动画时长（秒）
+   */
+  constructor(options = {}) {
+    super({
+      type: 'zoom',
+      ...options
+    });
+
+    this._duration = options.duration ?? 0.5;
+  }
+
+  _createContainer() {
+    const div = super._createContainer();
+    div.className += ' xs3d-zoom';
+    // 只有在统一工具栏内才使用 display: contents，让按钮直接参与工具栏 flex 布局；
+    // 自定义容器挂载时保留正常 absolute 定位，支持 top/left/right/bottom。
+    if (this._parentContainer?.classList?.contains('xs3d-viewer-toolbar')) {
+      div.style.display = 'contents';
+    }
+    return div;
+  }
+
+  _getParentContainer() {
+    if (this._options.container) {
+      return super._getParentContainer();
+    }
+    return this._getOrCreateToolbar();
+  }
+
+  _mount() {
+    this._clearAbsolutePositionIfInToolbar();
+
+    this._zoomInBtn = this._createButton('+', '放大');
+    this._zoomOutBtn = this._createButton('-', '缩小');
+
+    this._container.appendChild(this._zoomInBtn);
+    this._container.appendChild(this._zoomOutBtn);
+  }
+
+  _createButton(label, title) {
+    const btn = document.createElement('button');
+    btn.type = 'button';
+    btn.title = title;
+    btn.className = 'cesium-button cesium-toolbar-button xs3d-zoom-button';
+    btn.textContent = label;
+    btn.style.width = '32px';
+    btn.style.height = '32px';
+    btn.style.lineHeight = '1';
+    btn.style.fontSize = '18px';
+    btn.style.fontWeight = 'bold';
+    btn.style.display = 'flex';
+    btn.style.alignItems = 'center';
+    btn.style.justifyContent = 'center';
+    btn.style.cursor = 'pointer';
+    // 在统一工具栏内按 order 排列：指南针 -1，放大 1，缩小 2
+    btn.style.order = label === '+' ? '1' : '2';
+    return btn;
+  }
+
+  _bindEvents() {
+    this._addDomEvent(this._zoomInBtn, 'click', (e) => {
+      e.stopPropagation();
+      this._zoomIn();
+    });
+
+    this._addDomEvent(this._zoomOutBtn, 'click', (e) => {
+      e.stopPropagation();
+      this._zoomOut();
+    });
+  }
+
+  _zoomIn() {
+    this._zoomBy(1);
+  }
+
+  _zoomOut() {
+    this._zoomBy(-1);
+  }
+
+  /**
+   * 按地图层级步进缩放
+   * @param {number} levelDelta 层级变化量，+1 放大一级，-1 缩小一级
+   */
+  _zoomBy(levelDelta) {
+    const camera = this._viewer.camera;
+    const cartographic = camera.positionCartographic;
+    const currentLevel = this._getZoomLevel();
+    const targetLevel = Math.max(0, Math.min(24, currentLevel + levelDelta));
+    const targetHeight = this._getHeightByZoomLevel(targetLevel);
+
+    camera.flyTo({
+      destination: Cesium$4.Cartesian3.fromRadians(
+        cartographic.longitude,
+        cartographic.latitude,
+        targetHeight
+      ),
+      orientation: {
+        heading: camera.heading,
+        pitch: camera.pitch,
+        roll: camera.roll
+      },
+      duration: this._duration
+    });
+  }
+
+  _getZoomLevel() {
+    const positionCartographic = this._viewer.camera.positionCartographic;
+    const surfaceCartesian = Cesium$4.Cartesian3.fromRadians(
+      positionCartographic.longitude,
+      positionCartographic.latitude,
+      0
+    );
+    const distance = Cesium$4.Cartesian3.distance(this._viewer.camera.position, surfaceCartesian);
+    if (!distance || distance <= 0 || !Number.isFinite(distance)) return 0;
+    const equatorCircumference = 6378137 * 2 * Math.PI;
+    return Math.max(0, Math.floor(Math.log2(equatorCircumference / distance)) + 1);
+  }
+
+  _getHeightByZoomLevel(level) {
+    const equatorCircumference = 6378137 * 2 * Math.PI;
+    return equatorCircumference / Math.pow(2, Math.max(0, level - 1));
+  }
 }
 
 const Cesium$3 = getCesium();