import { default as default_10 } from 'ol/style/Fill';
import { default as default_11 } from 'ol/style/Stroke';
import { default as default_12 } from 'ol/source/Vector';
import { default as default_13 } from 'ol/MapBrowserEvent';
import { default as default_2 } from 'ol/Feature';
import { default as default_3 } from 'ol/Map';
import { default as default_4 } from 'ol/layer/Base';
import { default as default_5 } from 'ol/layer/Layer';
import { default as default_6 } from 'ol/source/ImageWMS';
import { default as default_7 } from 'ol/source/TileWMS';
import { default as default_8 } from 'ol/layer/Group';
import { default as default_9 } from 'ol/source/WMTS';
import { Geometry } from 'ol/geom';
import { Style } from 'ol/style';
import { StyleLike } from 'ol/style/Style';

/**
 * 从GeoJSON数据添加线矢量图层到地图
 *
 * @param olMap - 目标地图实例
 * @param lineStringGeoJSON - GeoJSON格式的线要素数据
 * @param lineOptions - 图层配置选项(zIndex默认4,visible默认true,hoverStyle/featureColor默认true)
 */
export declare function addLineStringLayer(olMap: default_3, lineStringGeoJSON: GeoJSONData, lineOptions?: LineStringOptions): void;

/**
 * 为地图添加弹出层(Overlay)组件,包含关闭按钮和内容容器
 *
 * @param olMap - 目标地图实例
 * @returns
 */
export declare function addOverlayPopup(olMap: default_3): void;

/**
 * 从点数据添加支持缩放级别和聚合的点矢量图层到地图
 *
 * @param olMap - 目标地图实例
 * @param pointData - 点数据数组(包含LGTD/LTTD坐标信息)
 * @param pointOptions - 图层配置选项(zoomNumber默认5.5,distance默认30)
 * @returns 入参无效时返回空对象字面量(保留旧行为),正常执行无返回
 */
export declare function addPointDataLayer(olMap: default_3, pointData: PointDataItem[], pointOptions: PointDataOptions): Record<string, never> | undefined;

/**
 * 从GeoJSON数据添加点矢量图层到地图
 *
 * @param olMap - 目标地图实例
 * @param pointGeoJSON - GeoJSON格式的点要素数据
 * @param pointOptions - 图层配置选项(zIndex默认5,visible默认true,hoverStyle默认true)
 */
export declare function addPointLayer(olMap: default_3, pointGeoJSON: GeoJSONData, pointOptions: PointOptions): void;

/**
 * 从GeoJSON数据添加多边形矢量图层到地图
 *
 * @param olMap - 目标地图实例
 * @param polygonGeoJSON - GeoJSON格式的多边形要素数据
 * @param polygonOptions - 图层配置选项(zIndex默认3,visible默认true,hoverStyle/featureColor默认true,styles与默认样式深合并)
 */
export declare function addPolygonLayer(olMap: default_3, polygonGeoJSON: GeoJSONData, polygonOptions?: PolygonOptions): void;

/**
 * 从GeoJSON数据添加雨量多边形图层到地图
 * (根据要素的highValue和lowValue匹配颜色配置,设置多边形填充色)
 *
 * @param olMap - 目标地图实例
 * @param rainPolygonGeoJSON - GeoJSON格式的雨量多边形要素数据
 * @param rainPolygonOptions - 图层配置选项(renderColor为必填的颜色区间配置,zIndex默认3,visible默认true)
 */
export declare function addRainPolygonLayer(olMap: default_3, rainPolygonGeoJSON: GeoJSONData, rainPolygonOptions: RainPolygonOptions): void;

/**
 * 向地图添加WFS矢量图层(动态加载要素)
 *
 * @param olMap - 目标地图实例
 * @param wfsOptions - WFS图层配置项
 */
export declare function addWfsLayer(olMap: default_3, wfsOptions: WfsLayerOptions): void;

/**
 * 向地图添加WMS瓦片图层
 *
 * @param olMap - 目标地图实例
 * @param wmsOptions - WMS图层配置项
 */
export declare function addWmsLayer(olMap: default_3, wmsOptions: WmsLayerOptions): void;

