@baidumap/mapv-three 1.0.1 → 1.2.0

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

@@ -1,27 +1,171 @@
+/**
+ * 百度路况瓦片提供者，用于加载和渲染百度地图的路况数据。
+ * 支持在线和离线两种模式，可以处理多种投影方式。
+ *
+ * 主要功能：
+ * - 支持百度地图在线路况瓦片加载
+ * - 支持DuGIS离线环境的路况瓦片加载
+ * - 支持多种投影方式（Web墨卡托、百度墨卡托）
+ * - 支持路况数据的自动刷新，可配置关闭
+ * - 支持路况线条的样式配置
+ *
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建在线路况瓦片提供者
+ * const provider = new BaiduTrafficTileProvider({
+ *     autoRefresh: true,
+ *     refreshInterval: 60000
+ * });
+ *
+ * // 创建离线路况瓦片提供者
+ * const offlineProvider = new BaiduTrafficTileProvider({
+ *     isOffline: true,
+ *     url: 'http://offline-traffic-server',
+ *     projection: 'mapvthree.PROJECTION_WEB_MERCATOR'
+ * });
+ * ```
+ */
 export class BaiduTrafficTileProvider extends VectorTileProvider {
-    constructor(options?: {});
-    isBaiduProvider: boolean;
-    /** @private */
-    private _defaultStartLevel;
-    /** @private */
-    private _defaultMaxLevel;
-    _options: {};
-    _url: any;
-    params: any;
-    _isOffline: any;
+    /**
+     * @param {object} options 配置选项
+     * @param {string} [options.url] 离线模式下的路况服务器地址
+     * @param {object} [options.params] 请求参数
+     * @param {boolean} [options.isOffline=false] 是否为离线模式
+     * @param {string} [options.projection] 离线模式下的投影方式，默认为'mapvthree.PROJECTION_WEB_MERCATOR'
+     * @param {boolean} [options.autoRefresh=true] 是否启用自动刷新
+     * @param {number} [options.refreshInterval=60000] 自动刷新间隔，单位毫秒，最小60秒
+     * @param {object} [options.colors] 路况颜色配置
+     * @param {number} [options.lineWidth] 路况线条宽度
+     */
+    constructor(options?: {
+        url?: string | undefined;
+        params?: object | undefined;
+        isOffline?: boolean | undefined;
+        projection?: string | undefined;
+        autoRefresh?: boolean | undefined;
+        refreshInterval?: number | undefined;
+        colors?: object | undefined;
+        lineWidth?: number | undefined;
+    });
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "BaiduTrafficTileProvider";
+    /**
+     * 是否为百度地图提供者
+     * @readonly
+     */
+    readonly isBaiduProvider: true;
+    /** @private */ private _defaultStartLevel;
+    /** @private */ private _defaultMaxLevel;
+    _options: {
+        url?: string | undefined;
+        params?: object | undefined;
+        isOffline?: boolean | undefined;
+        projection?: string | undefined;
+        autoRefresh?: boolean | undefined;
+        refreshInterval?: number | undefined;
+        colors?: object | undefined;
+        lineWidth?: number | undefined;
+    };
+    _url: string | undefined;
+    params: object | undefined;
+    _isOffline: boolean | undefined;
+    _autoRefresh: any;
+    _refreshInterval: any;
+    _refreshTimer: number | null;
     _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[]>;
+    /**
+     * 异步初始化方法
+     * @protected
+     */
+    protected _asyncInit(): Promise<void>;
+    /**
+     * 设置自动刷新间隔
+     * @param {number} interval 刷新间隔，单位毫秒，最小60000ms
+     */
+    set refreshInterval(interval: number);
+    /**
+     * 自动刷新间隔
+     * @type {number}
+     */
+    get refreshInterval(): number;
+    /**
+     * 获取瓦片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;
+    /**
+     * 获取在线瓦片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 {Promise<Array<Group>>} 包含瓦片数据的Group对象数组
+     */
+    doRequestVectorTileData(tile: object): Promise<Array<Group>>;
+    /**
+     * 启动自动刷新
+     * @private
+     */
+    private _startAutoRefresh;
+    /**
+     * 停止自动刷新
+     * @private
+     */
+    private _stopAutoRefresh;
+    /**
+     * 设置是否启用自动刷新
+     * @param {boolean} enabled 是否启用
+     */
+    set autoRefresh(enabled: boolean);
+    /**
+     * 是否启用自动刷新
+     * @type {boolean}
+     */
+    get autoRefresh(): boolean;
+    /**
+     * 销毁资源
+     * @protected
+     */
+    protected dispose(): void;
+    /**
+     * 瓦片销毁时的回调
+     * @param {object} tile 瓦片对象
+     * @protected
+     */
+    protected onTileDispose(tile: object): void;
 }
 import { VectorTileProvider } from './VectorTileProvider';
