v-openlayers 2.9.5 → 2.10.2

package/package/v-map/ol/lib/core/plugins/DrawHandler.d.ts

@@ -0,0 +1,306 @@
+import { Map } from 'ol';
+import { Modify } from 'ol/interaction';
+import { Vector as VectorSource } from 'ol/source';
+import { Vector as VectorLayer } from 'ol/layer';
+import { LineString, Geometry } from 'ol/geom';
+import { Feature } from 'ol';
+/**
+ * 绘制类型枚举
+ */
+declare enum DrawType {
+    Point = "Point",
+    LineString = "LineString",
+    Polygon = "Polygon",
+    Circle = "Circle",
+    Box = "Box",
+    Ring = "Ring"
+}
+/**
+ * 绘制错误代码
+ */
+declare enum DrawErrorCode {
+    EXCLUDE_POINT = 1,// 不相交
+    DEFAULT = 0
+}
+/**
+ * 绘制条件配置接口
+ */
+interface DrawConditionsConfig {
+    intersectGeometries?: Geometry[];
+    showTip?: boolean;
+    maxStepDis?: number;
+    excludeGeometries?: Geometry[];
+    drawType?: DrawType;
+}
+/**
+ * 绘制选项接口
+ */
+interface DrawOptions {
+    map?: Map;
+    type?: DrawType;
+    snapEnable?: boolean;
+    modifyEnable?: boolean;
+    selectEnable?: boolean;
+    onceOnly?: boolean;
+    clear?: boolean;
+    freehand?: boolean;
+    drawStartHandle?: (params: DrawEventParams) => void;
+    drawEndHandle?: (params: DrawEventParams) => void;
+    selectedHandle?: (params: SelectEventParams) => void;
+    modifyEndHandle?: (params: ModifyEventParams) => void;
+    conditions?: DrawConditionsConfig;
+    style?: any;
+}
+/**
+ * 绘制事件参数接口
+ */
+interface DrawEventParams {
+    e: any;
+    code?: DrawErrorCode;
+    intersect?: boolean;
+    feature?: Feature;
+    coordinates?: any[];
+    type?: string;
+    wkt?: string;
+    layer?: VectorLayer<any>;
+    dbClick?: boolean;
+}
+/**
+ * 选择事件参数接口
+ */
+interface SelectEventParams {
+    features?: Feature[];
+    layer?: VectorLayer<any>;
+}
+/**
+ * 编辑事件参数接口
+ */
+interface ModifyEventParams {
+    e: any;
+    features?: Feature[];
+    layer?: VectorLayer<any>;
+}
+/**
+ * @description 绘制处理器类
+ */
+declare class DrawHandler {
+    private map;
+    private curFeature;
+    private flag;
+    private remenberDrawCoordinates;
+    private rememberCoordsClone;
+    private step;
+    private timer;
+    private source;
+    private vector;
+    private draw;
+    private snap;
+    private modify;
+    private select;
+    private bInit;
+    private selectEnable;
+    private layerId;
+    private zIndex;
+    private imageStyle;
+    private defaultStyle;
+    private drawConditions;
+    private interactionHandler;
+    private layerHandler;
+    private drawType;
+    private spliceSnaps;
+    private splicePoints;
+    private spliceFeature;
+    private spliceLinestring;
+    private readonly splicePointsLayerId;
+    /**
+     * 键盘事件处理
+     */
+    private handleKeydown;
+    /**
+     * 构造函数
+     * @param map 地图实例
+     */
+    constructor(map?: Map | null);
+    /**
+     * 获取绘制类型枚举
+     */
+    getDrawType(): typeof DrawType;
+    /**
+     * 获取绘制的矢量图层
+     */
+    getLayer(): VectorLayer<any> | null;
+    /**
+     * 创建矢量图层
+     * @param style 样式配置
+     */
+    private createLayer;
+    /**
+     * 初始化矢量图层
+     * @param map 地图实例
+     */
+    private initVectorLayer;
+    /**
+     * 移除交互
+     * @param map 地图实例
+     */
+    private removeInteraction;
+    /**
+     * 移除绘制交互
+     * @param map 地图实例
+     */
+    removeDraw(map?: Map): void;
+    /**
+     * 激活捕捉
+     */
+    activeSnap(): void;
+    /**
+     * 移除捕捉
+     * @param map 地图实例
+     */
+    removeSnap(map?: Map): void;
+    /**
+     * 添加编辑交互
+     * @param map 地图实例
+     * @param selectEnable 是否启用选择
+     * @param modifyEnable 是否启用编辑
+     */
+    addModify(map: Map, selectEnable?: boolean, modifyEnable?: boolean): void;
+    /**
+     * 激活选择
+     * @param map 地图实例
+     */
+    activeSelect(map?: Map): void;
+    /**
+     * 移除选择
+     * @param map 地图实例
+     */
+    removeSelect(map?: Map): void;
+    /**
+     * 激活编辑
+     * @param map 地图实例
+     */
+    activeModify(map?: Map): Modify | null;
+    /**
+     * 移除编辑
+     * @param map 地图实例
+     */
+    removeModify(map?: Map): void;
+    /**
+     * 绘制图形
+     * @param options 绘制选项
+     * @param type 绘制类型 Point|LineString|Polygon|Circle|Box|Ring
+     * @param selectEnable 是否启用选择
+     * @param modifyEnable 是否启用编辑
+     * @param onceOnly 是否仅绘制一次
+     * @param clear 是否清除之前的绘制
+     * @param freehand 是否启用自由绘制
+     * @param drawStartHandle 绘制开始回调
+     * @param drawEndHandle 绘制结束回调
+     * @param selectedHandle 选择回调
+     * @param modifyEndHandle 编辑结束回调
+     * @param conditions 绘制条件
+     * @param style 样式配置
+     */
+    drawByType(options: DrawOptions): boolean;
+    /**
+     * 创建环形
+     * @param center 中心点坐标
+     * @param innerR 内半径
+     * @param outerR 外半径
+     */
+    private createRing;
+    /**
+     * 初始化绘制条件
+     * @param conditions 条件配置
+     */
+    private initConditions;
+    /**
+     * 绘制点
+     * @param drawEndHandle 绘制结束回调
+     * @param options 绘制选项
+     */
+    drawPoint(drawEndHandle?: ((params: DrawEventParams) => void) | null, options?: Partial<DrawOptions>): boolean;
+    /**
+     * 绘制线
+     * @param drawEndHandle 绘制结束回调
+     * @param options 绘制选项
+     */
+    drawLineString(drawEndHandle?: ((params: DrawEventParams) => void) | null, options?: Partial<DrawOptions>): boolean;
+    /**
+     * 结束绘制
+     * @param map 地图实例
+     */
+    endDraw(map?: Map): void;
+    /**
+     * 结束交互
+     * @param map 地图实例
+     */
+    endInteraction(map?: Map): void;
+    /**
+     * 删除绘制图层
+     * @param map 地图实例
+     */
+    remove(map?: Map): void;
+    /**
+     * 清空绘制图形
+     * @param map 地图实例
+     */
+    clear(map?: Map): void;
+    /**
+     * 后退一步
+     */
+    backward(): void;
+    /**
+     * 线段分割
+     * @param param0 分割参数
+     */
+    spliceLine({ source, line, style, callback, }: {
+        source: VectorSource;
+        line: LineString;
+        style: any;
+        callback: (spliced: any) => void;
+    }): void;
+    /**
+     * 处理线段分割完成
+     * @param callback 回调函数
+     */
+    private handleSpliceLineComplete;
+    /**
+     * 处理分割点
+     * @param coordinates 坐标
+     * @param source 数据源
+     * @param style 样式
+     */
+    private handleSplicePoint;
+    /**
+     * 设置分割捕捉交互
+     * @param source 数据源
+     * @param style 样式
+     */
+    private setupSpliceSnapInteractions;
+    /**
+     * 创建分割点图层
+     * @param point 点坐标
+     * @param style 样式
+     */
+    private createSplitPointsLayer;
+    /**
+     * 获取相交的线段
+     * @param geometry 几何体
+     * @param coordinate 坐标
+     */
+    private getIntersectLinestring;
+    /**
+     * 移除最后一个点
+     */
+    private removeLastPoint;
+    /**
+     * 结束线段分割
+     */
+    endSpliceLine(): void;
+    /**
+     * 重置分割状态
+     */
+    private resetSpliceState;
+}
+export default DrawHandler;