/**
 * 百度坐标系(BD09)转火星坐标系(GCJ02)
 * @param bdLon - BD09经度
 * @param bdLat - BD09纬度
 * @returns GCJ02坐标 [经度, 纬度]
 */
export declare function bd09Togcj02(bdLon: number, bdLat: number): LonLat;

/**
 * 为地图添加框选交互(支持按住修饰键拖拽框选和点击选择要素)
 *
 * 选择变化回调经 500ms 防抖,参数为选中要素的名称数组;
 * 与旧版行为一致:仅当选中要素数量大于 0 时才触发回调(清空选择不回调)。
 *
 * @param olMap - 地图实例
 * @param boxSelectionOptions - 框选配置项
 * @param selectionCallbackFn - 选择变化时的回调函数(参数为选中要素的名称数组)
 */
export declare function boxSelectionFeatures(olMap: default_3, boxSelectionOptions: BoxSelectionOptions, selectionCallbackFn?: (selectedNames: string[]) => void): void;

export declare interface BoxSelectionOptions {
    /** 目标图层名 */
    layerName: string;
    /** 回调中提取名称的字段,默认 'name' */
    textFieldName?: string;
    /** 覆盖选中样式 */
    styles?: StyleOptions;
}

export declare interface CircleConfig {
    radius?: number;
    fill?: FillLike;
    stroke?: StrokeLike;
    scale?: number | [number, number];
    displacement?: number[];
    rotation?: number;
    rotateWithView?: boolean;
}

/**
 * 清理 hoverChangeStyle 添加的事件监听
 * @param olMap - 地图实例
 */
export declare function clearHoverChangeStyle(olMap: default_3): void;

/**
 * 清理 hoverShowTips 添加的事件和图层
 * @param olMap - 地图实例
 */
export declare function clearHoverShowTips(olMap: default_3): void;

/**
 * 清除指定地图的所有测量结果(要素、样式及交互状态)
 * @param olMap - 地图实例,不传则打印警告后直接返回(WeakMap 无法遍历全部地图)
 */
export declare function clearMeasure(olMap?: default_3): void;

/**
 * 清理指定地图的所有WFS相关事件和请求
 *
 * @param olMap - 地图实例
 */
export declare function clearWfsEvents(olMap: default_3): void;

/** 绘制回调:参数为承载绘制结果的 VectorSource */
export declare type DrawCallback = (source: default_12<default_2<Geometry>>) => void;

/**
 * 在地图上创建绘制交互(支持绘制、修改图形,并触发回调返回绘制数据)
 * @param map - 地图实例
 * @param drawOptions - 绘制配置项
 * @param drawCallbackFn - 绘制/修改结束后的回调函数(参数为包含绘制要素的数据源)
 */
export declare function drawFeatures(map: default_3, drawOptions: DrawOptions, drawCallbackFn?: DrawCallback): void;

export declare interface DrawOptions {
    /** 绘制类型('Point' | 'LineString' | 'Polygon' | 'Circle' 等) */
    type: string;
    /** 开始新绘制前是否清除已绘制要素,默认 false */
    clearPrevious?: boolean;
    /** 自定义样式配置 */
    styles?: StyleOptions;
}

export declare interface ExportImageOptions {
    /** 导出裁剪尺寸 [宽, 高],居中裁剪 */
    size?: number[];
    title?: ExportImageTitleOption;
    subtitle?: ExportImageTitleOption;
    /** 图例图片 URL,默认 1x1 透明 PNG */
    legend?: string;
    /** 默认 'image/png' */
    type?: string;
    /** 默认 0.8 */
    quality?: number;
    /** 是否自动触发浏览器下载,默认 true */
    down?: boolean;
}

export declare interface ExportImageTitleOption {
    name?: string;
    color?: string;
    fontSize?: string;
}

/**
 * 将OpenLayers地图导出为图片(支持添加标题、图例和自动下载)
 *
 * @param olMap - OpenLayers地图实例
 * @param options - 导出配置项
 * @returns 导出图片的base64字符串;地图实例、绘图上下文或地图尺寸不存在时返回 undefined
 */
export declare function exportMapToImage(olMap: default_3, options?: ExportImageOptions): Promise<string | undefined>;

/** 要素属性包(对应 feature.getProperties() 的结果) */
export declare type FeatureProperties = Record<string, any>;