-import { AsyncDataTileLoader } from '../AsyncDataTileLoader';

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

@@ -76,6 +76,7 @@ export class BaiduVectorTileProvider extends VectorTileProvider {
     /** @private */ private _defaultStartLevel;
     /** @private */ private _defaultMaxLevel;
     /** @private */ private _labels;
+    /** @private */ private _ak;
     _displayOptions: {
         base?: boolean | undefined;
         link?: boolean | undefined;
@@ -91,6 +92,7 @@ export class BaiduVectorTileProvider extends VectorTileProvider {
     _staticUrl: string | undefined;
     _sourceProjectionName: any;
     _isWebMercator: boolean;
+    sourceCoordType: string | undefined;
     _defaultMinLevel: number;
     /**
      * 设置地图样式，通过 https://lbsyun.baidu.com/index.php?title=open/custom 获取个性化样式配置
@@ -152,7 +154,7 @@ export class BaiduVectorTileProvider extends VectorTileProvider {
      * @param {object} tile 瓦片对象
      * @returns {Promise<Group>} 包含瓦片数据的Group对象
      */
-    doRequestTileData(tile: object): Promise<Group>;
+    doRequestVectorTileData(tile: object): Promise<Group>;
     _calculateTolerance(surfaceTile: any, engine: any, label: any): number;
     /**
      * 添加POI标签

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

@@ -29,7 +29,7 @@ export class GeoJSONVectorTileProvider extends VectorTileProvider {
      * @param {object} tile 瓦片对象
      * @returns {Promise<Group>} 包含瓦片数据的Group对象
      */
-    doRequestTileData(tile: object): Promise<Group>;
+    doRequestVectorTileData(tile: object): Promise<Group>;
 }
 import { VectorTileProvider } from './VectorTileProvider';
 import { AsyncDataTileLoader } from '../AsyncDataTileLoader';

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

@@ -1,41 +1,176 @@
+/**
+ * HD路况瓦片提供者，用于加载和渲染高精地图的路况数据。
+ * 支持在线路况瓦片加载和实时数据刷新。
+ *
+ * 主要功能：
+ * - 支持高精地图路况瓦片加载
+ * - 支持多种投影方式（Web墨卡托、ECEF）
+ * - 支持路况数据的自动刷新，可配置关闭
+ * - 支持路况线条的样式配置
+ * - 支持通过API接口实时更新路况状态
+ *
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建HD路况瓦片提供者
+ * const provider = new HDTrafficTileProvider({
+ *     url: 'https://traffic-api.example.com/tiles/{z}/{x}/{reverseY}.json',
+ *     apiHost: 'https://api.example.com',
+ *     autoRefresh: true,
+ *     refreshInterval: 60000
+ * });
+ * ```
+ */
 export class HDTrafficTileProvider extends VectorTileProvider {
-    constructor(options?: {});
-    /** @private */
-    private _supportedTargetProjectionNames;
-    /** @private */
-    private _defaultMinLevel;
-    /** @private */
-    private _defaultMaxLevel;
-    /** @private */
-    private _trafficLinks;
-    _url: any;
-    _apiHost: any;
-    _options: {};
+    /**
+     * @param {object} options 配置选项
+     * @param {string} options.url 路况几何数据的地址，支持{x}、{y}、{z}、{reverseY}占位符
+     * @param {string} options.apiHost 路况几何对应状态的服务地址
+     * @param {boolean} [options.autoRefresh=true] 是否启用自动刷新
+     * @param {number} [options.refreshInterval=60000] 自动刷新间隔，单位毫秒，最小60秒
+     */
+    constructor(options?: {
+        url: string;
+        apiHost: string;
+        autoRefresh?: boolean | undefined;
+        refreshInterval?: number | undefined;
+    });
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "HDTrafficTileProvider";
+    /** @private */ private _supportedTargetProjectionNames;
+    /** @private */ private _defaultMinLevel;
+    /** @private */ private _defaultMaxLevel;
+    /** @private */ private _trafficLinks;
+    _url: string;
+    _apiHost: string;
+    _options: {
+        url: string;
+        apiHost: string;
+        autoRefresh?: boolean | undefined;
+        refreshInterval?: number | undefined;
+    };
+    _autoRefresh: any;
+    _refreshInterval: any;
+    _refreshTimer: number | null;
     _replaceStr: {
         x: string;
         y: string;
         z: string;
         reverseY: string;
     };
-    _asyncInit(): Promise<void>;
+    /**
+     * 异步初始化方法
+     * @protected
+     */
+    protected _asyncInit(): Promise<void>;
     _dataLoader: AsyncDataTileLoader | undefined;
-    getTileURL(z: any, x: any, y: any, tile: any): any;
-    getWorkerOptions(tile: any): {};
-    doRequestTileData(tile: any): Promise<any>;
-    onSurfaceTileRefresh(surfaceTile: any): void;
-    refreshTile(surfaceTile: any): Promise<void>;
-    _request(data: any): Promise<any>;
     /**
+     * 设置自动刷新间隔
+     * @param {number} interval 刷新间隔，单位毫秒，最小60秒
+     */
+    set refreshInterval(interval: number);
+    /**
+     * 自动刷新间隔
+     * @type {number}
+     */
+    get refreshInterval(): number;
+    /**
+     * 获取瓦片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;
+    /**
+     * 获取WebWorker选项
+     * @internal
+     * @param {object} tile 瓦片对象
+     * @returns {object} 工作者选项
+     */
+    getWorkerOptions(tile: object): object;
+    /**
+     * 请求矢量瓦片数据
+     * @internal
+     * @param {object} tile 瓦片对象
+     * @returns {Promise<Mesh>} 包含瓦片数据的Mesh对象
+     */
+    doRequestVectorTileData(tile: object): Promise<Mesh>;
+    /**
+     * SurfaceTile数据刷新回调
+     * @param {object} surfaceTile SurfaceTile对象
+     */
+    onSurfaceTileRefresh(surfaceTile: object): void;
+    /**
+     * 刷新SurfaceTile数据
+     * @param {object} surfaceTile SurfaceTile对象
+     */
+    refreshTile(surfaceTile: object): Promise<void>;
+    /**
+     * 发送API请求
+     * @param {object} data 请求数据
+     * @returns {Promise<object>} 响应结果
+     * @private
+     */
+    private _request;
+    /**
+     * 启动自动刷新
+     * @private
+     */
+    private _startAutoRefresh;
+    /**
+     * 停止自动刷新
+     * @private
+     */
+    private _stopAutoRefresh;
+    /**
+     * SurfaceTile添加回调
+     * @param {object} surfaceTile SurfaceTile对象
+     * @param {object} engine 引擎实例
+     * @protected
+     */
+    protected onSurfaceTileAdded(surfaceTile: object, engine: object): void;
+    /**
+     * SurfaceTile移除回调
+     * @param {object} surfaceTile SurfaceTile对象
+     * @param {object} engine 引擎实例
      * @protected
      */
-    protected onSurfaceTileAdded(surfaceTile: any, engine: any): void;
+    protected onSurfaceTileRemoved(surfaceTile: object, engine: object): void;
+    /**
+     * 切换路况链接可见性
+     * @param {boolean} visible 是否可见
+     */
+    toggleTrafficLinkVisible(visible: boolean): void;
+    /**
+     * 设置是否启用自动刷新
+     * @param {boolean} enabled 是否启用
+     */
+    set autoRefresh(enabled: boolean);
+    /**
+     * 是否启用自动刷新
+     * @type {boolean}
+     */
+    get autoRefresh(): boolean;
+    /**
+     * 设置API服务器地址
+     * @param {string} apiHost API服务器地址
+     */
+    set apiHost(apiHost: string);
+    /**
+     * API服务器地址
+     * @type {string}
+     */
+    get apiHost(): string;
     /**
+     * 销毁资源
      * @protected
      */
-    protected onSurfaceTileRemoved(surfaceTile: any, engine: any): void;
-    toggleTrafficLinkVisible(visible: any): void;
-    set apiHost(apiHost: any);
-    get apiHost(): any;
+    protected dispose(): void;
 }
 import { VectorTileProvider } from './VectorTileProvider';
 import { AsyncDataTileLoader } from '../AsyncDataTileLoader';