package/package/v-map/ol/lib/core/plugins/FeatureHandler.d.ts

@@ -0,0 +1,117 @@
+import VectorLayer from 'ol/layer/Vector';
+import { Style } from 'ol/style';
+import { Feature } from 'ol';
+import { Geometry } from 'ol/geom';
+import { Map } from 'ol';
+/**
+ * 要素样式选项接口
+ */
+interface FeatureStyleOptions {
+    field?: string;
+    style?: Style;
+    labelField?: string;
+}
+/**
+ * 点要素创建选项接口
+ */
+interface CreatePointsOptions {
+    style?: Style;
+    featureId?: string;
+    layerId?: string;
+    points: Array<{
+        lgtd: number;
+        lttd: number;
+        code?: string;
+        [key: string]: any;
+    }>;
+}
+/**
+ * 图层管理接口
+ */
+interface LayerCollection {
+    [layerId: string]: VectorLayer<any> | null;
+}
+/**
+ * 从GeoJSON数据获取要素并应用样式
+ * @param geojson GeoJSON数据
+ * @param options 样式选项
+ * @returns 样式化后的要素数组
+ */
+export declare function getFeaturesFromGeojson(geojson: any, options?: FeatureStyleOptions): Feature<Geometry>[];
+/**
+ * 从GeoJSON数据获取聚类要素（待实现）
+ * @param geojson GeoJSON数据
+ * @returns 聚类要素数组
+ */
+export declare function getFeatureClusterFromGeojson(geojson: any): Feature<Geometry>[];
+/**
+ * 根据GeoJSON创建点要素图层
+ * @param options 创建选项
+ * @param map 地图实例
+ * @returns 创建的矢量图层
+ */
+export declare function createPointsByGeojson(options: CreatePointsOptions, map: Map): VectorLayer<any> | null;
+/**
+ * 根据图层ID移除图层
+ * @param layerId 图层ID
+ * @param map 地图实例
+ */
+export declare function removeLayerById(layerId: string, map: Map): void;
+/**
+ * 获取所有图层
+ * @returns 图层集合
+ */
+export declare function getLayerCollection(): LayerCollection;
+/**
+ * 清空所有图层
+ * @param map 地图实例
+ */
+export declare function clearAllLayers(map: Map): void;
+/**
+ * 根据图层ID获取图层
+ * @param layerId 图层ID
+ * @returns 图层实例或null
+ */
+export declare function getLayerById(layerId: string): VectorLayer<any> | null;
+/**
+ * 检查图层是否存在
+ * @param layerId 图层ID
+ * @returns 是否存在
+ */
+export declare function checkLayerExists(layerId: string): boolean;
+/**
+ * 要素处理器工具类
+ */
+export declare class FeatureHandler {
+    private map;
+    private layerCollection;
+    constructor(map: Map);
+    /**
+     * 创建点要素图层
+     * @param options 创建选项
+     * @returns 创建的图层
+     */
+    createPointsLayer(options: CreatePointsOptions): VectorLayer<any> | null;
+    /**
+     * 移除图层
+     * @param layerId 图层ID
+     */
+    removeLayer(layerId: string): void;
+    /**
+     * 清空所有图层
+     */
+    clearAllLayers(): void;
+    /**
+     * 获取图层
+     * @param layerId 图层ID
+     * @returns 图层实例
+     */
+    getLayer(layerId: string): VectorLayer<any> | null;
+    /**
+     * 检查图层是否存在
+     * @param layerId 图层ID
+     * @returns 是否存在
+     */
+    hasLayer(layerId: string): boolean;
+}
+export default FeatureHandler;

