@baidumap/mapv-three 1.0.0

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

@@ -0,0 +1,36 @@
+/**
+ * 影像瓦片提供者，负责影像瓦片数据的请求和缓存。<br/>
+ * 该类是所有影像瓦片提供者的**抽象基类，不可直接使用，需要使用子类。**
+ *
+ * @category Internal
+ */
+export class ImageryTileProvider extends TileProvider {
+    constructor(options?: {});
+    isImageryTileProvider: boolean;
+    _opacity: any;
+    _colorTint: any;
+    _randomColorTint: any;
+    getTileURL(z: any, x: any, y: any, tile: any): void;
+    /**
+     * 判断是否需要进行投影变换，取中心点的像素坐标，计算变换后的像素坐标，判断是否有明显的偏移
+     * @param {*} sourceProjection
+     * @param {*} targetProjection
+     * @param {*} tile
+     * @returns
+     */
+    shouldReproject(sourceProjection: any, targetProjection: any, tile: any): boolean;
+    /**
+     * 请求瓦片数据
+     *
+     * @param {*} tile - 瓦片对象
+     */
+    doRequestTileData(tile: any): Promise<any>;
+    errorFeedback(): any;
+    set opacity(opacity: any);
+    get opacity(): any;
+    set colorTint(colorTint: any);
+    get colorTint(): any;
+    set randomColorTint(randomColorTint: any);
+    get randomColorTint(): any;
+}
+import { TileProvider } from '../TileProvider';

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

@@ -0,0 +1,56 @@
+/**
+ * OpenStreetMap影像瓦片提供者，用于加载和渲染OSM地图的影像瓦片数据。
+ * 支持Web墨卡托和地理坐标两种投影方式。
+ *
+ * 主要功能：
+ * - 支持OpenStreetMap影像瓦片加载
+ * - 支持Web墨卡托和地理坐标投影
+ * - 支持瓦片URL的自动生成
+ * - 支持多服务器负载均衡
+ *
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建OSM影像瓦片提供者
+ * const provider = new OSMImageryTileProvider({
+ *     // 配置选项
+ * });
+ * ```
+ */
+export class OSMImageryTileProvider extends ImageryTileProvider {
+    /**
+     * @param {object} options 配置选项
+     */
+    constructor(options: object);
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "OSMImageryTileProvider";
+    /**
+     * 支持的投影方式
+     * @private
+     */
+    private _supportedTargetProjectionNames;
+    /**
+     * 默认起始缩放级别
+     * @private
+     */
+    private _defaultStartLevel;
+    /**
+     * 默认最大缩放级别
+     * @private
+     */
+    private _defaultMaxLevel;
+    /**
+     * 获取瓦片URL
+     * @internal
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {object} tile 瓦片对象
+     * @returns {string} 瓦片URL
+     */
+    getTileURL(z: number, x: number, y: number, tile: object): string;
+}
+import { ImageryTileProvider } from './ImageryTileProvider';

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

@@ -0,0 +1,60 @@
+/**
+ * 天地图影像瓦片提供者，用于加载和渲染天地图的影像瓦片数据。
+ * 支持Web墨卡托和地理坐标两种投影方式。
+ *
+ * 主要功能：
+ * - 支持天地图影像瓦片加载
+ * - 支持Web墨卡托和地理坐标投影
+ * - 支持瓦片URL的自动生成
+ *
+ * 需要使用天地图的TK，请在{@link TiandituConfig}中设置。
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建天地图影像瓦片提供者
+ * const provider = new TiandituImageryTileProvider({
+ *     // 配置选项
+ *     tk: 'your_tianditu_token',
+ * });
+ * ```
+ */
+export class TiandituImageryTileProvider extends ImageryTileProvider {
+    /**
+     * @param {object} options 配置选项
+     * @param {string} [options.tk] 天地图密钥，如果不提供则使用 TiandituMapConfig.tk
+     */
+    constructor(options: {
+        tk?: string | undefined;
+    });
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "TiandituImageryTileProvider";
+    /**
+     * 天地图密钥
+     * @private
+     */
+    private _tk;
+    /**
+     * 支持的投影方式
+     * @private
+     */
+    private _supportedTargetProjectionNames;
+    /**
+     * 默认最大缩放级别
+     * @private
+     */
+    private _defaultMaxLevel;
+    /**
+     * 获取瓦片URL
+     * @internal
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {object} tile 瓦片对象
+     * @returns {string|boolean} 瓦片URL，如果缩放级别为0则返回false
+     */
+    getTileURL(z: number, x: number, y: number, tile: object): string | boolean;
+}
+import { ImageryTileProvider } from './ImageryTileProvider';

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