export declare interface FillConfig {
    color?: StyleColor;
}

/** 填充配置:普通对象或 Fill 实例 */
export declare type FillLike = FillConfig | default_10;

/**
 * 在地图上创建自由手绘交互(支持自由绘制、修改图形,触发回调返回绘制数据)
 * @param map - 地图实例
 * @param drawOptions - 手绘配置项
 * @param freehandDrawCallbackFn - 绘制/修改结束后的回调函数(参数为包含手绘要素的数据源)
 */
export declare function freehandDrawing(map: default_3, drawOptions: DrawOptions, freehandDrawCallbackFn?: DrawCallback): void;

/**
 * 火星坐标系(GCJ02)转百度坐标系(BD09)
 * @param gcjLon - GCJ02经度
 * @param gcjLat - GCJ02纬度
 * @returns BD09坐标 [经度, 纬度]
 */
export declare function gcj02Tobd09(gcjLon: number, gcjLat: number): LonLat;

/**
 * 火星坐标系(GCJ02)转WGS84经纬度(近似反推算法,非精确解,存在米级误差)
 * @param gcjLon - GCJ02经度
 * @param gcjLat - GCJ02纬度
 * @returns WGS84坐标 [经度, 纬度](国内坐标解密,国外坐标不变)
 */
export declare function gcj02Towgs84(gcjLon: number, gcjLat: number): LonLat;

/** GeoJSON 数据:readFeatures 可消费的对象或 JSON 字符串 */
export declare type GeoJSONData = object | string;

/** GeoJSON Feature 对象(WFS/GetFeatureInfo 返回的原始 JSON 要素,非 ol/Feature) */
export declare interface GeoJSONFeature {
    type: 'Feature';
    geometry: unknown;
    properties: FeatureProperties;
    [key: string]: any;
}

/**
 * 获取所有图层(包括嵌套在LayerGroup中的图层),支持通过过滤器筛选
 *
 * @param collection - 图层集合(地图实例或图层组)
 * @param filter - 图层过滤器函数,返回true则保留该图层
 * @returns 所有符合条件的图层数组(子图层在前、组本身在后)
 */
export declare function getAllLayers(collection: default_3 | default_8, filter?: (layer: default_4) => boolean): default_4[];

/**
 * 通过图层名称(layerName属性)获取地图中对应的图层
 *
 * @param map - 地图实例
 * @param name - 要查找的图层名称(对应图层的layerName属性值)
 * @returns 匹配的图层实例,未找到则返回undefined
 */
export declare function getLayerByName(map: default_3, name: string): default_4 | undefined;

/**
 * 通过WMS图层的参数名(LAYERS参数)查找对应的图层
 *
 * @param map - 地图实例
 * @param name - 要匹配的LAYERS参数值
 * @returns 匹配的WMS图层,未找到则返回undefined
 */
export declare function getLayerByNameParam(map: default_3, name: string): WMSLayer | undefined;

/**
 * 获取指定图层的URL(支持WMS和WMTS类型图层)
 *
 * @param layer - 目标图层(WMS或WMTS类型)
 * @returns 图层的URL,获取失败则返回空字符串
 */
export declare function getLayerUrl(layer: WMSOrWMTSLayer): string;

/**
 * 获取绘图样式
 * 根据配置项生成 OpenLayers 的 Style 对象,支持填充、描边、图片、文本等样式
 *
 * @param options - 样式配置项
 * @returns OpenLayers 的 Style 实例
 */
export declare function getOptionsStyle(options: StyleOptions): Style;

/**
 * 为WMS瓦片图层绑定点击事件,获取要素信息并触发回调
 * 同时处理鼠标悬停时的光标样式变化
 *
 * @param olMap - 目标地图实例
 * @param wfsOptions - 配置项(与图层标识相关)
 * @param getFeatureCallbackFn - 获取要素后的回调函数(参数为GeoJSON Feature数组)
 * @returns 清理函数,调用可移除事件监听
 */
export declare function getWmsFeature(olMap: default_3, wfsOptions: GetWmsFeatureOptions, getFeatureCallbackFn?: WmsFeatureCallback): () => void;

export declare interface GetWmsFeatureOptions {
    layerName?: string;
    layers?: string;
    /** 额外 GetFeatureInfo 请求参数 */
    params?: Record<string, unknown>;
}

