my-openlayer 2.0.0 → 2.0.1

package/core/MapBaseLayers.d.ts

@@ -1,234 +1,234 @@
-/**
- * 地图底图图层管理类
- * 提供天地图底图、注记图层、GeoServer图层等功能
- * 支持图层切换、裁剪等高级功能
- */
-import Map from "ol/Map";
-import { Tile as TileLayer } from "ol/layer";
-import { TileWMS } from "ol/source";
-import WMTSTileGrid from "ol/tilegrid/WMTS";
-import XYZ from "ol/source/XYZ";
-import { MapLayersOptions, TiandituType, AnnotationLayerOptions, AnnotationType } from "../types";
-/**
- * GeoServer图层选项接口
- */
-interface GeoServerLayerOptions {
-    /** 图层层级 */
-    zIndex?: number;
-    /** 图层可见性 */
-    visible?: boolean;
-    /** WMS版本 */
-    version?: '1.1.1' | '1.3.0';
-    /** 服务器类型 */
-    serverType?: string;
-    /** 跨域设置 */
-    crossOrigin?: string;
-    /** WMS参数 */
-    params?: Record<string, any>;
-}
-/**
- * 天地图图层选项接口
- */
-interface TiandituLayerOptions {
-    /** 图层类型 */
-    type: TiandituType | string;
-    /** 天地图token */
-    token: string;
-    /** 图层层级 */
-    zIndex: number;
-    /** 图层可见性 */
-    visible: boolean;
-}
-/**
- * 地图底图图层管理类
- */
-export default class MapBaseLayers {
-    private readonly map;
-    private readonly options;
-    private layers;
-    private readonly errorHandler;
-    private currentBaseLayerType;
-    private currentAnnotationLayer;
-    private currentAnnotationType;
-    /**
-     * 构造函数
-     * @param map OpenLayers地图实例
-     * @param options 图层配置选项
-     */
-    constructor(map: Map, options: MapLayersOptions);
-    /**
-     * 验证构造函数参数
-     * @param map 地图实例
-     * @param options 配置选项
-     * @private
-     */
-    private validateConstructorParams;
-    /**
-     * 合并默认配置选项
-     * @param options 用户配置选项
-     * @returns 合并后的配置选项
-     * @private
-     */
-    private mergeDefaultOptions;
-    /**
-     * 初始化图层
-     * @private
-     */
-    private initializeLayers;
-    /**
-     * 初始化天地图图层
-     * @private
-     */
-    private initTiandituLayers;
-    /**
-     * 加载默认注记图层（cia_c）
-     * @param token 天地图token
-     * @param baseZIndex 基础层级
-     * @private
-     */
-    private loadDefaultAnnotationLayer;
-    /**
-     * 切换注记类别
-     * @param annotationType 注记类型 ('cva_c' | 'cia_c' | 'cta_c')
-     */
-    switchAnnotationLayer(annotationType: AnnotationType): void;
-    /**
-     * 设置注记图层（私有方法，用于消除代码重复）
-     * @param annotationType 注记类型
-     * @param token 天地图token
-     * @param baseZIndex 基础层级
-     * @private
-     */
-    private setAnnotationLayer;
-    /**
-     * 获取当前注记类型
-     * @returns 当前注记类型
-     */
-    getCurrentAnnotationType(): string | null;
-    /**
-     * 显示/隐藏注记图层
-     * @param visible 是否可见
-     */
-    setAnnotationVisible(visible: boolean): void;
-    /**
-     * 检查注记图层是否可见
-     * @returns 是否可见
-     */
-    isAnnotationVisible(): boolean;
-    /**
-     * 切换底图图层
-     * @param type 图层类型
-     */
-    switchBaseLayer(type: TiandituType | string): void;
-    /**
-     * 获取当前底图类型
-     * @returns 当前底图类型
-     */
-    getCurrentBaseLayerType(): string | null;
-    /**
-     * 获取可用的图层类型列表
-     * @returns 图层类型数组
-     */
-    getAvailableLayerTypes(): string[];
-    /**
-     * 检查指定图层类型是否存在
-     * @param type 图层类型
-     * @returns 是否存在
-     */
-    hasLayerType(type: string): boolean;
-    /**
-     * 添加注记图层（实例方法）
-     * @param options 注记图层选项（不包含token）
-     * @returns 创建的图层
-     */
-    addAnnotationLayer(options: Omit<AnnotationLayerOptions, 'token'>): TileLayer<XYZ>;
-    /**
-     * 添加注记图层（静态方法）
-     * @param map 地图实例
-     * @param options 注记图层选项
-     * @returns 创建的图层
-     */
-    static addAnnotationLayer(map: Map, options: AnnotationLayerOptions): TileLayer<XYZ>;
-    /**
-     * 将所有图层添加到地图
-     * @private
-     */
-    private addMapLayer;
-    /**
-     * 处理图层（应用裁剪等）
-     * @param layer 原始图层
-     * @returns 处理后的图层
-     * @private
-     */
-    private processLayer;
-    /**
-     * 添加GeoServer图层
-     * @param url GeoServer服务URL
-     * @param layerName 图层名称
-     * @param options 图层选项
-     * @returns 创建的WMS图层
-     */
-    addGeoServerLayer(url: string, layerName: string, options?: GeoServerLayerOptions): TileLayer<TileWMS>;
-    /**
-     * 创建天地图图层（实例方法）
-     * @param options 天地图图层选项
-     * @returns 创建的图层
-     * @private
-     */
-    private createTiandituLayer;
-    /**
-     * 创建注记图层（实例方法）
-     * @param options 注记图层选项
-     * @returns 创建的图层
-     * @private
-     */
-    private createAnnotationLayer;
-    /**
-     * 创建天地图底图图层（静态方法）
-     * @param options 天地图图层选项
-     * @returns 创建的图层
-     */
-    static getTiandiTuLayer(options: TiandituLayerOptions): TileLayer<XYZ>;
-    /**
-     * 创建天地图注记图层（静态方法）
-     * @param options 注记图层选项
-     * @returns 创建的图层
-     */
-    static createAnnotationLayer(options: AnnotationLayerOptions): TileLayer<XYZ>;
-    /**
-     * 获取天地图注记图层（向后兼容的静态方法）
-     * @param options 注记图层选项
-     * @returns 创建的图层
-     * @deprecated 使用 createAnnotationLayer 替代
-     */
-    static getAnnotationLayer(options: AnnotationLayerOptions): TileLayer<XYZ>;
-    /**
-     * 创建WMTS瓦片网格
-     * @param length 层级数量
-     * @returns WMTS瓦片网格
-     */
-    static getTileGrid(length: number): WMTSTileGrid;
-    /**
-     * 移除指定类型的图层
-     * @param type 图层类型
-     */
-    removeLayersByType(type: string): void;
-    /**
-     * 清除所有图层
-     */
-    clearAllLayers(): void;
-    /**
-     * 获取图层数量统计
-     * @returns 图层统计信息
-     */
-    getLayerStats(): {
-        totalTypes: number;
-        totalLayers: number;
-        layersByType: Record<string, number>;
-    };
-    /**
-     * 销毁实例，清理资源
-     */
-    destroy(): void;
-}
-export {};
+/**
+ * 地图底图图层管理类
+ * 提供天地图底图、注记图层、GeoServer图层等功能
+ * 支持图层切换、裁剪等高级功能
+ */
+import Map from "ol/Map";
+import { Tile as TileLayer } from "ol/layer";
+import { TileWMS } from "ol/source";
+import WMTSTileGrid from "ol/tilegrid/WMTS";
+import XYZ from "ol/source/XYZ";
+import { MapLayersOptions, TiandituType, AnnotationLayerOptions, AnnotationType } from "../types";
+/**
+ * GeoServer图层选项接口
+ */
+interface GeoServerLayerOptions {
+    /** 图层层级 */
+    zIndex?: number;
+    /** 图层可见性 */
+    visible?: boolean;
+    /** WMS版本 */
+    version?: '1.1.1' | '1.3.0';
+    /** 服务器类型 */
+    serverType?: string;
+    /** 跨域设置 */
+    crossOrigin?: string;
+    /** WMS参数 */
+    params?: Record<string, any>;
+}
+/**
+ * 天地图图层选项接口
+ */
+interface TiandituLayerOptions {
+    /** 图层类型 */
+    type: TiandituType | string;
+    /** 天地图token */
+    token: string;
+    /** 图层层级 */
+    zIndex: number;
+    /** 图层可见性 */
+    visible: boolean;
+}
+/**
+ * 地图底图图层管理类
+ */
+export default class MapBaseLayers {
+    private readonly map;
+    private readonly options;
+    private layers;
+    private readonly errorHandler;
+    private currentBaseLayerType;
+    private currentAnnotationLayer;
+    private currentAnnotationType;
+    /**
+     * 构造函数
+     * @param map OpenLayers地图实例
+     * @param options 图层配置选项
+     */
+    constructor(map: Map, options: MapLayersOptions);
+    /**
+     * 验证构造函数参数
+     * @param map 地图实例
+     * @param options 配置选项
+     * @private
+     */
+    private validateConstructorParams;
+    /**
+     * 合并默认配置选项
+     * @param options 用户配置选项
+     * @returns 合并后的配置选项
+     * @private
+     */
+    private mergeDefaultOptions;
+    /**
+     * 初始化图层
+     * @private
+     */
+    private initializeLayers;
+    /**
+     * 初始化天地图图层
+     * @private
+     */
+    private initTiandituLayers;
+    /**
+     * 加载默认注记图层（cia_c）
+     * @param token 天地图token
+     * @param baseZIndex 基础层级
+     * @private
+     */
+    private loadDefaultAnnotationLayer;
+    /**
+     * 切换注记类别
+     * @param annotationType 注记类型 ('cva_c' | 'cia_c' | 'cta_c')
+     */
+    switchAnnotationLayer(annotationType: AnnotationType): void;
+    /**
+     * 设置注记图层（私有方法，用于消除代码重复）
+     * @param annotationType 注记类型
+     * @param token 天地图token
+     * @param baseZIndex 基础层级
+     * @private
+     */
+    private setAnnotationLayer;
+    /**
+     * 获取当前注记类型
+     * @returns 当前注记类型
+     */
+    getCurrentAnnotationType(): string | null;
+    /**
+     * 显示/隐藏注记图层
+     * @param visible 是否可见
+     */
+    setAnnotationVisible(visible: boolean): void;
+    /**
+     * 检查注记图层是否可见
+     * @returns 是否可见
+     */
+    isAnnotationVisible(): boolean;
+    /**
+     * 切换底图图层
+     * @param type 图层类型
+     */
+    switchBaseLayer(type: TiandituType | string): void;
+    /**
+     * 获取当前底图类型
+     * @returns 当前底图类型
+     */
+    getCurrentBaseLayerType(): string | null;
+    /**
+     * 获取可用的图层类型列表
+     * @returns 图层类型数组
+     */
+    getAvailableLayerTypes(): string[];
+    /**
+     * 检查指定图层类型是否存在
+     * @param type 图层类型
+     * @returns 是否存在
+     */
+    hasLayerType(type: string): boolean;
+    /**
+     * 添加注记图层（实例方法）
+     * @param options 注记图层选项（不包含token）
+     * @returns 创建的图层
+     */
+    addAnnotationLayer(options: Omit<AnnotationLayerOptions, 'token'>): TileLayer<XYZ>;
+    /**
+     * 添加注记图层（静态方法）
+     * @param map 地图实例
+     * @param options 注记图层选项
+     * @returns 创建的图层
+     */
+    static addAnnotationLayer(map: Map, options: AnnotationLayerOptions): TileLayer<XYZ>;
+    /**
+     * 将所有图层添加到地图
+     * @private
+     */
+    private addMapLayer;
+    /**
+     * 处理图层（应用裁剪等）
+     * @param layer 原始图层
+     * @returns 处理后的图层
+     * @private
+     */
+    private processLayer;
+    /**
+     * 添加GeoServer图层
+     * @param url GeoServer服务URL
+     * @param layerName 图层名称
+     * @param options 图层选项
+     * @returns 创建的WMS图层
+     */
+    addGeoServerLayer(url: string, layerName: string, options?: GeoServerLayerOptions): TileLayer<TileWMS>;
+    /**
+     * 创建天地图图层（实例方法）
+     * @param options 天地图图层选项
+     * @returns 创建的图层
+     * @private
+     */
+    private createTiandituLayer;
+    /**
+     * 创建注记图层（实例方法）
+     * @param options 注记图层选项
+     * @returns 创建的图层
+     * @private
+     */
+    private createAnnotationLayer;
+    /**
+     * 创建天地图底图图层（静态方法）
+     * @param options 天地图图层选项
+     * @returns 创建的图层
+     */
+    static getTiandiTuLayer(options: TiandituLayerOptions): TileLayer<XYZ>;
+    /**
+     * 创建天地图注记图层（静态方法）
+     * @param options 注记图层选项
+     * @returns 创建的图层
+     */
+    static createAnnotationLayer(options: AnnotationLayerOptions): TileLayer<XYZ>;
+    /**
+     * 获取天地图注记图层（向后兼容的静态方法）
+     * @param options 注记图层选项
+     * @returns 创建的图层
+     * @deprecated 使用 createAnnotationLayer 替代
+     */
+    static getAnnotationLayer(options: AnnotationLayerOptions): TileLayer<XYZ>;
+    /**
+     * 创建WMTS瓦片网格
+     * @param length 层级数量
+     * @returns WMTS瓦片网格
+     */
+    static getTileGrid(length: number): WMTSTileGrid;
+    /**
+     * 移除指定类型的图层
+     * @param type 图层类型
+     */
+    removeLayersByType(type: string): void;
+    /**
+     * 清除所有图层
+     */
+    clearAllLayers(): void;
+    /**
+     * 获取图层数量统计
+     * @returns 图层统计信息
+     */
+    getLayerStats(): {
+        totalTypes: number;
+        totalLayers: number;
+        layersByType: Record<string, number>;
+    };
+    /**
+     * 销毁实例，清理资源
+     */
+    destroy(): void;
+}
+export {};