@baidumap/mapv-three 1.2.1 → 1.3.2

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

@@ -26,6 +26,11 @@ export const MAP_GRID_NAME_BD_VECTOR_ONLINE: "bd_vector_online";
  * @internal
  */
 export const MAP_GRID_NAME_BD_VECTOR_OFFLINE: "bd_vector_offline";
+/**
+ * 百度车道级矢量网格
+ * @internal
+ */
+export const MAP_GRID_NAME_BD_LANE_VECTOR: "bd_lane_vector";
 /**
  * 卫星影像样式，纯卫星影像，不包含任何标签或道路信息
  */

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

@@ -0,0 +1,33 @@
+export class BaiduLaneVectorGrid extends BaiduVectorOnlineGrid {
+    _zLevelToQuadTreeLevelMap: {
+        0: number;
+        1: number;
+        2: number;
+        3: number;
+        4: number;
+        6: number;
+        8: number;
+        10: number;
+        11: number;
+        13: number;
+        15: number;
+        17: number;
+    };
+    _tileCountMap: {
+        3: number;
+        4: number;
+        6: number;
+        8: number;
+        10: number;
+        11: number;
+        13: number;
+        15: number;
+        17: number;
+    };
+    _defaultCoordLevelTileCounts: {
+        0: number;
+    };
+    /** @private */
+    private _rootBoundingBox;
+}
+import { BaiduVectorOnlineGrid } from './BaiduVectorOnlineGrid';

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

