mars3d 3.3.0 → 3.3.3

package/dist/mars3d.d.ts

@@ -1,9 +1,9 @@
 
 /**
- * Mars3D三维可视化平台  mars3d-sdk
+ * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.3.0
- * 编译日期：2022-03-18 17:26:21
+ * 版本信息：v3.3.3
+ * 编译日期：2022-04-06 12:18:57
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2022-02-01
  */
@@ -24,7 +24,7 @@ declare const provider: any
 /**
  * 国内偏移坐标系 枚举
  */
-declare const enum ChinaCRS {
+declare enum ChinaCRS {
     /**
      * 标准无偏坐标系
      */
@@ -42,7 +42,7 @@ declare const enum ChinaCRS {
 /**
  * 裁剪模型类型
  */
-declare const enum ClipType {
+declare enum ClipType {
     /**
      * z水平面, 切底部
      */
@@ -72,7 +72,7 @@ declare const enum ClipType {
 /**
  * 控件类型
  */
-declare const enum ControlType {
+declare enum ControlType {
     clockAnimate,
     compass,
     distanceLegend,
@@ -86,7 +86,7 @@ declare const enum ControlType {
 /**
  * 坐标系 枚举
  */
-declare const enum CRS {
+declare enum CRS {
     /**
      * Web墨卡托投影坐标系
      */
@@ -124,7 +124,7 @@ declare const enum CRS {
 /**
  * 特效类型
  */
-declare const enum EffectType {
+declare enum EffectType {
     blackAndWhite,
     bloom,
     brightness,
@@ -142,7 +142,7 @@ declare const enum EffectType {
 /**
  * 事件类型 枚举（所有事件统一的入口）
  */
-declare const enum EventType {
+declare enum EventType {
     /**
      * 添加对象
      */
@@ -522,7 +522,7 @@ declare const enum EventType {
 /**
  * 矢量数据类型
  */
-declare const enum GraphicType {
+declare enum GraphicType {
     label,
     labelP,
     point,
@@ -620,7 +620,7 @@ declare const enum GraphicType {
  * @example
  * mars3d.Lang["_单击开始绘制"][mars3d.LangType.ZH] ="新的中文提示语句";
  */
-declare const enum Lang {
+declare enum Lang {
     "_放大" = "[\"\u653E\u5927\",\"\u653E\u5927\",\"Zoom In\"]",
     "_缩小" = "[\"\u7F29\u5C0F\",\"\u7E2E\u5C0F\",\"Zoom Out\"]",
     "_查看此处坐标" = "[\"\u67E5\u770B\u6B64\u5904\u5750\u6807\",\"\u67E5\u770B\u6B64\u8655\u5750\u6A19\",\"Location info\"]",
@@ -740,7 +740,7 @@ declare const enum Lang {
 /**
  * 语言类型  枚举
  */
-declare const enum LangType {
+declare enum LangType {
     /**
      * 简体中文
      */
@@ -758,7 +758,7 @@ declare const enum LangType {
 /**
  * 图层类型
  */
-declare const enum LayerType {
+declare enum LayerType {
     tdt,
     baidu,
     gaode,
@@ -1105,7 +1105,7 @@ declare namespace MaterialType {
 /**
  * 相机旋转的类型
  */
-declare const enum MoveType {
+declare enum MoveType {
     /**
      * 向屏幕中心靠近
      */
@@ -1135,7 +1135,7 @@ declare const enum MoveType {
 /**
  * 状态 枚举
  */
-declare const enum State {
+declare enum State {
     /**
      * 初始化
      */
@@ -1157,7 +1157,7 @@ declare const enum State {
 /**
  * 地形类型
  */
-declare const enum TerrainType {
+declare enum TerrainType {
     /**
      * 无地形
      */
@@ -1572,7 +1572,7 @@ declare class MapSplit extends BaseControl {
      * @param splitDirection - 图层显示的方向
      * @returns 无
      */
-    setLayerSplitDirection(layer: BaseTileLayer | GroupLayer, splitDirection: Cesium.ImagerySplitDirection): void;
+    setLayerSplitDirection(layer: BaseTileLayer | GroupLayer, splitDirection: Cesium.SplitDirection): void;
     /**
      * 控件类型
      */
@@ -1773,6 +1773,7 @@ declare class ToolButton extends BaseControl {
 /**
  * 放大缩小按钮控件
  * @param [options] - 参数对象，包括以下：
+ * @param [options.relativeAmount = 2] - 放大缩小的相对量（调整步长）
  * @param [options.zoomOutIcon] - 缩小按钮 图片url路径 或 字体图标class名
  * @param [options.zoomInIcon] - 放大按钮 图片url路径 或 字体图标class名
  * @param [options.id = uuid()] - 对象的id标识
@@ -1783,6 +1784,7 @@ declare class ToolButton extends BaseControl {
  */
 declare class Zoom extends BaseControl {
     constructor(options?: {
+        relativeAmount?: string;
         zoomOutIcon?: string;
         zoomInIcon?: string;
         id?: string | number;
@@ -2587,8 +2589,8 @@ declare class SnowEffect extends BaseEffect {
 declare namespace Globe {
     /**
      * Popup或Tooltip配置的数组方式对象
-     * @property field - 字段名称
-     * @property name - 显示的对应自定义名称
+     * @property [field] - 字段名称
+     * @property [name] - 显示的对应自定义名称
      * @property [type] - 默认为label文本，也可以支持：'button'按钮，'html' html内容。
      * @property [callback] - 当type为'button'按钮时，单击后触发的事件。
      * @property [html] - 当type为'html'时，对于拼接的html内容。
@@ -2597,8 +2599,8 @@ declare namespace Globe {
      * @property [className] - 自定义样式名称
      */
     type getTemplateHtml_template = {
-        field: string;
-        name: string;
+        field?: string;
+        name?: string;
         type?: string;
         callback?: string;
         html?: string;
@@ -5024,6 +5026,19 @@ declare class DivGraphic extends BaseGraphic {
      * @returns 无
      */
     closeHighlight(): void;
+    /**
+     * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PointUtil#getSurfaceHeight}方法处理。
+     * @param [options = {}] - 参数对象:
+     * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
+     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param options.callback - 异步计算高度完成后 的回调方法
+     * @returns 当前对象本身，可以链式调用
+     */
+    autoSurfaceHeight(options?: {
+        has3dtiles?: boolean;
+        objectsToExclude?: any;
+        callback: Globe.getSurfaceHeight_callback;
+    }): BasePointEntity;
     /**
      * 开始绘制创建矢量数据，绘制的数据会加载在layer图层。
      * @param layer - 图层
@@ -5722,6 +5737,8 @@ declare class BaseEntity extends BaseGraphic {
  * @param [options.clampToTileset] - 当使用addDynamicPosition设置为动画轨迹位置时，是否进行贴模型。
  * @param [options.frameRateClamp = 30] - 当使用addDynamicPosition设置为动画轨迹位置时，并clampToTileset：true时，多少帧计算一次贴模型高度
  * @param [options.objectsToExclude] - 当使用addDynamicPosition设置为动画轨迹位置时，并clampToTileset：true时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+ * @param [options.referenceFrame = Cesium.ReferenceFrame.FIXED] - 当使用addDynamicPosition设置为动画轨迹位置时，position位置被定义的参考系。
+ * @param [options.numberOfDerivatives = 0] - 当使用addDynamicPosition设置为动画轨迹位置时，每个位置的导数的数量;即速度、加速度等。
  * @param [options.popup] - 绑定的popup弹窗值，也可以bindPopup方法绑定
  * @param [options.popupOptions] - popup弹窗时的配置参数，也支持如pointerEvents等{@link Popup}构造参数
  * @param [options.tooltip] - 绑定的tooltip弹窗值，也可以bindTooltip方法绑
@@ -5754,6 +5771,8 @@ declare class BasePointEntity extends BaseEntity {
         clampToTileset?: boolean;
         frameRateClamp?: number;
         objectsToExclude?: any;
+        referenceFrame?: Cesium.ReferenceFrame;
+        numberOfDerivatives?: number;
         popup?: string | any[] | ((...params: any[]) => any);
         popupOptions?: Popup.StyleOptions;
         tooltip?: string | any[] | ((...params: any[]) => any);
@@ -5843,14 +5862,14 @@ declare class BasePointEntity extends BaseEntity {
      */
     addDynamicPosition(point: LngLatPoint | Cesium.Cartesian3 | number[], currTime?: Cesium.JulianDate | Date | string | number): BasePointEntity;
     /**
-     * 异步计算更新坐标进行贴地(或贴模型)
+     * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PointUtil#getSurfaceHeight}方法处理。
      * @param [options = {}] - 参数对象:
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
      * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 当前对象本身，可以链式调用
      */
-    clampToGround(options?: {
+    autoSurfaceHeight(options?: {
         has3dtiles?: boolean;
         objectsToExclude?: any;
         callback: Globe.getSurfaceHeight_callback;
@@ -5993,7 +6012,7 @@ declare class BasePolyEntity extends BaseEntity {
      */
     isInPoly(position: Cesium.Cartesian3 | LngLatPoint): boolean;
     /**
-     * 异步计算更新坐标进行贴地(或贴模型)
+     * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PolyUtil#computeSurfacePoints}方法处理。
      * @param [options = {}] - 参数对象:
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
      * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
@@ -6001,7 +6020,7 @@ declare class BasePolyEntity extends BaseEntity {
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 当前对象本身，可以链式调用
      */
-    clampToGround(options?: {
+    autoSurfaceHeight(options?: {
         has3dtiles?: boolean;
         objectsToExclude?: any;
         offset?: number;
@@ -8092,6 +8111,8 @@ declare namespace ModelEntity {
  * @param [options.clampToTileset] - 当使用addDynamicPosition设置为动画轨迹位置时，是否进行贴模型。
  * @param [options.frameRateHeight = 30] - 当使用addDynamicPosition设置为动画轨迹位置时，并clampToTileset：true时，多少帧计算一次贴模型高度
  * @param [options.objectsToExclude] - 当使用addDynamicPosition设置为动画轨迹位置时，并clampToTileset：true时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+ * @param [options.referenceFrame = Cesium.ReferenceFrame.FIXED] - 当使用addDynamicPosition设置为动画轨迹位置时，position位置被定义的参考系。
+ * @param [options.numberOfDerivatives = 0] - 当使用addDynamicPosition设置为动画轨迹位置时，每个位置的导数的数量;即速度、加速度等。
  * @param [options.drawShow = true] - 绘制时，是否自动隐藏entity，可避免拾取坐标存在问题。
  * @param [options.addHeight] - 在绘制时，在绘制点的基础上增加的高度值
  * @param [options.popup] - 绑定的popup弹窗值，也可以bindPopup方法绑定
@@ -8122,6 +8143,8 @@ declare class ModelEntity extends BasePointEntity {
         clampToTileset?: boolean;
         frameRateHeight?: number;
         objectsToExclude?: any;
+        referenceFrame?: Cesium.ReferenceFrame;
+        numberOfDerivatives?: number;
         drawShow?: boolean;
         addHeight?: number;
         popup?: string | any[] | ((...params: any[]) => any);
@@ -9875,6 +9898,13 @@ declare class AttackArrow extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): AttackArrow;
+    /**
+     * 计算当前军标对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -9931,6 +9961,13 @@ declare class AttackArrowPW extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): AttackArrowPW;
+    /**
+     * 计算当前军标对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -9987,6 +10024,13 @@ declare class AttackArrowYW extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): AttackArrowYW;
+    /**
+     * 计算当前军标对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -10043,6 +10087,13 @@ declare class CloseVurve extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): CloseVurve;
+    /**
+     * 计算当前军标对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -10099,6 +10150,13 @@ declare class DoubleArrow extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): DoubleArrow;
+    /**
+     * 计算当前军标对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -10167,6 +10225,13 @@ declare class FineArrow extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): FineArrow;
+    /**
+     * 计算当前军标对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -10223,6 +10288,13 @@ declare class FineArrowYW extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): FineArrowYW;
+    /**
+     * 计算当前军标对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -10279,6 +10351,13 @@ declare class GatheringPlace extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): GatheringPlace;
+    /**
+     * 计算当前军标对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -10335,6 +10414,13 @@ declare class IsosTriangle extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): IsosTriangle;
+    /**
+     * 计算当前矢量对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: Cesium.Cartesian3[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -10391,6 +10477,13 @@ declare class Lune extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): Lune;
+    /**
+     * 计算当前军标对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -10458,6 +10551,20 @@ declare class Regular extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): Regular;
+    /**
+     * 计算当前矢量对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param options - 控制参数
+     * @param [options.border = 3] - 边数量
+     * @param options.radius - 区域的半径（单位：米）
+     * @param [options.startAngle = 0] - 区域的开始角度(正东方向为0,顺时针到360度)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: Cesium.Cartesian3[], options: {
+        border?: number;
+        radius: number;
+        startAngle?: number;
+    }): Cesium.Cartesian3[];
     /**
      * 位置坐标数组 （笛卡尔坐标）, 赋值时可以传入LatLngPoint数组对象 或 Cesium.PolygonHierarchy
      */
@@ -10529,6 +10636,20 @@ declare class Sector extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): Sector;
+    /**
+     * 计算当前矢量对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param options - 控制参数
+     * @param options.radius - 扇形区域的半径（单位：米）
+     * @param options.startAngle - 扇形区域的开始角度(正东方向为0,顺时针到360度)
+     * @param options.endAngle - 扇形区域的结束角度(正东方向为0,顺时针到360度)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: Cesium.Cartesian3[], options: {
+        radius: number;
+        startAngle: number;
+        endAngle: number;
+    }): Cesium.Cartesian3[];
     /**
      * 位置坐标数组 （笛卡尔坐标）, 赋值时可以传入LatLngPoint数组对象 或 Cesium.PolygonHierarchy
      */
@@ -10589,6 +10710,13 @@ declare class StraightArrow extends PolygonEntity {
      * @returns 矢量对象
      */
     static fromDraw(layer: GraphicLayer, options: any): StraightArrow;
+    /**
+     * 计算当前军标对象的边界坐标点
+     * @param positions - 坐标位置
+     * @param [options] - 控制参数(预留)
+     * @returns 边界坐标点
+     */
+    static getOutlinePositions(positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[], options?: any): Cesium.Cartesian3[];
 }
 
 /**
@@ -11247,10 +11375,16 @@ declare class SectionMeasure extends DistanceMeasure {
  * @param [options.attr] - 附件的属性信息，可以任意附加属性，导出geojson或json时会自动处理导出。
  * @param [options.polygonWallStyle] - 围墙面的样式
  * @param [options.label] - 测量结果文本的样式
+ * @param [options.showFillVolume = true] - 是否显示填方体积结果文本
+ * @param [options.fillVolumeName = '填方体积'] - 填方体积结果的名称
+ * @param [options.showDigVolume = true] - 是否显示挖方体积结果文本
+ * @param [options.digVolumeName = '挖方体积'] - 挖方体积结果的名称
+ * @param [options.showArea = true] - 是否显示横切面积结果文本
+ * @param [options.areaName = '横切面积'] - 横切面积结果的名称
  * @param [options.heightLabel = true] - 是否显示各边界点高度值文本
  * @param [options.offsetLabel = false] - 是否显示各边界点高度差文本
  * @param [options.labelHeight] - 各边界点高度结果文本的样式
- * @param [options.showArea = true] - 是否显示横切面积
+ * @param [options.has3dtiles] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
  * @param [options.id = uuid()] - 矢量数据id标识
  * @param [options.name = ''] - 矢量数据名称
  * @param [options.show = true] - 矢量数据是否显示
@@ -11263,10 +11397,16 @@ declare class VolumeMeasure extends AreaMeasure {
         attr?: any;
         polygonWallStyle?: PolygonEntity.StyleOptions;
         label?: LabelEntity.StyleOptions;
+        showFillVolume?: boolean;
+        fillVolumeName?: string;
+        showDigVolume?: boolean;
+        digVolumeName?: string;
+        showArea?: boolean;
+        areaName?: string;
         heightLabel?: boolean;
         offsetLabel?: boolean;
         labelHeight?: LabelEntity.StyleOptions;
-        showArea?: boolean;
+        has3dtiles?: boolean;
         id?: string | number;
         name?: string;
         show?: boolean;
@@ -11451,14 +11591,14 @@ declare class BasePointPrimitive extends BasePrimitive {
      */
     addDynamicPosition(point: LngLatPoint | Cesium.Cartesian3 | number[], currTime?: Cesium.JulianDate | Date | string | number): BasePointPrimitive;
     /**
-     * 异步计算更新坐标进行贴地(或贴模型)
+     * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PointUtil#getSurfaceHeight}方法处理。
      * @param [options = {}] - 参数对象:
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
      * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 当前对象本身，可以链式调用
      */
-    clampToGround(options?: {
+    autoSurfaceHeight(options?: {
         has3dtiles?: boolean;
         objectsToExclude?: any;
         callback: Globe.getSurfaceHeight_callback;
@@ -11581,7 +11721,7 @@ declare class BasePolyPrimitive extends BasePrimitive {
      */
     isInPoly(position: Cesium.Cartesian3 | LngLatPoint): boolean;
     /**
-     * 异步计算更新坐标进行贴地(或贴模型)
+     * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PolyUtil#computeSurfacePoints}方法处理。
      * @param [options = {}] - 参数对象:
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
      * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
@@ -11589,7 +11729,7 @@ declare class BasePolyPrimitive extends BasePrimitive {
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 当前对象本身，可以链式调用
      */
-    clampToGround(options?: {
+    autoSurfaceHeight(options?: {
         has3dtiles?: boolean;
         objectsToExclude?: any;
         offset?: number;
@@ -16022,7 +16162,7 @@ declare namespace CzmGeoJsonLayer {
  * @param [options.url] - geojson文件或服务url地址
  * @param [options.data] - geojson格式规范数据对象，与url二选一即可。
  * @param [options.format] - 可以对加载的geojson数据进行格式化或转换操作
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.opacity = 1] - 透明度，取值范围：0.0-1.0
  * @param [options.symbol] - 矢量数据的style样式
  * @param options.symbol.styleOptions - 数据的Style样式
@@ -17175,15 +17315,32 @@ declare class GraphicGroupLayer extends GroupLayer {
     getRectangle(isFormat?: boolean): Cesium.Rectangle | any;
     /**
      * 开始绘制矢量数据，绘制的数据会加载在当前图层。
-     * @param options - Graphic构造参数,包含：
+     * @param options - 绘制参数，包含：
      * @param options.type - 类型
      * @param [options.style] - 矢量数据样式，具体参考支持 {@link GraphicType}查询对应type的类
-     * @returns 创建完成的矢量数据对象
+     * @param [options.attr] - 矢量数据的 属性信息，可以任意附加属性。
+     * @param [options.success] - 绘制创建完成的回调方法，同drawCreated事件，例如： success: function (graphic){  }
+     * //以下为Entity支持的构造参数
+     * @param [options.name] - 矢量数据名称
+     * @param [options.maxPointNum] - 线面数据时限定的最大坐标个数
+     * @param [options.drawShow = true] - 绘制时，是否自动隐藏entity，可避免拾取坐标存在问题。
+     * @param [options.addHeight] - 在绘制时，在绘制点的基础上增加的高度值
+     * @param [options.availability] - 与该对象关联的可用性(如果有的话)。
+     * @param [options.description] - 指定此实体的HTML描述的字符串属性（infoBox中展示）。
+     * @returns 绘制创建完成的Promise,等价于success参数
      */
     startDraw(options: {
         type: GraphicType | string;
         style?: any;
-    }): BaseGraphic | any;
+        attr?: any;
+        success?: (...params: any[]) => any;
+        name?: string;
+        maxPointNum?: number;
+        drawShow?: boolean;
+        addHeight?: number;
+        availability?: Cesium.TimeIntervalCollection;
+        description?: Cesium.Property | string;
+    }): Promise<BaseGraphic | any>;
     /**
      * 停止绘制，如有未完成的绘制会自动删除
      * @returns 当前对象本身,可以链式调用
@@ -17277,7 +17434,7 @@ declare namespace GraphicLayer {
  * @param [options.isContinued = false] - 是否连续标绘,联系标绘状态下无法编辑已有对象。
  * @param [options.isRestorePositions = false] - 在标绘和编辑结束时，是否将坐标还原为普通值，true: 停止编辑时会有闪烁，但效率要好些。
  * @param [options.allowDrillPick] - 是否允许鼠标穿透拾取
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效，且只有贴地对象有效)。
  * @param [options.symbol] - 矢量数据的style样式,为Function时是完全自定义的回调处理 symbol(attr, style, feature)
  * @param [options.symbol.type] - 标识数据类型，默认是根据数据生成 point、polyline、polygon
  * @param options.symbol.styleOptions - Style样式，每种不同类型数据都有不同的样式，具体见各{@link GraphicType}矢量数据的style参数。
@@ -17546,16 +17703,43 @@ declare class GraphicLayer extends BaseGraphicLayer {
      * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @param options.endItem - 异步计算高度完成后 的回调方法
-     * @returns 当前对象本身，可以链式调用
+     * @returns 绘制创建完成的Promise,等价于callback参数
      */
-    clampToGround(options?: {
+    autoSurfaceHeight(options?: {
         has3dtiles?: boolean;
         objectsToExclude?: any;
         callback: (...params: any[]) => any;
         endItem: (...params: any[]) => any;
-    }): GraphicLayer;
+    }): Promise<BaseGraphic | any>;
     /**
      * 开始绘制矢量数据，绘制的数据会加载在当前图层。
+     * @example
+     * //写法一，使用Promise
+     *     graphicLayer.startDraw({
+     *       type: "point",
+     *       style: { pixelSize: 12, color: "#3388ff" },
+     *     })
+     *     .then(function (graphic) {
+     *       console.log("绘制矢量对象完成", graphic);
+     *     });
+     *
+     *     //写法二，使用success回调方法参数
+     *     graphicLayer.startDraw({
+     *       type: "point",
+     *       style: { pixelSize: 12, color: "#3388ff" },
+     *       success: function (graphic){
+     *         console.log("绘制矢量对象完成", graphic);
+     *       }
+     *     })
+     *
+     *     //写法三，在图层全局监听完成事件
+     *     graphicLayer.on(mars3d.EventType.drawCreated, function (e) {
+     *       console.log("绘制矢量对象完成", e);
+     *     });
+     *     graphicLayer.startDraw({
+     *       type: "point",
+     *       style: { pixelSize: 12, color: "#3388ff" }
+     *     })
      * @param options - 绘制参数，包含：
      * @param options.type - 类型
      * @param [options.style] - 矢量数据样式，具体参考支持 {@link GraphicType}查询对应type的类
@@ -17568,7 +17752,7 @@ declare class GraphicLayer extends BaseGraphicLayer {
      * @param [options.addHeight] - 在绘制时，在绘制点的基础上增加的高度值
      * @param [options.availability] - 与该对象关联的可用性(如果有的话)。
      * @param [options.description] - 指定此实体的HTML描述的字符串属性（infoBox中展示）。
-     * @returns 创建完成的矢量数据对象
+     * @returns 绘制创建完成的Promise,等价于success参数
      */
     startDraw(options: {
         type: GraphicType | string;
@@ -17581,7 +17765,7 @@ declare class GraphicLayer extends BaseGraphicLayer {
         addHeight?: number;
         availability?: Cesium.TimeIntervalCollection;
         description?: Cesium.Property | string;
-    }): BaseGraphic | any;
+    }): Promise<BaseGraphic | any>;
     /**
      * 停止绘制，如有未完成的绘制会自动删除
      * @returns 当前对象本身,可以链式调用
@@ -17944,7 +18128,7 @@ declare class LodGraphicLayer extends GraphicLayer {
  * @param [options.isAutoEditing = true] - 完成标绘时是否自动启动编辑(需要hasEdit:true时)
  * @param [options.isContinued = false] - 是否连续标绘
  * @param [options.isRestorePositions = false] - 在标绘和编辑结束时，是否将坐标还原为普通值，true: 停止编辑时会有闪烁，但效率要好些。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.symbol] - 矢量数据的style样式,为Function时是完全自定义的回调处理 symbol(attr, style, feature)
  * @param [options.symbol.type] - 标识数据类型，默认是根据数据生成 point、polyline、polygon
  * @param options.symbol.styleOptions - Style样式，每种不同类型数据都有不同的样式，具体见各{@link GraphicType}矢量数据的style参数。
@@ -18950,7 +19134,7 @@ declare class TerrainLayer extends BaseLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -19109,7 +19293,7 @@ declare namespace ArcGisLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.enablePickFeatures = true] - 如果为true，则请求 单击坐标处服务中对应的矢量数据 并尝试解释响应中包含的功能。为false时不去服务请求。
@@ -19291,7 +19475,7 @@ declare class ArcGisLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -19432,7 +19616,7 @@ declare class ArcGisTileLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.chinaCRS = ChinaCRS.BAIDU] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
  * @param [options.templateValues] - 一个对象，用于替换Url中的模板值的键/值对
@@ -19595,7 +19779,7 @@ declare namespace BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -19845,7 +20029,7 @@ declare class BaseTileLayer extends BaseLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -20072,7 +20256,7 @@ declare class EmptyTileLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.chinaCRS = ChinaCRS.GCJ02] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
  * @param [options.templateValues] - 一个对象，用于替换Url中的模板值的键/值对
@@ -20202,7 +20386,7 @@ declare class GaodeLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -20339,7 +20523,7 @@ declare class GeeLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS = 'GCJ02'] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -20474,7 +20658,7 @@ declare class GoogleLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.opacity = 1.0] - 透明度，取值范围：0.0-1.0。
@@ -20587,7 +20771,7 @@ declare class GridLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -20713,7 +20897,7 @@ declare class ImageLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -20850,7 +21034,7 @@ declare class IonLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -20986,7 +21170,7 @@ declare class MapboxLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
  * @param [options.templateValues] - 一个对象，用于替换Url中的模板值的键/值对
  * @param [options.queryParameters] - 一个对象，其中包含在检索资源时将发送的查询参数。比如：queryParameters: {'access_token': '123-435-456-000'},
@@ -21117,7 +21301,7 @@ declare class OsmLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影,也支持传入EPSG4490坐标系
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -21252,7 +21436,7 @@ declare class TdtLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.chinaCRS = ChinaCRS.GCJ02] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
  * @param [options.templateValues] - 一个对象，用于替换Url中的模板值的键/值对
@@ -21376,7 +21560,7 @@ declare class TencentLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.opacity = 1.0] - 透明度，取值范围：0.0-1.0。
  * @param [options.alpha = 1.0] - 同opacity。
  * @param [options.nightAlpha = 1.0] - 当 enableLighting 为 true 时 ，在地球的夜晚区域的透明度，取值范围：0.0-1.0。
@@ -21482,7 +21666,7 @@ declare class TileInfoLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -21638,7 +21822,7 @@ declare class TmsLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.opacity = 1.0] - 透明度，取值范围：0.0-1.0。
  * @param [options.alpha = 1.0] - 同opacity。
@@ -21821,7 +22005,7 @@ declare class WmsLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -21996,7 +22180,7 @@ declare class WmtsLayer extends BaseTileLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -22317,6 +22501,7 @@ declare namespace Map {
      * @property [globe.enableLighting = false] - 是否显示昼夜区域
      * @property [globe.tileCacheSize = 100] - 地形图块缓存的大小，表示为图块数。任何其他只要不需要渲染，就会释放超出此数目的图块这个框架。较大的数字将消耗更多的内存，但显示细节更快例如，当缩小然后再放大时。
      * @property [globe.terrainExaggeration = 1.0] - 地形夸张倍率，用于放大地形的标量。请注意，地形夸张不会修改其他相对于椭球的图元。
+     * @property [globe.realAlt = false] - 地形夸张倍率，在测量高度和下侧提示的高度信息中是否转换为实际真实高度值。
      * @property [globe.terrainExaggerationRelativeHeight = 0.0] - 地形被夸大的高度。默认为0.0（相对于椭球表面缩放）。高于此高度的地形将向上缩放，低于此高度的地形将向下缩放。请注意，地形夸大不会修改任何其他图元，因为它们是相对于椭球体定位的。
      *
      * 以下是Cesium.ScreenSpaceCameraController对象相关参数
@@ -22386,6 +22571,7 @@ declare namespace Map {
             enableLighting?: boolean;
             tileCacheSize?: number;
             terrainExaggeration?: number;
+            realAlt?: number;
             terrainExaggerationRelativeHeight?: number;
         };
         cameraController?: {
@@ -22852,6 +23038,12 @@ declare class Map extends BaseClass {
         formatNum?: boolean;
         scale?: number;
     }): any;
+    /**
+     * 当存在地形夸张时，获取其实际的高度值
+     * @param alt - 鼠标拾取的高度值
+     * @returns 其实际的高度值
+     */
+    getRealAlt(alt: number): number;
     /**
      * 截图，导出地图场景图片
      * @param [options = {}] - 参数对象:
@@ -22872,7 +23064,7 @@ declare class Map extends BaseClass {
         type?: string;
         encoderOptions?: number;
         callback?: (...params: any[]) => any;
-    }): void;
+    }): Promise<any>;
     /**
      * 设置鼠标的默认状态样式
      * @param [val] - cursor样式
@@ -24612,6 +24804,7 @@ declare class EchartsLayer extends BaseLayer {
  * @param [options.style.arcRadiusScale = 1.5] - 曲面热力图时，radius扩大比例
  * @param [options.style.arcBlurScale = 1.5] - 曲面热力图时，blur扩大比例
  * @param [options.style.height = 0] - 高度，相对于椭球面的高度。
+ * @param [options.style.diffHeight] - 曲面的起伏差值高，默认根据数据范围的比例自动计算。
  * @param [options.style.多个参数] - rectangle矩形支持的样式
  * @param [options.maxCanvasSize = 5000] - Canvas最大尺寸（单位：像素），调大精度更高，但过大容易内存溢出
  * @param [options.minCanvasSize = 700] - Canvas最小尺寸（单位：像素）
@@ -24646,6 +24839,7 @@ declare class HeatLayer extends BaseLayer {
             arcRadiusScale?: boolean;
             arcBlurScale?: boolean;
             height?: number;
+            diffHeight?: number;
             多个参数?: RectanglePrimitive.StyleOptions;
         };
         maxCanvasSize?: number;
@@ -24826,7 +25020,7 @@ declare class MapVLayer extends BaseLayer {
 /**
  * 视锥体的类型
  */
-declare const enum SensorType {
+declare enum SensorType {
     /**
      * 四棱锥
      */
@@ -25926,7 +26120,7 @@ declare class S3MLayer extends BaseLayer {
  * @param options.rectangle.ymin - 最小纬度值, -90 至 90
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
- * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
+ * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
  * @param [options.crs = CRS.EPSG:3857] - 瓦片数据的坐标系信息，默认为墨卡托投影
  * @param [options.chinaCRS] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
@@ -26486,7 +26680,7 @@ declare class BaseWidget extends BaseClass {
  * widget事件类型枚举, mars3d.widget.EventType
  * 【需要引入  mars3d-widget 插件库】
  */
-declare const enum WidgetEventType {
+declare enum WidgetEventType {
     /**
      * 在实例初始化之后、创建之前执行
      */
@@ -27502,7 +27696,7 @@ declare class QueryArcServer extends BaseClass {
      * @param [queryOptions.page = true] - 是否分页查询,false时不分页，一次性查询返回
      * @param [queryOptions.success] - 查询完成的回调方法
      * @param [queryOptions.error] - 查询失败的回调方法
-     * @returns 当前对象本身，可以链式调用
+     * @returns 查询完成的Promise,等价于success参数
      */
     query(queryOptions: {
         text?: string;
@@ -27513,7 +27707,7 @@ declare class QueryArcServer extends BaseClass {
         page?: boolean;
         success?: (...params: any[]) => any;
         error?: (...params: any[]) => any;
-    }): QueryArcServer;
+    }): Promise<any>;
     /**
      * 清除
      * @returns 无
@@ -27818,7 +28012,7 @@ declare class Measure extends BaseThing {
      * @param [options.style] - 基准面的样式
      * @param [options.unit = 'auto'] - 计量单位,{@link MeasureUtil#formatArea}可选值：auto、m、km、mu、ha 。auto时根据面积值自动选用k或km
      * @param [options.splitNum = 10] - 插值数，将面分割的网格数
-     * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
+     * @param [options.has3dtiles] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
      * @param [options.minHeight] - 可以指定最低高度（单位：米）
      * @param [options.maxHeight] - 可以指定最高高度（单位：米）
      * @param [options.height] - 可以指定基准面高度（单位：米），默认是绘制后的最低高度值
@@ -29069,6 +29263,77 @@ declare namespace ModelPlanClip {
     }
 }
 
+/**
+ * 3dtiles模型box盒子裁剪，
+ * 基于clippingPlanes接口，只支持单个开挖。
+ * @param [options] - 参数对象，包括以下：
+ * @param options.layer - 需要裁剪的对象（3dtiles图层）
+ * @param options.position - 裁剪盒子中心坐标位置
+ * @param options.dimensions - 裁剪盒子区域的长度、宽度和高度
+ * @param [options.showBox = false] - 是否显示box盒子
+ * @param [options.boxStyle] - box盒子显示时的样式
+ * @param [options.clipOutSide = false] - 是否外裁剪
+ * @param [options.edgeWidth = 0] - 裁剪区域边线宽度，0时不显示
+ * @param [options.edgeColor = Cesium.Color.WHITE] - 裁剪区域边线颜色
+ * @param [options.id = uuid()] - 对象的id标识
+ * @param [options.enabled = true] - 对象的启用状态
+ * @param [options.eventParent] - 指定的事件冒泡对象，默认为所加入的map对象，false时不冒泡事件
+ */
+declare class TilesetBoxClip extends BaseThing {
+    constructor(options?: {
+        layer: TilesetLayer;
+        position: LngLatPoint | Cesium.Cartesian3;
+        dimensions: Cesium.Cartesian3;
+        showBox?: boolean;
+        boxStyle?: BoxEntity.StyleOptions;
+        clipOutSide?: boolean;
+        edgeWidth?: number;
+        edgeColor?: Cesium.Color;
+        id?: string | number;
+        enabled?: boolean;
+        eventParent?: BaseClass | boolean;
+    });
+    /**
+     * 需要裁剪的对象（3dtiles图层）
+     */
+    layer: TilesetLayer;
+    /**
+     * 裁剪面集合
+     */
+    readonly planes: Cesium.ClippingPlaneCollection;
+    /**
+     * 获取当前转换计算模型逆矩阵，
+     * 用于 局部坐标系 与 世界坐标系 的转换。
+     */
+    readonly inverseMatrix: Cesium.Matrix4;
+    /**
+     * 模型当前中心点坐标
+     */
+    readonly center: Cesium.Cartesian3;
+    /**
+     * 裁剪box中心点坐标
+     */
+    position: number[] | LngLatPoint | Cesium.Cartesian3;
+    /**
+     * 裁剪box的长宽高
+     */
+    dimensions: Cesium.Cartesian3;
+    /**
+     * 是否显示box盒子
+     */
+    showBox: boolean;
+    /**
+     * 重新绘制
+     * @returns 无
+     */
+    redraw(): void;
+    /**
+     * 清除裁剪面
+     * @returns 无
+     */
+    clear(): void;
+}
+
 /**
  * 3dtiles模型裁剪
  * @param [options] - 参数对象，包括以下：
@@ -29305,6 +29570,7 @@ declare class TilesetFlood extends TilesetEditBase {
  * @param [options.edgeWidth = 0] - 裁剪区域边线宽度，0时不显示
  * @param [options.edgeColor = Cesium.Color.WHITE] - 裁剪区域边线颜色
  * @param [options.showPlane = false] - 是否显示裁剪平面
+ * @param [options.editPlane = false] - 是否可以拖拽裁剪平面进行编辑，需要showPlane：true时有效
  * @param [options.planeStyle] - 裁剪平面显示时的样式
  * @param [options.id = uuid()] - 对象的id标识
  * @param [options.enabled = true] - 对象的启用状态
@@ -29321,6 +29587,7 @@ declare class TilesetPlanClip extends BaseThing {
         edgeWidth?: number;
         edgeColor?: Cesium.Color;
         showPlane?: boolean;
+        editPlane?: boolean;
         planeStyle?: PlaneEntity.StyleOptions;
         id?: string | number;
         enabled?: boolean;
@@ -29340,10 +29607,9 @@ declare class TilesetPlanClip extends BaseThing {
      */
     readonly inverseMatrix: Cesium.Matrix4;
     /**
-     * 获取当前转换计算模型逆矩阵，
-     * 用于 局部坐标系 与 世界坐标系 的转换。
+     * 模型当前中心点坐标
      */
-    readonly center: Cesium.Matrix4;
+    readonly center: Cesium.Cartesian3;
     /**
      * 更新最后一个面的 裁剪距离 (单位：米)
      */
@@ -30359,6 +30625,12 @@ declare namespace MeasureUtil {
      * @returns 面积，单位：平方米
      */
     function getArea(positions: Cesium.Cartesian3[] | LngLatPoint[]): number;
+    /**
+     * 求坐标数组的 横切平面的面积（基于turf.area）
+     * @param positions - 坐标数组
+     * @returns 距离（单位：米）
+     */
+    function getSurfaceArea(positions: Cesium.Cartesian3[] | LngLatPoint[]): number;
     /**
      * 计算三角形面积（空间平面）
      * @param pos1 - 三角形顶点坐标1
@@ -30916,7 +31188,7 @@ declare namespace PolyUtil {
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @param [options.splitNum = 10] - 插值数，横纵等比分割的网格个数
      * @param [options.asyn = false] - 是否进行异步精确计算
-     * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
+     * @param [options.has3dtiles] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
      * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param [options.onlyPoint = false] - truea时，返回结果中只返回点，不返回三角网
      * @returns 仅 asyn:false 时返回计算结果值
@@ -32050,6 +32322,7 @@ declare namespace thing {
   export { LimitHeight }
   export { TilesetPlanClip }
   export { ModelPlanClip }
+  export { TilesetBoxClip }
 
   export { TilesetClip }
   export { TilesetFlat }