/**
 * 为地图添加 hover 样式变化效果
 * 当鼠标悬停在指定图层要素上时,改变要素样式
 *
 * @param olMap - 地图实例
 * @param hoverOptions - hover 配置项
 */
export declare function hoverChangeStyle(olMap: default_3, hoverOptions: HoverOptions): void;

export declare interface HoverOptions {
    /** 目标图层名称标识 */
    layerName?: string;
    /** 文本(提示)字段名称 */
    textFieldName?: string;
    /** 悬停时的图标地址 */
    icon?: string;
    /** 文本颜色 */
    textColor?: string;
    /** 自定义样式配置 */
    styles?: StyleOptions;
}

/**
 * 为地图添加 hover 提示效果
 * 当鼠标悬停在指定图层要素上时,显示提示信息
 *
 * @param olMap - 地图实例
 * @param hoverOptions - hover 配置项
 */
export declare function hoverShowTips(olMap: default_3, hoverOptions: HoverOptions): void;

export declare interface IconConfig {
    src?: string;
    anchor?: number[];
    scale?: number | [number, number];
    color?: StyleColor;
    crossOrigin?: string | null;
    size?: [number, number];
    imgSize?: [number, number];
    offset?: number[];
    opacity?: number;
    rotation?: number;
    rotateWithView?: boolean;
}

/**
 * 图像样式配置,四种互斥形态(按优先级):
 * 1. `src` 直传 → Icon
 * 2. `icon` 嵌套对象 → Icon
 * 3. `circle`(可为配置对象)或 `radius` → CircleStyle
 * 4. `star` → RegularShape
 * 其余字段(radius/fill/stroke/points/angle 等)作为 Circle/RegularShape 的构造参数。
 */
export declare interface ImageConfig extends RegularShapeConfig {
    src?: string;
    anchor?: number[];
    icon?: IconConfig;
    circle?: CircleConfig | boolean;
    star?: RegularShapeConfig | boolean;
}

/**
 * 判断坐标是否在中国大陆范围内(不在国内则不进行GCJ02加密)
 * @param lng - 经度
 * @param lat - 纬度
 * @returns 是否在国外(true:国外,false:国内)
 */
export declare function isOutOfChina(lng: number, lat: number): boolean;

/**
 * 判断图层在当前地图缩放级别下是否可见
 *
 * @param layer - 待判断的图层
 * @param map - 地图实例
 * @returns 图层是否可见
 */
export declare function judgeLayerVisible(layer: default_4, map: default_3): boolean;

export declare interface LineStringOptions {
    layerName?: string;
    /** 默认 4 */
    zIndex?: number;
    /** 默认 true */
    visible?: boolean;
    textFieldName?: string;
    styles?: StyleOptions;
    /** 默认 true */
    hoverStyle?: boolean;
    /** 是否使用要素自身 color/COLOR 属性着色,默认 true */
    featureColor?: boolean;
}

/** 经纬度坐标对 */
export declare type LonLat = [number, number];

/**
 * 测量面积(面要素)
 * @param olMap - 地图实例
 * @param measureOption - 测量配置项
 * @param measureCallbackFn - 测量完成后的回调函数(参数为格式化的面积)
 */
export declare function measureArea(olMap: default_3, measureOption?: MeasureOption, measureCallbackFn?: (area: string) => void): void;

/**
 * 测量距离(线要素)
 * @param olMap - 地图实例
 * @param measureOption - 测量配置项
 * @param measureCallbackFn - 测量完成后的回调函数(参数为格式化的距离)
 */
export declare function measureLength(olMap: default_3, measureOption?: MeasureOption, measureCallbackFn?: (length: string) => void): void;

export declare interface MeasureOption {
    /** 是否显示分段标注,默认 true */
    showSegments?: boolean;
    /** 开始新测量前是否清除上一次结果,默认 true */
    clearPrevious?: boolean;
}

/**
 * Web墨卡托坐标转WGS84经纬度
 * @param mercatorLon - Web墨卡托X坐标(经度方向)
 * @param mercatorLat - Web墨卡托Y坐标(纬度方向)
 * @returns WGS84坐标 [经度, 纬度]
 */
export declare function mercatorTowgs84(mercatorLon: number, mercatorLat: number): LonLat;