@@ -0,0 +1,31 @@
+export class WMSImageryTileProvider extends ImageryTileProvider {
+    constructor(options: any);
+    /** @private */
+    private _supportedTargetProjectionNames;
+    /** @private */
+    private _defaultMaxLevel;
+    /** @private */
+    private _url;
+    _replaceStr: {
+        x: string;
+        y: string;
+        z: string;
+        b: string;
+        reverseY: string;
+    };
+    _baseUrl: any;
+    _params: any;
+    getDefaultParmas(): {
+        SERVICE: string;
+        REQUEST: string;
+        VERSION: string;
+        FORMAT: string;
+        STYLES: string;
+        TRANSPARENT: boolean;
+        BBOX: string;
+    };
+    appendParams(uri: any, params: any): string;
+    getUrlParams(url: any): {};
+    getTileURL(z: any, x: any, y: any, tile: any): string;
+}
+import { ImageryTileProvider } from './ImageryTileProvider';

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

@@ -0,0 +1,32 @@
+export class WMTSImageryTileProvider extends ImageryTileProvider {
+    constructor(options: any);
+    /** @private */
+    private _supportedTargetProjectionNames;
+    /** @private */
+    private _defaultMaxLevel;
+    /** @private */
+    private _url;
+    _replaceStr: {
+        x: string;
+        y: string;
+        z: string;
+        reverseY: string;
+    };
+    _baseUrl: any;
+    _params: any;
+    appendParams(uri: any, params: any): string;
+    getUrlParams(url: any): {};
+    getDefaultParmas(): {
+        SERVICE: string;
+        REQUEST: string;
+        VERSION: string;
+        FORMAT: string;
+        TILEMATRIX: string;
+        TILECOL: string;
+        TILEROW: string;
+        TILEMATRIXSET: string;
+    };
+    getEPSGCode(tileMatrixSet: any): any;
+    getTileURL(z: any, x: any, y: any, tile: any): string;
+}
+import { ImageryTileProvider } from './ImageryTileProvider';

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

@@ -0,0 +1,16 @@
+export class XYZImageryTileProvider extends ImageryTileProvider {
+    constructor(options: any);
+    /** @private */
+    private _supportedTargetProjectionNames;
+    /** @private */
+    private _url;
+    _replaceStr: {
+        x: string;
+        y: string;
+        z: string;
+        reverseY: string;
+    };
+    _defaultXYZProjectionName: any;
+    getTileURL(z: any, x: any, y: any, tile: any): any;
+}
+import { ImageryTileProvider } from './ImageryTileProvider';