package/package/v-map/ol/lib/core/plugins/GeojsonHandler.d.ts

@@ -0,0 +1,76 @@
+import GeoJSON from 'ol/format/GeoJSON';
+import VectorLayer from 'ol/layer/Vector';
+import { Style } from 'ol/style';
+import Feature from 'ol/Feature';
+import { Geometry } from 'ol/geom';
+/**
+ * GeoJSON处理选项接口
+ */
+interface Wkt2LayerOptions {
+    id?: string;
+    style?: Style;
+}
+/**
+ * @description GeoJSON处理工具类
+ * 提供WKT与GeoJSON之间的相互转换功能
+ */
+export default class GeojsonHandler extends GeoJSON {
+    /** 默认样式配置 */
+    private readonly defaultStyle;
+    constructor();
+    /**
+     * 将要素转换为WKT格式
+     * @param feature - 要转换的要素
+     * @returns WKT字符串，如果是圆形几何体则返回空字符串
+     */
+    feature2wkt(feature: Feature<Geometry>): string;
+    /**
+     * 将图层转换为WKT格式
+     * @param layer - 要转换的矢量图层
+     * @returns WKT字符串或错误信息
+     */
+    layer2wkt(layer: VectorLayer<any> | null): string;
+    /**
+     * 将WKT字符串转换为矢量图层
+     * @param wkt - WKT格式的几何体字符串
+     * @param options - 图层配置选项
+     * @param options.id - 图层ID，默认使用UUID
+     * @param options.style - 要素样式，默认使用默认样式
+     * @returns 创建的矢量图层
+     */
+    wkt2layer(wkt: string, options?: Wkt2LayerOptions): VectorLayer<any>;
+    /**
+     * 将GeoJSON转换为WKT格式
+     * @param geojson - GeoJSON对象或字符串
+     * @returns WKT字符串
+     */
+    geojson2wkt(geojson: object | string): string;
+    /**
+     * 将WKT转换为GeoJSON格式
+     * @param wkt - WKT字符串
+     * @returns GeoJSON对象
+     */
+    wkt2geojson(wkt: string): object;
+    /**
+     * 将要素数组转换为GeoJSON格式
+     * @param features - 要素数组
+     * @returns GeoJSON对象
+     */
+    features2geojson(features: Feature<Geometry>[]): object;
+    /**
+     * 从GeoJSON创建矢量图层
+     * @param geojson - GeoJSON对象或字符串
+     * @param options - 图层配置选项
+     * @param options.id - 图层ID，默认使用UUID
+     * @param options.style - 要素样式，默认使用默认样式
+     * @returns 创建的矢量图层
+     */
+    geojson2layer(geojson: object | string, options?: Wkt2LayerOptions): VectorLayer<Feature<Geometry>>;
+    /**
+     * 将VectorLayer转换为GeoJSON格式
+     * @param layer VectorLayer对象
+     * @returns GeoJSON对象
+     */
+    layer2geojson(layer: VectorLayer<Feature<Geometry>> | null): object;
+}
+export {};