export declare interface PickBufferRange {
    minZoom: number;
    maxZoom: number;
    bufferMeters: number;
}

/**
 * 点击地图时,在指定范围内获取符合类型的可见图层中的要素属性
 *
 * @param event - 地图点击事件对象
 * @param pickLayerType - 要拾取的图层类型(如'Point'、'Polygon'等,需与图层的pickLayerName属性匹配),默认 'Point'
 * @param options - 可选的配置项,用于自定义缓冲范围计算
 * @returns 符合条件的要素属性数组(每个元素为要素的properties对象,含geometry)
 *
 * @example
 * // 使用默认硬编码缓冲逻辑(兼容旧版)
 * const features = pickFeaturesByName(event);
 *
 * @example
 * // 使用自定义函数
 * const features = pickFeaturesByName(event, 'Point', {
 *   getBufferMeters: (zoom) => Math.max(10, 5000 / zoom)
 * });
 *
 * @example
 * // 使用区间配置
 * const features = pickFeaturesByName(event, 'Point', {
 *   bufferConfig: [
 *     { minZoom: 0, maxZoom: 5, bufferMeters: 50000 },
 *     { minZoom: 6, maxZoom: 10, bufferMeters: 12000 },
 *     { minZoom: 18, maxZoom: Infinity, bufferMeters: 10 }
 *   ]
 * });
 */
export declare function pickFeaturesByName(event: default_13<UIEvent>, pickLayerType?: string, options?: PickOptions): FeatureProperties[];

/**
 * 创建要素选择弹出层(Overlay),展示拾取到的要素列表供用户选择
 *
 * @param olMap - 地图实例
 * @param pickOptions - 弹出层配置项
 * @param overlayCallbackFn - 选择要素后的回调函数(参数为去掉 geometry 属性的要素数据;仅 1 条数据时不弹层直接回调原始数据)
 */
export declare function pickFeaturesPopover(olMap: default_3, pickOptions: PickPopoverOptions, overlayCallbackFn?: (selectedFeature: FeatureProperties) => void): void;

export declare interface PickOptions {
    /** 完全自定义缓冲米数(优先级最高) */
    getBufferMeters?: (zoom: number) => number;
    /** 按缩放区间配置缓冲米数(未匹配区间回退 100 米) */
    bufferConfig?: PickBufferRange[];
}

export declare interface PickPopoverOptions {
    /** 要素数据(数组或单个对象) */
    data: FeatureProperties[] | FeatureProperties;
    textFieldName?: TextFieldName;
    /** 无有效字段时的回退文本,字符串支持 {index} 占位符 */
    fallbackText?: string | ((feature: FeatureProperties, index: number) => string);
    /** 默认 '请选择' */
    title?: string;
    /** 默认 'PickStationOverlay' */
    overlayId?: string;
    /** 默认 'bottom-center' */
    positioning?: string;
    /** 默认 true */
    autoPan?: boolean;
}

export declare interface PointDataItem {
    LGTD?: number | string;
    LTTD?: number | string;
    lgtd?: number | string;
    lttd?: number | string;
    [key: string]: any;
}

export declare interface PointDataOptions {
    layerName?: string;
    className?: string;
    /** 默认 5 */
    zIndex?: number;
    /** 默认 true */
    visible?: boolean;
    textFieldName?: string;
    icon?: string;
    textColor?: string;
    styles?: {
        image?: ImageConfig;
        text?: TextConfig;
    };
    /** 默认 true */
    hoverStyle?: boolean;
    /** 缩放级别字段名(字段值须为数字 1-8,不匹配的点会被丢弃) */
    zoomFieldName?: string;
    /** minZoom 偏移量,默认 5.5 */
    zoomNumber?: number;
    /** 是否聚合,默认 false */
    cluster?: boolean;
    /** 聚合距离(像素),默认 30 */
    distance?: number;
}

export declare interface PointOptions {
    layerName?: string;
    className?: string;
    /** 默认 5 */
    zIndex?: number;
    /** 默认 true */
    visible?: boolean;
    textFieldName?: string;
    /** 图标地址(等价 styles.image.src) */
    icon?: string;
    textColor?: string;
    styles?: {
        image?: ImageConfig;
        text?: TextConfig;
        /** 存在时使用圆形样式(优先级高于 image) */
        circle?: CircleConfig;
    };
    /** 是否设置悬停/提示图层标识属性,默认 true */
    hoverStyle?: boolean;
}