package/dist/types/threemap/mapView/tileProvider/terrain/CesiumTerrainTileProvider.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Cesium地形瓦片提供者，用于加载和渲染Cesium地形数据。支持从Cesium ion服务器或自定义服务器加载地形数据，提供高质量的地形渲染。主要功能：
+ * - 支持Cesium ion地形数据加载
+ * - 支持自定义地形服务器
+ * - 支持地形数据的上采样
+ * - 支持多种投影方式（ECEF、Web墨卡托、地理坐标）
+ *
+ * 需要使用Cesium ion的Access Token，请在{@link CesiumConfig}中设置。
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 使用默认Cesium ion服务器
+ * const provider = new CesiumTerrainTileProvider({
+ *     accessToken: 'your_access_token'
+ * });
+ * // 使用自定义地形服务器
+ * const customProvider = new CesiumTerrainTileProvider({
+ *     url: 'https://your-terrain-server'
+ * });
+ * ```
+ */
+export class CesiumTerrainTileProvider extends PlaneTerrainTileProvider {
+    /**
+     * 创建Cesium地形瓦片提供者
+     * @param {object} options 配置选项
+     * @param {string} [options.accessToken] Cesium ion访问令牌
+     * @param {string} [options.url] 自定义地形服务器URL
+     */
+    constructor(options?: {
+        accessToken?: string | undefined;
+        url?: string | undefined;
+    });
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "CesiumTerrainTileProvider";
+    /**
+     * Cesium地形服务器URL
+     * @private
+     * @type {string}
+     */
+    private _url;
+    /**
+     * 默认最大层级
+     * @private
+     * @type {number}
+     */
+    private _defaultMaxLevel;
+    /**
+     * 是否为默认Cesium服务器
+     * @private
+     * @type {boolean}
+     */
+    private _isDefaultCesium;
+    _accessToken: string | null;
+    /**
+     * 异步初始化
+     * @protected
+     */
+    protected _asyncInit(): Promise<void>;
+    _layerConfig: any;
+    _urlTemplate: string | undefined;
+    _version: any;
+    _availableTiles: any;
+    _dataLoader: AsyncCesiumTerrainDataLoader | undefined;
+    /**
+     * 刷新访问令牌
+     * @private
+     */
+    private _refreshAccessToken;
+    _sessionToken: any;
+    _lastRefreshTokenTime: number | undefined;
+    /**
+     * 检查并刷新访问令牌
+     * @private
+     */
+    private _checkAndRefreshAccessToken;
+    /**
+     * 获取瓦片URL
+     * @internal
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {Tile} tile 瓦片对象
+     * @returns {string} 瓦片URL
+     */
+    getTileURL(z: number, x: number, y: number, tile: Tile): string;
+    /**
+     * 获取请求选项
+     * @internal
+     * @returns {object} 请求选项
+     */
+    getFetchOptions(): object;
+    /**
+     * 检查瓦片是否可用
+     * @internal
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @returns {boolean|undefined} 瓦片是否可用
+     */
+    isTileAvailable(z: number, x: number, y: number): boolean | undefined;
+    /**
+     * 请求瓦片数据
+     * @internal
+     * @param {Tile} tile 需要请求的瓦片对象
+     * @returns {Promise<BufferGeometry|null>} 返回包含地形数据的几何体或null
+     */
+    doRequestTileData(tile: Tile): Promise<BufferGeometry | null>;
+}
+import { PlaneTerrainTileProvider } from './PlaneTerrainTileProvider';
+import { AsyncCesiumTerrainDataLoader } from '../AsyncCesiumTerrainDataLoader';

package/dist/types/threemap/mapView/tileProvider/terrain/PlaneTerrainTileProvider.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 平面地形瓦片提供者，用于生成和渲染平面地形瓦片。支持多种投影方式，包括Web墨卡托、ECEF和地理坐标系统。
+ * 主要功能：
+ * - 支持多种投影方式的地形瓦片生成
+ * - 提供基础的地形几何数据
+ * - 支持瓦片数据的请求和处理
+ *
+ * @category MapView
+ * @example
+ * ```javascript
+ * const provider = new PlaneTerrainTileProvider({
+ *     // 配置选项
+ * });
+ * ```
+ */
+export class PlaneTerrainTileProvider extends TerrainTileProvider {
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "PlaneTerrainTileProvider";
+    /**
+     * 支持的目标投影方式
+     * @private
+     * @type {string[]}
+     */
+    private _supportedTargetProjectionNames;
+    /**
+     * 零级最大几何误差
+     * @private
+     * @type {number}
+     */
+    private _levelZeroMaximumGeometricError;
+    rasterProjection: any;
+    /**
+     * 请求瓦片数据
+     * @internal
+     * @param {Tile} tile 需要请求的瓦片对象
+     * @returns {BufferGeometry} 返回包含地形数据的几何体
+     */
+    doRequestTileData(tile: Tile): BufferGeometry;
+    /**
+     * 将Vector3对象转换为数组
+     * @private
+     * @param {Vector3} vector 三维向量
+     * @returns {number[]} 转换后的数组
+     */
+    private _vectorToArray;
+    /**
+     * 将Box3对象转换为数组
+     * @private
+     * @param {Box3} box 三维包围盒
+     * @returns {number[]} 转换后的数组
+     */
+    private _boxToArray;
+}
+import { TerrainTileProvider } from './TerrainTileProvider';

package/dist/types/threemap/mapView/tileProvider/terrain/TerrainTileProvider.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 地形瓦片提供者，负责地形瓦片数据的请求和缓存。<br/>
+ * 该类是所有地形瓦片提供者的**抽象基类，不可直接使用，需要使用子类。**
+ *
+ * @category Internal
+ */
+export class TerrainTileProvider extends TileProvider {
+    /**
+     * @param {*} tile
+     * @returns
+     * geometry
+     * @desc 请求瓦片数据
+     */
+    doRequestTileData(tile: any): Promise<void>;
+}
+export namespace TerrainTileProvider {
+    let heightmapTerrainQuality: number;
+    /**
+     * @private
+     * 当geometry来自高度图时，确定适当的几何误差估计。
+     *
+     * @param {Ellipsoid} ellipsoid The ellipsoid to which the terrain is attached.
+     * @param {number} tileImageWidth The width, in pixels, of the heightmap associated with a single tile.
+     * @param {number} numberOfTilesAtLevelZero The number of tiles in the horizontal direction at tile level zero.
+     * @returns {number} An estimated geometric error.
+     */
+    function getEstimatedLevelZeroGeometricErrorForAHeightmap(ellipsoid: Ellipsoid, tileImageWidth: number, numberOfTilesAtLevelZero: number): number;
+}
+import { TileProvider } from '../TileProvider';

package/dist/types/threemap/mapView/tileProvider/vector/BaiduTrafficTileProvider.d.ts

@@ -0,0 +1,27 @@
+export class BaiduTrafficTileProvider extends VectorTileProvider {
+    constructor(options?: {});
+    isBaiduProvider: boolean;
+    /** @private */
+    private _defaultStartLevel;
+    /** @private */
+    private _defaultMaxLevel;
+    _options: {};
+    _url: any;
+    params: any;
+    _isOffline: any;
+    _sourceProjectionName: any;
+    _isWebMercator: boolean;
+    _defaultMinLevel: number;
+    _asyncInit(): Promise<void>;
+    _dataLoader: AsyncDataTileLoader | undefined;
+    getTileURL(z: any, x: any, y: any, tile: any): string;
+    _getOnlineTileURL(z: any, x: any, y: any, tile: any): string;
+    _getOfflineTileURL(z: any, x: any, y: any, tile: any): string;
+    getWorkerOptions(): {
+        colors: any;
+        lineWidth: any;
+    };
+    doRequestTileData(tile: any): Promise<any[]>;
+}
+import { VectorTileProvider } from './VectorTileProvider';
+import { AsyncDataTileLoader } from '../AsyncDataTileLoader';

package/dist/types/threemap/mapView/tileProvider/vector/BaiduVectorTileProvider.d.ts

@@ -0,0 +1,162 @@
+/**
+ * 百度矢量瓦片提供者，用于加载和渲染百度地图的矢量瓦片数据。
+ * 支持在线和离线两种模式，可以处理多种投影方式。
+ *
+ * 主要功能：
+ * - 支持百度地图在线矢量瓦片加载
+ * - 支持离线矢量瓦片加载
+ * - 支持多种投影方式（Web墨卡托、百度墨卡托、地理坐标）
+ * - 支持矢量数据的样式配置
+ * - 支持POI标签的显示
+ *
+ * 需要使用百度地图的AK，请在{@link BaiduMapConfig}中设置。
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建在线矢量瓦片提供者
+ * const provider = new BaiduVectorTileProvider({
+ *     ak: 'your_ak_here',
+ *     displayOptions: {
+ *         // 显示配置
+ *     }
+ * });
+ *
+ * // 创建DuGIS离线矢量瓦片提供者
+ * const offlineProvider = new BaiduVectorTileProvider({
+ *     isOffline: true,
+ *     url: 'http://dugis-offline-server',
+ * });
+ * ```
+ */
+export class BaiduVectorTileProvider extends VectorTileProvider {
+    /**
+     * @param {object} options 配置选项
+     * @param {string} [options.ak] 百度地图AK，在线模式必填
+     * @param {boolean} [options.isOffline=false] 是否为离线dugis模式
+     * @param {string} [options.url] 离线模式下的瓦片dugis服务器地址
+     * @param {string} [options.staticUrl] 离线模式下的静态资源服务器地址
+     * @param {string} [options.projection] 离线模式下的投影方式，默认为'mapvthree.PROJECTION_WEB_MERCATOR'
+     * @param {object} [options.displayOptions] 显示配置选项
+     * @param {boolean} [options.displayOptions.base=true] 是否显示基础面
+     * @param {boolean} [options.displayOptions.link=true] 是否显示道路
+     * @param {boolean} [options.displayOptions.building=true] 是否显示3D建筑物
+     * @param {boolean} [options.displayOptions.poi=true] 是否显示POI
+     * @param {boolean} [options.displayOptions.flat=true] 是否显示成压平模式
+     */
+    constructor(options?: {
+        ak?: string | undefined;
+        isOffline?: boolean | undefined;
+        url?: string | undefined;
+        staticUrl?: string | undefined;
+        projection?: string | undefined;
+        displayOptions?: {
+            base?: boolean | undefined;
+            link?: boolean | undefined;
+            building?: boolean | undefined;
+            poi?: boolean | undefined;
+            flat?: boolean | undefined;
+        } | undefined;
+    });
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "BaiduVectorTileProvider";
+    /**
+     * 是否为百度地图提供者
+     * @readonly
+     */
+    readonly isBaiduProvider: true;
+    /** @private */ private _shouldRenderPlaceholder;
+    /** @private */ private _isAttach;
+    /** @private */ private _defaultStartLevel;
+    /** @private */ private _defaultMaxLevel;
+    /** @private */ private _labels;
+    _displayOptions: {
+        base?: boolean | undefined;
+        link?: boolean | undefined;
+        building?: boolean | undefined;
+        poi?: boolean | undefined;
+        flat?: boolean | undefined;
+    } | undefined;
+    _url: string | undefined;
+    _styleUrl: any;
+    _isOffline: boolean | undefined;
+    _staticUrl: string | undefined;
+    _sourceProjectionName: any;
+    _isWebMercator: boolean;
+    _defaultMinLevel: number;
+    /**
+     * 异步初始化方法
+     * @protected
+     */
+    protected _asyncInit(): Promise<void>;
+    _dataLoader: AsyncDataTileLoader | undefined;
+    _loadStyle: () => Promise<void>;
+    _getMapStyleFile: (style: any) => Promise<void>;
+    _vctMapStyleDomain: string | undefined;
+    _vctMapStyleUrl: string | undefined;
+    getTileURL(z: any, x: any, y: any, tile: any): string;
+    /**
+     * 获取在线瓦片URL
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {object} tile 瓦片对象
+     * @returns {string} 瓦片URL
+     * @private
+     */
+    private _getOnlineTileURL;
+    /**
+     * 获取离线瓦片URL
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {object} tile 瓦片对象
+     * @returns {string} 瓦片URL
+     * @private
+     */
+    private _getOfflineTileURL;
+    /**
+     * 获取WebWorker选项
+     * @internal
+     * @returns {object} 工作者选项
+     */
+    getWorkerOptions(): object;
+    /**
+     * 获取请求选项
+     * @internal
+     * @param {object} tile 瓦片对象
+     * @returns {object} 请求选项
+     */
+    getFetchOptions(tile: object): object;
+    /**
+     * 请求瓦片数据
+     * @internal
+     * @param {object} tile 瓦片对象
+     * @returns {Promise<Group>} 包含瓦片数据的Group对象
+     */
+    doRequestTileData(tile: object): Promise<Group>;
+    _calculateTolerance(surfaceTile: any, engine: any, label: any): number;
+    /**
+     * 添加POI标签
+     * @param {object} surfaceTile 表面瓦片对象
+     * @param {Engine} engine 引擎实例
+     * @private
+     */
+    private _addTilePOI;
+    _removeTilePOI(surfaceTile: any, engine: any): void;
+    /**
+     * @protected
+     */
+    protected onSurfaceTileAdded(surfaceTile: any, engine: any): void;
+    /**
+     * @protected
+     */
+    protected onSurfaceTileRemoved(surfaceTile: any, engine: any): void;
+    onSurfaceTileSSEChanged(surfaceTile: any, engine: any): void;
+    addAllSymbols(): void;
+    removeAllSymbols(): void;
+}
+import { VectorTileProvider } from './VectorTileProvider';
+import { AsyncDataTileLoader } from '../AsyncDataTileLoader';