@@ -6,11 +6,136 @@ export class BaiduVectorOnlineGrid extends BaiduImageryGrid {
     name: string;
     /** @private */
     private _levels;
-    supportLevelReuse: boolean;
-    _coordLevelTileCounts: {
+    /**
+     * 级别对应下一级瓦片拆分数量，没有的话默认为2
+     * 3-5: 拆分为2*2
+     * 5-7: 拆分为4*4
+     * 以此类推
+     */
+    _tileCountMap: {
+        3: number;
+        5: number;
+        7: number;
+        9: number;
+        10: number;
+        12: number;
+        15: number;
+        17: number;
+    };
+    /**
+     * 网格层级对应的真实四叉树层级
+     * 0，1级特殊
+     * 之后根据tileCountMap得出
+     */
+    _zLevelToQuadTreeLevelMap: {
         0: number;
         1: number;
+        2: number;
+        3: number;
+        5: number;
+        7: number;
+        9: number;
+        10: number;
+        12: number;
+        15: number;
+        17: number;
+        19: number;
     };
+    _zoomBaseMap: {
+        0: {
+            start: number;
+            base: number;
+        };
+        1: {
+            start: number;
+            base: number;
+        };
+        2: {
+            start: number;
+            base: number;
+        };
+        3: {
+            start: number;
+            base: number;
+        };
+        4: {
+            start: number;
+            base: number;
+        };
+        5: {
+            start: number;
+            base: number;
+        };
+        6: {
+            start: number;
+            base: number;
+        };
+        7: {
+            start: number;
+            base: number;
+        };
+        8: {
+            start: number;
+            base: number;
+        };
+        9: {
+            start: number;
+            base: number;
+        };
+        10: {
+            start: number;
+            base: number;
+        };
+        11: {
+            start: number;
+            base: number;
+        };
+        12: {
+            start: number;
+            base: number;
+        };
+        13: {
+            start: number;
+            base: number;
+        };
+        14: {
+            start: number;
+            base: number;
+        };
+        15: {
+            start: number;
+            base: number;
+        };
+        16: {
+            start: number;
+            base: number;
+        };
+        17: {
+            start: number;
+            base: number;
+        };
+        18: {
+            start: number;
+            base: number;
+        };
+        19: {
+            start: number;
+            base: number;
+        };
+        20: {
+            start: number;
+            base: number;
+        };
+        21: {
+            start: number;
+            base: number;
+        };
+    };
+    _defaultCoordLevelTileCounts: {
+        0: number;
+        1: number;
+    };
+    supportLevelReuse: boolean;
     _quadCoordToTileCoord(value: any, maxValue: any, z: any): number;
     getNextLevelTileCount(z: any): any;
     getTileLoaderConfig(tile: any): {
@@ -26,5 +151,6 @@ export class BaiduVectorOnlineGrid extends BaiduImageryGrid {
      * @returns
      */
     getResuedTileConfig(z: any, x: any, y: any): any[] | null;
+    _updateCoordLevelTileCounts(): void;
 }
 import { BaiduImageryGrid } from './BaiduImageryGrid';

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

@@ -33,6 +33,11 @@ export class MapView {
         vectorProvider: VectorProvider;
         vectorSurfaceOptions: Object;
     });
+    /**
+     * @internal
+     * 是否为异步渲染物体
+     */
+    isRenderAsyncObject: boolean;
     isQuadMap: boolean;
     /**
      * @internal
@@ -195,6 +200,7 @@ export class MapView {
     _lockedCamera: any;
     _cameraHelper: any;
     destroyCameraHelper(): void;
+    isInStableRenderState(): boolean;
     /**
      * 设置是否允许瓦片更新
      */

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

@@ -69,7 +69,23 @@ export class MapSurface {
      */
     get strategy(): any;
     _getCurrentGrid(): void;
-    computeDistanceToTile(tile: any, cameraPosition: any, renderState: any, mode: any, mapProjection: any, ellipsoid: any): any;
+    /**
+     * 计算瓦片到相机的距离
+     * @param tile {MapTile} 瓦片
+     * @param cameraPosition {Cartesian3} 相机位置
+     * @param renderState {Object} 渲染状态
+     * @param mode {SceneMode} 场景模式
+     * @param mapProjection {MapProjection} 地图投影
+     * @param ellipsoid {Ellipsoid} 椭球体
+     * @param accurateDistance {boolean} 是否精确计算距离, false时如果没有mesh将使用默认包围盒计算
+     * @returns {number} 瓦片到相机的距离
+     */
+    computeDistanceToTile(tile: MapTile, cameraPosition: Cartesian3, renderState: Object, mode: Readonly<{
+        MORPHING: number;
+        COLUMBUS_VIEW: number;
+        SCENE2D: number;
+        SCENE3D: number;
+    }>, mapProjection: MapProjection, ellipsoid: Ellipsoid, accurateDistance?: boolean): number;
     refresh(): void;
     clearTilesInView(): void;
     /**
@@ -81,6 +97,7 @@ export class MapSurface {
      */
     updateView(engine: any, cameraPosition: Object, frustum: Frustum, renderState: Object): void;
     _currentOccluder: any;
+    isInStableRenderState(): boolean;
     _getDebugLabelId(surfaceTile: any): string;
     _onBeforeSceneRender(engine: any, scene: any, camera: any, renderState: any): void;
     _groundSceneRenderer: GroundSceneRenderer | undefined;
@@ -167,4 +184,5 @@ export class MapSurface {
 }
 import { TileQuadtree } from '../geo/TileQuadtree';
 import { Placeholder } from './Placeholder';
+import { Cartesian3 } from '../../engine/map/earth/Cartesian3';
 import { GroundSceneRenderer } from './GroundSceneRenderer';

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

@@ -30,7 +30,7 @@ export class Baidu09ImageryTileProvider extends ImageryTileProvider {
      * @param {string} [options.ak] 百度地图API密钥，如果不提供则使用全局配置
      * @param {string} [options.type] 影像类型，支持 'satellite'（卫星影像）和 'normal'（普通影像），默认为 'normal'
      */
-    constructor(options: {
+    constructor(options?: {
         ak?: string | undefined;
         type?: string | undefined;
     });

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

@@ -23,7 +23,7 @@ export class TiandituImageryTileProvider extends ImageryTileProvider {
      * @param {object} options 配置选项
      * @param {string} [options.tk] 天地图密钥，如果不提供则使用 TiandituMapConfig.tk
      */
-    constructor(options: {
+    constructor(options?: {
         tk?: string | undefined;
     });
     /**

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

@@ -32,7 +32,7 @@ export class XYZImageryTileProvider extends ImageryTileProvider {
       * {@link PROJECTION_GEO}，默认为 {@link PROJECTION_WEB_MERCATOR}
       * @param {number} [options.maxLevel] 最大缩放级别，默认为18
       */
-    constructor(options: {
+    constructor(options?: {
         url: string;
         projection?: string | undefined;
         maxLevel?: number | undefined;

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

@@ -0,0 +1,152 @@
+/**
+ * 百度矢量瓦片提供者，用于加载和渲染百度地图的矢量瓦片数据。
+ * 支持在线和离线两种模式，可以处理多种投影方式。
+ *
+ * 主要功能：
+ * - 支持百度地图在线矢量瓦片加载
+ * - 支持离线矢量瓦片加载
+ * - 支持多种投影方式（Web墨卡托、百度墨卡托、地理坐标）
+ * - 支持矢量数据的样式配置
+ * - 支持POI标签的显示
+ *
+ * 需要使用百度地图的AK，请在{@link BaiduMapConfig}中设置。
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建在线矢量瓦片提供者
+ * const provider = new BaiduLaneVectorTileProvider({
+ *     ak: 'your_ak_here',
+ *     displayOptions: {
+ *         // 显示配置
+ *     }
+ * });
+ *
+ * // 创建DuGIS离线矢量瓦片提供者
+ * const offlineProvider = new BaiduLaneVectorTileProvider({
+ *     isOffline: true,
+ *     url: 'http://dugis-offline-server',
+ * });
+ * ```
+ */
+export class BaiduLaneVectorTileProvider extends VectorTileProvider {
+    /**
+     * @param {object} options 配置选项
+     * @param {string} [options.ak] 百度地图AK，在线模式必填
+     * @param {string} [options.styleId] 百度地图个性化地图，设置样式StyleId
+     * @param {string} [options.styleJson] 百度地图个性化地图，设置样式StyleJson
+     * @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;
+        styleId?: string | undefined;
+        styleJson?: 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: "BaiduLaneVectorTileProvider";
+    /**
+     * 是否为百度地图提供者
+     * @readonly
+     */
+    readonly isBaiduProvider: true;
+    /** @private */ private _shouldRenderPlaceholder;
+    /** @private */ private _defaultStartLevel;
+    /** @private */ private _defaultMaxLevel;
+    /** @private */ private _labels;
+    /** @private */ private _ak;
+    _displayOptions: {
+        base?: boolean | undefined;
+        link?: boolean | undefined;
+        building?: boolean | undefined;
+        poi?: boolean | undefined;
+        flat?: boolean | undefined;
+    } | undefined;
+    _url: string;
+    _styleUrl: any;
+    _defaultMinLevel: number;
+    /**
+     * 设置地图样式，通过 https://lbsyun.baidu.com/index.php?title=open/custom 获取个性化样式配置
+     * @param {Object} config 样式配置
+     * @param {string} config.styleId 样式ID
+     * @param {string} config.styleJson 样式JSON
+     */
+    setMapStyle(config: {
+        styleId: string;
+        styleJson: string;
+    }): Promise<void>;
+    /**
+     * 异步初始化方法
+     * @protected
+     */
+    protected _asyncInit(): Promise<void>;
+    _dataLoader: AsyncDataTileLoader | undefined;
+    _loadStyle: () => Promise<void>;
+    _getIconStyleFile: (style: any) => Promise<void>;
+    _getMapStyleFiles(style: any): string[];
+    _vctMapStyleDomain: string | undefined;
+    getTileURL(z: any, x: any, y: any, tile: any): string;
+    /**
+     * 获取WebWorker选项
+     * @internal
+     * @returns {object} 工作者选项
+     */
+    getWorkerOptions(): object;
+    /**
+     * 获取请求选项
+     * @internal
+     * @param {object} tile 瓦片对象
+     * @returns {object} 请求选项
+     */
+    getFetchOptions(tile: object): object;
+    /**
+     * 请求瓦片数据
+     * @internal
+     * @param {object} tile 瓦片对象
+     * @returns {Promise<Group>} 包含瓦片数据的Group对象
+     */
+    doRequestVectorTileData(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/worker/BaiduLaneVectorParser.worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/threemap/overlay/DOMOverlay.d.ts

@@ -92,13 +92,20 @@ export class DOMOverlay {
     get dom(): HTMLElement;
     /**
      * 设置坐标位置
-     * @param {Array<number>} value 坐标位置 [经度, 纬度, 高度]
+     * @param {Array<number>|THREE.Vector2|THREE.Vector3} value 坐标位置 [经度, 纬度, 高度] 或 THREE.Vector2/Vector3 对象
      * @example
      * ```javascript
+     * // 使用数组
      * overlay.point = [116.404, 39.915, 0];
+     *
+     * // 使用 THREE.Vector2
+     * overlay.point = new THREE.Vector2(116.404, 39.915);
+     *
+     * // 使用 THREE.Vector3
+     * overlay.point = new THREE.Vector3(116.404, 39.915, 0);
      * ```
      */
-    set point(value: Array<number>);
+    set point(value: Array<number> | THREE.Vector2 | THREE.Vector3);
     /**
      * 坐标位置 [经度, 纬度, 高度]
      * @type {Array<number>}

package/dist/types/threemap/overlay/Marker.d.ts

@@ -21,7 +21,7 @@ export class Marker extends DOMOverlay {
      * @param {string} [parameters.icon='https://webmap0.bdimg.com/image/api/marker_red.png'] 图标URL
      * @param {number} [parameters.width=25] 图标宽度, 默认值：25
      * @param {number} [parameters.height=25] 图标高度, 默认值：25
-     * @param {Array<number>} [parameters.point] 位置坐标 [经度,纬度,高度], 默认值：[0,0,0]
+     * @param {Array<number>|THREE.Vector2|THREE.Vector3} [parameters.point] 位置坐标 [经度,纬度,高度] 或 THREE.Vector2/Vector3 对象, 默认值：[0,0,0]
      * @param {Array<number>} [parameters.offset=[0,0]] 像素偏移量, 默认值：[0,0]
      * @param {boolean} [parameters.enableDragging=false] 是否可拖拽, 默认值：false
      */
@@ -29,7 +29,7 @@ export class Marker extends DOMOverlay {
         icon?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
-        point?: number[] | undefined;
+        point?: Array<number> | THREE.Vector2 | THREE.Vector3;
         offset?: number[] | undefined;
         enableDragging?: boolean | undefined;
     });

package/dist/types/threemap/services/autoComplete/AutoComplete.d.ts

@@ -0,0 +1,147 @@
+/**
+ * 地图搜索输入提示服务
+ *
+ * 支持以下功能：
+ * - 实时输入提示和自动完成
+ * - 支持多种搜索类型（全部、城市等）
+ * - 仅支持百度地图API
+ *
+ * @category Services
+ * @example
+ * ```javascript
+ * // 创建自动完成服务
+ * const autoComplete = new mapvthree.Services.AutoComplete({
+ *     input: 'searchInput', // 输入框ID
+ *     types: ['ALL', 'CITY'],
+ *     maxResults: 10,
+ *     debounceTime: 200,
+ *     onSearchComplete: (results) => {
+ *         console.log('搜索建议:', results);
+ *     },
+ *     onError: (error) => {
+ *         console.error('搜索错误:', error);
+ *     },
+ * });
+ * autoComplete.addEventListener('searchComplete', e => console.log('搜索完成'));
+ * autoComplete.addEventListener('error', e => console.log('搜索错误'));
+ * ```
+ *
+ * @example
+ * ```javascript
+ * // 动态设置搜索类型
+ * autoComplete.setTypes(['CITY']);
+ *
+ * // 执行搜索
+ * autoComplete.search('北京');
+ *
+ * // 获取结果
+ * const results = autoComplete.getResults();
+ * ```
+ */
+export class AutoComplete {
+    /**
+     * 创建自动完成服务实例
+     * @param {Object} options 配置参数
+     * @param {string|HTMLElement} options.input 输入框DOM元素或ID
+     * @param {Array<string>} [options.types=[]] 搜索类型，如['ALL', 'CITY']
+     * @param {Array<number>} [options.location] 搜索区域限制 [lng, lat]
+     * @param {number} [options.maxResults=10] 最大结果数量
+     * @param {number} [options.debounceTime=100] 防抖时间(ms)
+     * @param {Function} [options.onSearchComplete] 搜索完成回调
+     * @param {Function} [options.onError] 错误回调
+     * @param {Function} [options.onNeedData] 需要数据回调
+     * @param {string} [options.apiSource] API数据源，目前支持'baidu'
+     */
+    constructor(options?: {
+        input: string | HTMLElement;
+        types?: string[] | undefined;
+        location?: number[] | undefined;
+        maxResults?: number | undefined;
+        debounceTime?: number | undefined;
+        onSearchComplete?: Function | undefined;
+        onError?: Function | undefined;
+        onNeedData?: Function | undefined;
+        apiSource?: string | undefined;
+    });
+    options: {
+        input: string | HTMLElement;
+        types: Array<string>;
+        location: number[] | null;
+        maxResults: number;
+        debounceTime: number;
+        onSearchComplete?: Function | undefined;
+        onError?: Function | undefined;
+        onNeedData?: Function | undefined;
+        apiSource: string;
+    };
+    apiSource: string;
+    _ac: AutoComplete_Bd;
+    _isInitialized: boolean;
+    /**
+     * 创建具体的自动完成实例
+     * @param {Object} options 配置选项
+     * @returns {AutoComplete_Bd} 自动完成实例
+     * @private
+     */
+    private _createInstance;
+    _bindEvents(): void;
+    /**
+     * 初始化组件
+     * @returns {AutoComplete} 当前实例，支持链式调用
+     * @example
+     * ```javascript
+     * autoComplete.initialize();
+     * ```
+     */
+    initialize(): AutoComplete;
+    setPickValue(value: any): void;
+    /**
+     * 执行搜索
+     * @param {string} keyword 搜索关键词
+     * @returns {AutoComplete} 当前实例，支持链式调用
+     * @example
+     * ```javascript
+     * autoComplete.search('北京');
+     * ```
+     */
+    search(keyword: string): AutoComplete;
+    /**
+     * 设置搜索类型
+     * @param {Array<string>|string} types 搜索类型，如['ALL', 'CITY']或'CITY'
+     * @returns {AutoComplete} 当前实例，支持链式调用
+     * @example
+     * ```javascript
+     * autoComplete.setTypes(['CITY', 'POI']);
+     * // 或者
+     * autoComplete.setTypes('CITY');
+     * ```
+     */
+    setTypes(types: Array<string> | string): AutoComplete;
+    /**
+     * 获取当前搜索结果
+     * @returns {Object|null} 搜索结果对象
+     * @example
+     * ```javascript
+     * const results = autoComplete.getResults();
+     * if (results) {
+     *     console.log('当前结果:', results);
+     * }
+     * ```
+     */
+    getResults(): Object | null;
+    /**
+     * 销毁组件，释放资源
+     * @example
+     * ```javascript
+     * autoComplete.dispose();
+     * ```
+     */
+    dispose(): void;
+    /**
+     * 获取内部实例
+     * @returns {AutoComplete_Bd} 内部自动完成实例
+     * @private
+     */
+    private getInstance;
+}
+import { AutoComplete_Bd } from './AutoComplete_Bd';