export declare interface PolygonOptions {
    layerName?: string;
    /** 默认 3 */
    zIndex?: number;
    /** 默认 true */
    visible?: boolean;
    textFieldName?: string;
    styles?: StyleOptions;
    /** 默认 true */
    hoverStyle?: boolean;
    /** 默认 true */
    featureColor?: boolean;
}

/**
 * openlayers自定义投影坐标系(EPSG:4542),GeoJSON读取geometry和坐标转换
 * @param geoJson - GeoJSON数据(对象或JSON字符串,字符串解析失败时仅打印错误)
 * @param metaData - 元数据的投影坐标,默认 'EPSG:3857'
 * @param afterData - 规定要素以哪种坐标显示,默认 'EPSG:4326'
 * @returns 转换后的要素数组
 */
export declare function projTransform(geoJson: GeoJSONData, metaData?: string, afterData?: string): default_2<Geometry>[];

export declare interface RainColorRange {
    minvalue: number;
    maxvalue: number;
    color: string;
}

export declare interface RainPolygonOptions {
    layerName?: string;
    /** 默认 3 */
    zIndex?: number;
    /** 默认 true */
    visible?: boolean;
    /** 颜色区间配置(必填):lowValue/highValue 完全落在 [minvalue, maxvalue] 内时取 color */
    renderColor: RainColorRange[];
}

export declare interface RegularShapeConfig {
    points?: number;
    radius?: number;
    radius1?: number;
    radius2?: number;
    angle?: number;
    fill?: FillLike;
    stroke?: StrokeLike;
    scale?: number | [number, number];
    displacement?: number[];
    rotation?: number;
    rotateWithView?: boolean;
}

/**
 * 完全移除指定地图的绘制功能(移除交互、图层和数据)
 * @param map - 地图实例
 */
export declare function removeDraw(map: default_3): void;

/**
 * 完全移除自由手绘功能(移除交互、图层和数据)
 *
 * 残留限制:本函数保持旧版的无参签名,只能清理最近一次调用 freehandDrawing
 * 的地图;若有多张地图启用了自由手绘,其余地图的状态需待其成为"最近使用的地图"
 * 后再调用本函数清理(或随地图销毁由 WeakMap 自动回收)。
 */
export declare function removeFreehandDraw(): void;

/**
 * 通过图层名称(layerName)清除并移除地图中匹配的图层(含嵌套在LayerGroup中的图层)
 *
 * @param map - 地图实例
 * @param name - 要移除的图层名称(layerName属性包含该值)
 */
export declare function removeLayer(map: default_3, name: string): void;

/**
 * 通过图层名称(layerName)设置匹配图层的显示/隐藏状态
 *
 * @param map - 地图实例
 * @param name - 目标图层名称(layerName属性包含该值)
 * @param status - 显示状态(true为显示,false为隐藏)
 */
export declare function setLayerVisible(map: default_3, name: string, status: boolean): void;

export declare interface StrokeConfig {
    color?: StyleColor;
    width?: number;
    lineDash?: number[];
    lineCap?: CanvasLineCap;
    lineJoin?: CanvasLineJoin;
    miterLimit?: number;
}

/** 描边配置:普通对象或 Stroke 实例 */
export declare type StrokeLike = StrokeConfig | default_11;

/** 颜色:CSS 颜色字符串或 [r, g, b, a] 数组 */
export declare type StyleColor = string | number[];

/** getOptionsStyle 的配置对象(plain object,非 ol Style 实例) */
export declare interface StyleOptions {
    fill?: FillLike;
    stroke?: StrokeLike;
    image?: ImageConfig;
    text?: TextConfig;
}

export declare interface TextConfig {
    text?: string;
    font?: string;
    maxAngle?: number;
    offsetX?: number;
    offsetY?: number;
    overflow?: boolean;
    placement?: 'point' | 'line';
    scale?: number | [number, number];
    rotateWithView?: boolean;
    rotation?: number;
    textAlign?: CanvasTextAlign;
    textBaseline?: CanvasTextBaseline;
    padding?: number[];
    fill?: FillLike;
    stroke?: StrokeLike;
    backgroundFill?: FillLike;
    backgroundStroke?: StrokeLike;
}