package/package/v-map/ol/lib/core/plugins/GeometryHandler.d.ts

@@ -0,0 +1,117 @@
+import { Polygon, Point } from 'ol/geom';
+import { Style } from 'ol/style';
+import Feature from 'ol/Feature';
+import VectorLayer from 'ol/layer/Vector';
+import Map from 'ol/Map';
+/**
+ * 点坐标接口
+ */
+interface PointCoordinate {
+    lgtd: number;
+    lttd: number;
+    code?: string;
+    [key: string]: any;
+}
+/**
+ * 创建点图层配置选项
+ */
+interface CreatePointsOptions {
+    map: Map;
+    points: PointCoordinate[];
+    style?: Style;
+    layerId?: string;
+    featureId?: string;
+    zIndex?: number;
+}
+/**
+ * @description 几何图形处理工具类
+ * 提供圆形、环形、点等几何图形的创建功能
+ */
+export declare class GeometryHandler {
+    private readonly defaultStyle;
+    private layerHandler;
+    constructor();
+    /**
+     * 创建圆形点坐标数组
+     * @param map - 地图实例
+     * @param origin - 圆心坐标 [x, y]
+     * @param radius - 圆的半径（像素）
+     * @returns 圆形边界点坐标数组
+     */
+    private createCirclePoints;
+    /**
+     * 创建圆形多边形
+     * @param map - 地图实例
+     * @param center - 圆心坐标 [x, y]
+     * @param radius - 圆的半径（像素）
+     * @returns 圆形多边形几何体
+     */
+    createCircle(center: [number, number], radius: number): Polygon;
+    /**
+     * 创建环形多边形（圆环）
+     * @param map - 地图实例
+     * @param center - 圆心坐标 [x, y]
+     * @param outerRadius - 外圆半径（像素）
+     * @param innerRadius - 内圆半径（像素）
+     * @returns 环形多边形几何体
+     */
+    createRing(center: [number, number], outerRadius: number, innerRadius: number): Polygon;
+    /**
+     * 创建单个点要素
+     * @param coordinate - 点坐标 [x, y]
+     * @param style - 点样式
+     * @param properties - 点属性
+     * @returns 点要素
+     */
+    createPoint(coordinate: [number, number], style?: Style, properties?: Record<string, any>): Feature<Point>;
+    /**
+     * 创建点图层
+     * @param options - 创建点图层的配置选项
+     * @returns 创建的矢量图层
+     */
+    createPoints(options: CreatePointsOptions): VectorLayer<any>;
+    /**
+     * 创建圆形要素
+     * @param center - 圆心坐标 [x, y]
+     * @param radius - 圆的半径（像素）
+     * @param style - 样式配置
+     * @param properties - 要素属性
+     * @returns 圆形要素
+     */
+    createCircleFeature(center: [number, number], radius: number, style?: Style, properties?: Record<string, any>): Feature<Polygon>;
+    /**
+     * 创建环形要素
+     * @param center - 圆心坐标 [x, y]
+     * @param outerRadius - 外圆半径（像素）
+     * @param innerRadius - 内圆半径（像素）
+     * @param style - 样式配置
+     * @param properties - 要素属性
+     * @returns 环形要素
+     */
+    createRingFeature(center: [number, number], outerRadius: number, innerRadius: number, style?: Style, properties?: Record<string, any>): Feature<Polygon>;
+    /**
+     * 创建圆形图层
+     * @param map - 地图实例
+     * @param center - 圆心坐标 [x, y]
+     * @param radius - 圆的半径（像素）
+     * @param layerId - 图层ID
+     * @param style - 样式配置
+     * @returns 创建的矢量图层
+     */
+    createCircleLayer(map: Map, center: [number, number], radius: number, layerId?: string, style?: Style): VectorLayer<any>;
+    /**
+     * 创建环形图层
+     * @param map - 地图实例
+     * @param center - 圆心坐标 [x, y]
+     * @param outerRadius - 外圆半径（像素）
+     * @param innerRadius - 内圆半径（像素）
+     * @param layerId - 图层ID
+     * @param style - 样式配置
+     * @returns 创建的矢量图层
+     */
+    createRingLayer(map: Map, center: [number, number], outerRadius: number, innerRadius: number, layerId?: string, style?: Style): VectorLayer<any>;
+}
+export declare function createCircle(map: Map, center: [number, number], radius: number): Polygon;
+export declare function createRing(map: Map, center: [number, number], outerRadius: number, innerRadius: number): Polygon;
+export declare function createPoints(options: CreatePointsOptions): VectorLayer<any>;
+export default GeometryHandler;