package/dist/types/threemap/mapView/tileProvider/vector/GeoJSONVectorTileProvider.d.ts

@@ -0,0 +1,35 @@
+export class GeoJSONVectorTileProvider extends VectorTileProvider {
+    constructor(options?: {});
+    /** @private */ private _defaultMaxLevel;
+    /** @private */ private _geoJSONData;
+    _styleOptions: any;
+    _minZoom: any;
+    _maxZoom: any;
+    _tolerance: any;
+    _sourceProjectionName: any;
+    _isWebMercator: boolean;
+    /**
+     * 异步初始化方法
+     * @protected
+     */
+    protected _asyncInit(): Promise<void>;
+    _dataLoader: AsyncDataTileLoader | undefined;
+    /**
+     * 获取瓦片URL
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {object} tile 瓦片对象
+     * @returns {string} 瓦片URL或标识符
+     */
+    getTileURL(z: number, x: number, y: number, tile: object): string;
+    /**
+     * 请求瓦片数据
+     * @internal
+     * @param {object} tile 瓦片对象
+     * @returns {Promise<Group>} 包含瓦片数据的Group对象
+     */
+    doRequestTileData(tile: object): Promise<Group>;
+}
+import { VectorTileProvider } from './VectorTileProvider';
+import { AsyncDataTileLoader } from '../AsyncDataTileLoader';