/** 显示字段:字段名(支持逗号分隔按优先级)/ 字段名数组 / 自定义取文本函数 */
export declare type TextFieldName = string | string[] | ((feature: FeatureProperties) => string);

/**
 * 计算纬度偏移量(用于WGS84与GCJ02转换)
 * @param lng - 经度(已减去105基准值)
 * @param lat - 纬度(已减去35基准值)
 * @returns 纬度偏移量
 */
export declare function transformLat(lng: number, lat: number): number;

/**
 * 计算经度偏移量(用于WGS84与GCJ02转换)
 * @param lng - 经度(已减去105基准值)
 * @param lat - 纬度(已减去35基准值)
 * @returns 经度偏移量
 */
export declare function transformLng(lng: number, lat: number): number;

/**
 * 更新WFS图层的过滤条件(CQL_FILTER)并刷新数据
 *
 * @param olMap - 目标地图实例
 * @param wfsOptions - 配置项
 */
export declare function updateWfsFilter(olMap: default_3, wfsOptions: UpdateWfsFilterOptions): void;

export declare interface UpdateWfsFilterOptions {
    layerName?: string;
    filter?: string[];
}

export declare interface WfsLayerOptions {
    /** 默认 '' */
    layerName?: string;
    /** WFS 服务根地址(内部拼接 `${url}/wfs?...`),默认 '' */
    url?: string;
    /** WFS typename(必填) */
    layers: string;
    /** 图层样式 */
    style: StyleLike;
    /** CQL 条件数组,默认 [] */
    filter?: string[];
    /** 默认 true */
    visible?: boolean;
    /** 默认 5 */
    zIndex?: number;
}

/**
 * WGS84经纬度转火星坐标系(GCJ02)
 * @param lon - WGS84经度
 * @param lat - WGS84纬度
 * @returns GCJ02坐标 [经度, 纬度](国内坐标加密,国外坐标不变)
 */
export declare function wgs84Togcj02(lon: number, lat: number): LonLat;

/**
 * WGS84经纬度转Web墨卡托坐标
 * @param lon - WGS84经度
 * @param lat - WGS84纬度
 * @returns Web墨卡托坐标 [X, Y]
 */
export declare function wgs84ToMercator(lon: number, lat: number): LonLat;

/** WMS 点击查询回调:参数为 GeoJSON Feature 数组(非 ol/Feature) */
export declare type WmsFeatureCallback = (features: GeoJSONFeature[]) => void;

/** WMS 图层(TileWMS / ImageWMS 源) */
export declare type WMSLayer = default_5<default_6 | default_7>;

export declare interface WmsLayerOptions {
    /** 默认 '' */
    layerName?: string;
    /** WMS 服务根地址(内部拼接 `${url}/wms`),默认 '' */
    url?: string;
    /** WMS 服务端图层标识(必填) */
    layers: string;
    /** CQL 条件数组(' and ' 拼接),默认 [] */
    filter?: string[];
    /** 默认 true */
    visible?: boolean;
    /** 默认 5 */
    zIndex?: number;
    /** 额外 WMS 请求参数(可覆盖前面的参数) */
    params?: Record<string, unknown>;
}

/** WMS 或 WMTS 图层 */
export declare type WMSOrWMTSLayer = default_5<default_6 | default_7 | default_9>;

/**
 * 将地图视图适配到指定图层的要素范围(支持按要素名称精准适配)
 *
 * @param olMap - 地图实例
 * @param options - 适配配置项(layerName 必填;name 缺省时适配第一个要素)
 */
export declare function zoomToFitExtent(olMap: default_3, options: ZoomToFitOptions): void;

export declare interface ZoomToFitOptions {
    /** 目标图层名(必填,缺了直接 return) */
    layerName: string;
    /** 精准适配 NAME 属性等于该值的要素,缺省取第一个要素 */
    name?: string;
    /** [上, 右, 下, 左],默认 [50, 50, 50, 50] */
    padding?: number[];
    /** 默认 18 */
    maxZoom?: number;
    /** 默认 800 */
    duration?: number;
}

export { }