@baidumap/mapv-three 1.0.1 → 1.2.0

package/dist/types/threemap/engine/rendering/Label.d.ts

@@ -39,6 +39,8 @@ export class RenderingLabel {
     private _blocks;
     /** @private */
     private _collisionLabels;
+    _removalBuffer: any[];
+    _removalBufferSize: number;
     _timers: {};
     /** @private */
     private _enabled;
@@ -77,6 +79,7 @@ export class RenderingLabel {
     _labelTextFixed: any;
     _labelIconTextDataSource: DataSource | undefined;
     _labelIconText: any;
+    getLabelType(label: any): any;
     processLabel(label: any): any;
     /**
      * @internal
@@ -133,10 +136,12 @@ export class RenderingLabel {
         collision?: boolean | undefined;
         flat?: boolean | undefined;
     }): DataItem;
-    addLabels(labels: any, id: any): void;
+    addLabels(labels: any, id: any): any;
     _createLabelTask(labels: any): () => Promise<any>;
     computeBoundingBox(label: any): any;
     _checkRemoveCollisionLabel(collisionLabel: any, label: any): void;
+    _flushPartialRemovalBuffer(): void;
+    _clearLabelFromRemovalBuffer(type: any, groupKey: any): void;
     removeCollisionLabel(label: any): void;
     removeNormalLabel(label: any): void;
     /**

package/dist/types/threemap/engine/rendering/MicroTaskScheduler.d.ts

@@ -40,9 +40,13 @@ declare class MicroTask {
     priority: number;
     _isCancelled: boolean;
     _isStart: boolean;
+    _promise: Promise<any>;
+    _resolve: (value: any) => void;
+    _reject: (reason?: any) => void;
     execute(): void;
     cancel(): void;
     isCancelled(): boolean;
     isStart(): boolean;
+    get promise(): Promise<any>;
 }
 export {};

package/dist/types/threemap/mapView/baidu/TafficDataLoader.d.ts

@@ -0,0 +1,13 @@
+export namespace trafficDataLoader {
+    function requestTile(provider: any, tile: any): Promise<{
+        type: string;
+        tileKey: any;
+        content: {
+            data: {
+                attributes: Float32Array<ArrayBuffer>;
+                indices: Uint32Array<ArrayBuffer>;
+            } | null;
+        };
+        isNormalized: boolean;
+    }>;
+}

package/dist/types/threemap/mapView/constants.d.ts

@@ -1,6 +1,60 @@
+/**
+ * 快速加载策略，可能会出现空洞，通常用于矢量瓦片的加载策略。
+ */
 export const TILELOADER_STRATEGY_FAST: "fast";
+/**
+ * 层级加载策略，按照层级顺序从低级别到高级别加载瓦片，通常用于栅格瓦片的加载策略。
+ */
 export const TILELOADER_STRATEGY_HIERARCHICAL: "hierarchical";
+/**
+ * 地理坐标系网格，基于地理坐标系（经纬度）的地图网格
+ * @internal
+ */
 export const MAP_GRID_NAME_GEO: "geo";
+/**
+ * Web墨卡托投影网格，基于Web墨卡托投影的地图网格
+ * @internal
+ */
 export const MAP_GRID_NAME_WEB_MERCATOR: "web_mercator";
+/**
+ * 百度矢量在线网格
+ * @internal
+ */
 export const MAP_GRID_NAME_BD_VECTOR_ONLINE: "bd_vector_online";
+/**
+ * 百度矢量离线网格
+ * @internal
+ */
 export const MAP_GRID_NAME_BD_VECTOR_OFFLINE: "bd_vector_offline";
+/**
+ * 卫星影像样式，纯卫星影像，不包含任何标签或道路信息
+ */
+export const BING_MAP_STYLE_AERIAL: "Aerial";
+/**
+ * 带标签的卫星影像样式，卫星影像基础上叠加了地名、道路等标签信息
+ */
+export const BING_MAP_STYLE_AERIAL_WITH_LABELS: "AerialWithLabels";
+/**
+ * 道路地图样式，传统的道路地图样式，包含道路、地名、POI等信息
+ */
+export const BING_MAP_STYLE_ROAD: "Road";
+/**
+ * Stadia地图水彩图样式
+ */
+export const STADIA_MAP_STYLE_STAMEN_WATERCOLOR: "StamenWatercolor";
+/**
+ * Stadia地图素描图样式
+ */
+export const STADIA_MAP_STYLE_STAMEN_TONER: "StamenToner";
+/**
+ * Stadia地图AlidadeSmooth图样式
+ */
+export const STADIA_MAP_STYLE_ALIDE_SMOOTH: "AlidadeSmooth";
+/**
+ * Stadia地图AlidadeSmooth暗色图样式
+ */
+export const STADIA_MAP_STYLE_ALIDE_SMOOTH_DARK: "AlidadeSmoothDark";
+/**
+ * Stadia地图Outdoors图样式
+ */
+export const STADIA_MAP_STYLE_OUTDOORS: "Outdoors";

package/dist/types/threemap/mapView/geo/MapTile.d.ts

@@ -37,6 +37,7 @@ export class MapTile {
     private _targetSSESize;
     key: string;
     state: number;
+    epoch: number;
     childrenKeys: any[];
     loaderConfig: any;
     updateBoundingBoxZ(zMin: any, zMax: any): void;
@@ -65,6 +66,8 @@ export class MapTile {
      * tile在目标投影下的boundingBox，数值为在目标投影下的世界坐标
      */
     get targetBoundingBox(): any;
+    get targetGeoBoundingBox(): any;
+    _targetGeoBoundingBox: any;
     /**
      * tile在引擎projection下的中心点
      * targetCenter主要用于计算瓦片mesh的position

package/dist/types/threemap/mapView/geo/TileQuadtree.d.ts

@@ -3,9 +3,10 @@ export class TileQuadtree {
     _grid: any;
     _root: any;
     _tiles: {};
+    _reusedTiles: {};
     _tilesCount: number;
     getTileByKey(key: any): any;
-    getTile(z: any, x: any, y: any): any;
+    getTile(z: any, x: any, y: any, getReusedTile?: boolean): any;
     getTileChildren(tile: any): any;
     _getOrCreateTile(z: any, x: any, y: any): any;
     /**

package/dist/types/threemap/mapView/grid/BaiduVectorOnlineGrid.d.ts

@@ -6,6 +6,7 @@ export class BaiduVectorOnlineGrid extends BaiduImageryGrid {
     name: string;
     /** @private */
     private _levels;
+    supportLevelReuse: boolean;
     _coordLevelTileCounts: {
         0: number;
         1: number;
@@ -16,5 +17,14 @@ export class BaiduVectorOnlineGrid extends BaiduImageryGrid {
         baseZ: any;
         startZ: any;
     };
+    /**
+     * 获取有层级复用的瓦片配置，外部传入的是根据标准四叉树计算出来的瓦片坐标，需要转换成层级复用的瓦片配置
+     * 如5-19-10实际使用的是5-10-5瓦片的四分之一
+     * @param {*} z
+     * @param {*} x
+     * @param {*} y
+     * @returns
+     */
+    getResuedTileConfig(z: any, x: any, y: any): any[] | null;
 }
 import { BaiduImageryGrid } from './BaiduImageryGrid';

package/dist/types/threemap/mapView/grid/Grid.d.ts

@@ -17,7 +17,17 @@ export class Grid {
     _engine: any;
     _sourceProjection: any;
     _targetProjection: any;
+    initFromTileProvider(tileProvider: any): void;
+    _sourceCoordType: any;
+    _targetCoordType: any;
+    _shouldConvertCoord: boolean | undefined;
+    useExtendTargetBoundingBox: any;
     getRootTiles(): never[];
+    /**
+     * 获取可用的根瓦片, 剔除超出目标投影范围的瓦片
+     * @returns {Array<MapTile>} 返回包含所有可用根瓦片的数组
+     */
+    getAvailableRootTiles(): Array<MapTile>;
     getRootBoundingBox(): null;
     getPixelSizeByLevel(level: any): any;
     getNextLevel(z: any): any;
@@ -31,6 +41,7 @@ export class Grid {
      * @returns {Array<MapTile>} 返回包含所有子瓦片的数组
      */
     createTileChildren(tile: MapTile): Array<MapTile>;
+    createSubTile(sourceTile: any, offsetX: any, offsetY: any, width: any, height: any): MapTile;
     isTileInBoundingRange(tile: any): boolean;
     getTileSizeAtLevel(level: any): void;
     getTileCoordX(x: any, tileSize: any, clampToEdge?: boolean): void;
@@ -51,6 +62,9 @@ export class Grid {
     get useGeoSubdivision(): boolean;
     get sourceProjection(): any;
     get targetProjection(): any;
+    get sourceCoordType(): any;
+    get targetCoordType(): any;
+    get shouldConvertCoord(): boolean | undefined;
     get zeroLevelPixelSize(): number;
     _zeroLevelPixelSize: number | undefined;
 }

package/dist/types/threemap/mapView/map/MapView.d.ts

@@ -160,16 +160,6 @@ export class MapView {
     _sseDenominator: number | undefined;
     _pitchRatio: any;
     getKeyByValue: (obj: any, value: any) => string | null;
-    /**
-     * @internal
-     * 当瓦片加载完成后，若为分层地图，保存其层级信息z
-     * @param {Event} e
-     */
-    handleTileLoaded: (e: Event) => void;
-    /**
-     * @protected
-     */
-    protected handleTileDispose: (e: any) => void;
     /**
      * @protected
      */

package/dist/types/threemap/mapView/mapbox/executer/fill.d.ts

@@ -75,6 +75,8 @@ export default class FillExecuter {
     };
     _getStyleValue(type: any, property: any): any;
     _getFillColor(): void;
+    _getFillTranslate(): void;
+    _translate: any;
     _loadGeometry(layerIndex: any): void;
     _getOutLineColor(): void;
     _getFillPattern(): void;

package/dist/types/threemap/mapView/surface/MapSurface.d.ts

@@ -37,6 +37,7 @@ export class MapSurface {
     private _selectedTilesLastFrame;
     /** @private */
     private _showGroundWireframe;
+    _pendingRequests: Map<any, any>;
     _id: number;
     _quadtree: TileQuadtree | null;
     _placeholder: Placeholder | null;
@@ -68,7 +69,7 @@ export class MapSurface {
      */
     get strategy(): any;
     _getCurrentGrid(): void;
-    computeDistanceToTile(tile: any, cameraPosition: any, mode: any, mapProjection: any, ellipsoid: any): any;
+    computeDistanceToTile(tile: any, cameraPosition: any, renderState: any, mode: any, mapProjection: any, ellipsoid: any): any;
     refresh(): void;
     clearTilesInView(): void;
     /**
@@ -83,21 +84,22 @@ export class MapSurface {
     _getDebugLabelId(surfaceTile: any): string;
     _onBeforeSceneRender(engine: any, scene: any, camera: any, renderState: any): void;
     _groundSceneRenderer: GroundSceneRenderer | undefined;
+    _cancelTileInArray(cancelTiles: any): void;
     _requestTilesInArray(tiles: any, number: any, onlyRequestGeometry?: boolean): void;
+    _collectionCancelTiles(requestTiles: any): any[];
     _selectCurrentFrameRequestTiles(tiles: any, number: any): any;
     beginFrame(renderState: any): void;
+    updatePendingRequest(renderState: any): void;
     endFrame(renderState: any): void;
     _computeOccludeePoint(tile: any, occluder: any): any;
     _computeOccludeePoint2(tile: any, occluder: any): any;
-    updateTileBoundingRegion(tile: any, tileProvider: any, renderState: any): void;
+    updateTileBoundingRegion(tile: any, renderState: any): void;
     screenSpaceError(tile: any): number;
     reverseScreenSpaceErrorZ(tile: any): number;
     projectBoundingBoxToNdc(tile: any): any[][];
     _computeTileVisibility(frustum: any, tile: any): any;
     _computeTileVisibility3D(frustum: any, boundingVolume: any): number;
     _naturalOrderChildTiles(tiles: any, cameraPosition: any): any[];
-    _createRootTiles(): void;
-    _rootTiles: any;
     /**
      * @internal
      * 显示一帧的加载日志
@@ -156,6 +158,7 @@ export class MapSurface {
      * 获取细节层次缩放因子
      */
     get lodScaleFactor(): number;
+    get computedLodScaleFactor(): number;
     set showGroundWireframe(value: boolean);
     get showGroundWireframe(): boolean;
     _groundWireframeMaterial: any;

package/dist/types/threemap/mapView/surface/Placeholder.d.ts

@@ -1,5 +1,5 @@
 export class Placeholder {
-    constructor(options?: {});
+    constructor(options: {} | undefined, placeholderColor: any);
     /** @private */
     private _maxCacheSize;
     _cache: LRUCache;

package/dist/types/threemap/mapView/surface/VectorSurface.d.ts

@@ -30,6 +30,7 @@ export class VectorSurface extends MapSurface {
      */
     beginFrame(renderState: any): false | undefined;
     _shouldRenderPlaceholder: any;
+    _placeholderColor: any;
     /**
      * 设置矢量提供者
      */

package/dist/types/threemap/mapView/surface/strategy/FastTileLoaderStrategy.d.ts

@@ -45,7 +45,7 @@ export class FastTileLoaderStrategy extends Strategy {
      * @returns {boolean} 是否是子瓦片
      */
     _isAncestorTile: (currentTile: MapTile, ancestorTile: MapTile) => boolean;
-    _preserveLastFrameChildrenTiles: (tile: any, renderedTiles: any) => number;
+    _preserveLastFrameChildrenTiles: (tile: any, renderedTiles: any, renderState: any) => number;
     _isTileRenderedInLastFrame: (tile: any) => boolean;
     _isTileAncestorRenderedInLastFrame: (tile: any) => true | undefined;
     _hideChildrenTiles: (renderedTiles: any, placeholderTiles: any, tile: any) => number;
@@ -82,8 +82,8 @@ export class FastTileLoaderStrategy extends Strategy {
      * @param {Array} tiles 瓦片数组
      * @param {Array} viewportTiles 主视野内的瓦片数组
      */
-    _traverseViewportTiles: (projectionBounds: Box3, frustum: Frustum, cameraPosition: Vector3, tiles: any[], viewportTiles: any[]) => void;
-    _computeIntersectTiles(frustum: any, cameraPosition: any, tile: any, renderedTiles: any, requestTiles: any, placeholderTiles: any, maxZLevel: any): MapTileRenderState;
+    _traverseViewportTiles: (projectionBounds: Box3, frustum: Frustum, cameraPosition: Vector3, tiles: any[], viewportTiles: any[], renderState: any) => void;
+    _computeIntersectTiles(frustum: any, cameraPosition: any, tile: any, renderedTiles: any, requestTiles: any, placeholderTiles: any, maxZLevel: any, renderState: any): MapTileRenderState;
     getPolygonArea(vertices: any): number;
     set showDebug(value: boolean);
     get showDebug(): boolean;

package/dist/types/threemap/mapView/surface/strategy/HierarchicalTileLoaderStrategy.d.ts

@@ -5,7 +5,6 @@ export class HierarchicalTileLoaderStrategy extends Strategy {
         requestTilesQueue: any[][];
         placeholderTiles: never[];
     };
-    queueTileLoaded(tile: any, requestTiles: any): void;
     /**
      * @param {*} cameraPosition
      * @param {*} frustum

package/dist/types/threemap/mapView/tileManager/RasterSurfaceTileManager.d.ts

@@ -1,11 +1,11 @@
 export class RasterSurfaceTileManager extends SurfaceTileManager {
     /** @private */
     private _tiles;
+    _layersKey: string;
     forceUpdateTileState(tile: any): void;
-    isTileNeedsLoading(tile: any): true | undefined;
-    isTileComputable(tile: any): any;
-    isTileRenderable(tile: any): boolean;
-    isTileStable(tile: any): boolean;
+    isTileComputable(tile: any, renderState: any): any;
+    isTileRenderable(tile: any, renderState: any): boolean;
+    isTileStable(tile: any, renderState: any): boolean;
     markTileUsed(tile: any): null | undefined;
     getSurfaceTile(tile: any, renderState: any): any;
     _updateSurfaceTileData(data: any): void;

package/dist/types/threemap/mapView/tileManager/SurfaceTileManager.d.ts

@@ -8,8 +8,11 @@ export class SurfaceTileManager {
     /** @private */
     private _surface;
     _pendingCount: number;
-    getSurfaceTile(tile: any): void;
+    beginFrame(renderState: any): void;
+    endFrame(renderState: any): void;
+    getSurfaceTile(tile: any, renderState: any): void;
     requestSurfaceTile(tile: any): void;
+    cancelSurfaceTiles(tile: any): void;
     dispose(): void;
     get pendingCount(): number;
 }

package/dist/types/threemap/mapView/tileManager/VectorSurfaceTileManager.d.ts

@@ -1,18 +1,17 @@
 export class VectorSurfaceTileManager extends SurfaceTileManager {
     /** @private */
     private _tiles;
-    isTileRenderable(tile: any): boolean;
+    isTileRenderable(tile: any, renderState: any): boolean;
     markTileUsed(tile: any): null | undefined;
-    isTileNeedsLoading(tile: any): boolean;
-    isTileComputable(tile: any): any;
-    isTileStable(tile: any): boolean;
+    isTileComputable(tile: any, renderState: any): any;
+    isTileStable(tile: any, renderState: any): boolean;
     /**
      * 更新图形对象
      *
      * @param data 数据信息，包含需要更新的图形对象数据及其状态等信息。
      */
     _updateSurfaceTileData(data: any): void;
-    getSurfaceTile(tile: any): any;
+    getSurfaceTile(tile: any, renderState: any): any;
     _onlyRequestTileContents(data: any): void;
     clear(): void;
 }

package/dist/types/threemap/mapView/tileProvider/AsyncCesiumTerrainDataLoader.d.ts

@@ -27,4 +27,4 @@ export class AsyncCesiumTerrainDataLoader {
     postMessageToAll(message: any, transferableData: any): void;
 }
 import { WorkerTaskScheduler } from '../../../util/WorkerTaskScheduler';
-import { QuantizedMeshTerrainData } from '../terrainData/QuantizedMeshTerrainData';
+import { QuantizedMeshTerrainData } from '../geo/terrainData/QuantizedMeshTerrainData';

package/dist/types/threemap/mapView/tileProvider/AsyncDataTileLoader.d.ts

@@ -15,6 +15,7 @@ export class AsyncDataTileLoader {
      */
     requestTile(tile: Tile): Promise<void>;
     refreshTile(tile: any): Promise<any>;
+    cancelTiles(tiles: any): void;
     /**
      * 向所有 worker 发送消息。
      *

package/dist/types/threemap/mapView/tileProvider/BaseImageryTileProvider.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 基础影像图层，提供影像图层的基础功能
+ */
+export class BaseImageryTileProvider extends TileProvider {
+    /**
+     * @param {object} options 配置选项
+     * @param {number} [options.opacity] 不透明度，取值范围0-1，默认为1
+     * @param {number[]} [options.colorTint] 色彩调整值，RGB分量，默认为[1, 1, 1]
+     * @param {boolean} [options.randomColorTint] 是否使用随机色彩调整，默认为false
+     * @param {Color} [options.placeholderColor] 占位符颜色
+     */
+    constructor(options?: {
+        opacity?: number | undefined;
+        colorTint?: number[] | undefined;
+        randomColorTint?: boolean | undefined;
+        placeholderColor?: any;
+    });
+    /**
+     * 是否为基础影像瓦片提供者
+     * @readonly
+     */
+    readonly isBaseImageryTileProvider: true;
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "BaseImageryTileProvider";
+    /**
+     * @private
+     * @type {number}
+     * 不透明度，取值范围0-1
+     */
+    private _opacity;
+    /**
+     * @private
+     * @type {number[]}
+     * 色彩调整值，RGB分量
+     */
+    private _colorTint;
+    /**
+     * @private
+     * @type {boolean}
+     * 是否使用随机色彩调整
+     */
+    private _randomColorTint;
+    /**
+     * @private
+     * @type {boolean}
+     * 是否绘制调试标签
+     */
+    private _addDebugLabel;
+    _placeholderColor: any;
+    /**
+     * 请求瓦片数据
+     * 子类需要重写doRequestImageTileData方法
+     * @param {object} tile 瓦片对象
+     * @param {object} surfaceTile 表面瓦片对象
+     * @returns {Promise<Texture>} 瓦片纹理
+     * @abstract
+     */
+    doRequestTileData(tile: object, surfaceTile: object): Promise<Texture>;
+    /**
+     * 设置不透明度
+     * @param {number} opacity 不透明度，取值范围0-1
+     */
+    set opacity(opacity: number);
+    /**
+     * 获取不透明度
+     * @type {number}
+     */
+    get opacity(): number;
+    /**
+     * 设置色彩调整值
+     * @param {number[]} colorTint 色彩调整值，RGB分量
+     */
+    set colorTint(colorTint: number[]);
+    /**
+     * 获取色彩调整值
+     * @type {number[]}
+     */
+    get colorTint(): number[];
+    /**
+     * 设置是否使用随机色彩调整
+     * @param {boolean} randomColorTint 是否使用随机色彩调整
+     */
+    set randomColorTint(randomColorTint: boolean);
+    /**
+     * 获取是否使用随机色彩调整
+     * @type {boolean}
+     */
+    get randomColorTint(): boolean;
+    /**
+     * 设置是否绘制调试标签
+     * @param {boolean} addDebugLabel 是否绘制调试标签
+     */
+    set addDebugLabel(addDebugLabel: boolean);
+    /**
+     * 获取是否绘制调试标签
+     * @type {boolean}
+     */
+    get addDebugLabel(): boolean;
+}
+import { TileProvider } from './TileProvider';

package/dist/types/threemap/mapView/tileProvider/TileProvider.d.ts

@@ -25,6 +25,10 @@ export class TileProvider {
         maxCacheSize: number;
     });
     name: string;
+    /**
+     * 是否可见
+     */
+    visible: boolean;
     /**
      * @private
     */
@@ -75,9 +79,9 @@ export class TileProvider {
      */
     private _desiredUpperSampleLevel;
     /**
-       * @private
-       * 期望层级的瓦片加载过程中向上采样级数
-       */
+     * @private
+     * 期望层级的瓦片加载过程中向上采样级数
+     */
     private _loadingUpperSampleLevel;
     /**
      * @private
@@ -146,10 +150,21 @@ export class TileProvider {
     private _useWebMeractorProjectionAndGrid;
     /**
      * @private
-     * 数据版本
+     * 标记请求的数据版本，数据在请求过程中，provider的配置如果已经变更，数据返回时需校验
+     */
+    private _requestDataVersion;
+    /**
+     * @private
+     * 标记是否要清空缓存
+     */
+    private _needsClearCache;
+    /**
+     * @private
+     * 标记是否要更新瓦片版本，更新瓦片版本会让surface重新计算瓦片依赖关系
      */
-    private _dataVersion;
-    _needFeedback: any;
+    private _needsIncreTilesEpoch;
+    _id: number;
+    _needFallback: any;
     statistics: {
         loading: number;
         cached: number;
@@ -165,7 +180,6 @@ export class TileProvider {
     beginFrame(renderState: any): void;
     _usedTilesNum: number | undefined;
     _usedTiles: {} | undefined;
-    _needsClearCache: boolean | undefined;
     endFrame(renderState: any): void;
     isReady(): boolean;
     onTileDispose(tile: any): void;
@@ -176,11 +190,13 @@ export class TileProvider {
     _initOrUpdateTileStateListeners: (tile: any, listenrObject: any) => void;
     requestTileData(tile: any, stateListenerObject: any): Promise<void>;
     getGroundTileData(tile: any): null;
-    getTile(z: any, x: any, y: any, targetTile: any, stateListenerObject: any): any;
+    getTile(z: any, x: any, y: any, targetTile: any, surfaceTile: any): any;
     markTileUsed(tile: any): void;
     _tileLevelInRange(level: any): boolean;
     computeCoverageTilesCoord(targetTile: any): any;
-    clearCache(): void;
+    _clearCache(): void;
+    _increTilesEpoch(): void;
+    get id(): number;
     set maxCacheSize(value: number);
     get maxCacheSize(): number;
     set desiredUpperSampleLevel(value: number);

package/dist/types/threemap/mapView/tileProvider/imagery/Baidu09ImageryTileProvider.d.ts

@@ -1,14 +1,78 @@
+/**
+ * 百度09影像瓦片提供者，用于加载和渲染百度地图的影像瓦片数据。
+ * 支持Web墨卡托和地理坐标两种投影方式，提供卫星影像和普通影像两种类型。
+ *
+ * 主要功能：
+ * - 支持百度地图影像瓦片加载
+ * - 支持Web墨卡托和地理坐标投影
+ * - 支持卫星影像和普通影像切换
+ * - 自动处理百度地图坐标转换
+ *
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建百度09影像瓦片提供者（普通影像）
+ * const provider = new mapvthree.Baidu09ImageryTileProvider({
+ *     ak: 'your_baidu_ak',
+ *     type: 'normal'
+ * });
+ *
+ * // 创建百度09影像瓦片提供者（卫星影像）
+ * const satelliteProvider = new mapvthree.Baidu09ImageryTileProvider({
+ *     ak: 'your_baidu_ak',
+ *     type: 'satellite'
+ * });
+ * ```
+ */
 export class Baidu09ImageryTileProvider extends ImageryTileProvider {
-    constructor(options: any);
-    isBaiduProvider: boolean;
-    /** @private */
+    /**
+     * @param {object} options 配置选项
+     * @param {string} [options.ak] 百度地图API密钥，如果不提供则使用全局配置
+     * @param {string} [options.type] 影像类型，支持 'satellite'（卫星影像）和 'normal'（普通影像），默认为 'normal'
+     */
+    constructor(options: {
+        ak?: string | undefined;
+        type?: string | undefined;
+    });
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "Baidu09ImageryTileProvider";
+    /**
+     * 是否为百度地图提供者
+     * @readonly
+     */
+    readonly isBaiduProvider: true;
+    /**
+     * 支持的投影方式
+     * @private
+     */
     private _supportedTargetProjectionNames;
-    /** @private */
+    /**
+     * 默认起始缩放级别
+     * @private
+     */
     private _defaultStartLevel;
-    /** @private */
+    /**
+     * 默认最大缩放级别
+     * @private
+     */
     private _defaultMaxLevel;
-    /** @private */
+    /**
+     * 影像类型（satellite或normal）
+     * @private
+     */
     private _type;
-    getTileURL(z: any, x: any, y: any, tile: any): string | false;
+    _ak: string | null;
+    /**
+     * 获取瓦片URL
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {object} tile 瓦片对象
+     * @returns {string|boolean} 瓦片URL或false（如果缩放级别小于3）
+     */
+    getTileURL(z: number, x: number, y: number, tile: object): string | boolean;
 }
 import { ImageryTileProvider } from './ImageryTileProvider';