tds-map-methods 0.0.0-stage → 0.1.0

package/types/components/map/methods/windShaft.d.ts

@@ -0,0 +1,43 @@
+import ImageCanvasSource from "ol/source/ImageCanvas";
+import type { WindVectorData } from "./windLayer";
+type WindShaftResolvedConfig = {
+    pixelStep: number;
+    fontSize: number;
+    color: string;
+    minWindSpeed: number;
+    speedLevelStep: number;
+    maxLevel: number;
+    spriteCellSize: number;
+    baseFontSize: number;
+    iconYOffsetRatio: number;
+    firstRowMaxLevel: number;
+    firstRowStartX: number;
+    firstRowY: number;
+    secondRowOffsetX: number;
+    secondRowY: number;
+};
+export declare class WindShaft {
+    map: Layer.Map;
+    options: any;
+    contourCache: Map<string, WindVectorData>;
+    iconImagePromise: Promise<HTMLImageElement> | null;
+    externalWindDataProvider?: () => Promise<WindVectorData | null>;
+    constructor(map: Layer.Map, options: any, externalWindDataProvider?: () => Promise<WindVectorData | null>);
+    getClassName(): string;
+    normalizeUrls(url: unknown): string[];
+    getComponentScope(): [number, number];
+    getCacheKey(): string;
+    getRuntimeConfig(): Layer.Config["config"] & Record<string, any>;
+    getVisibleWindSpeedScope(): [number, number];
+    getWindShaftConfig(): WindShaftResolvedConfig;
+    getIconImage(): Promise<HTMLImageElement>;
+    getOrLoadWindData(): Promise<WindVectorData | null>;
+    createWindShaftSource(data: WindVectorData, iconImage: CanvasImageSource): ImageCanvasSource;
+    getSourceFromCache(): Promise<ImageCanvasSource>;
+    getSourceFromParams(): Promise<ImageCanvasSource>;
+    add(): Promise<void>;
+    delete(): void;
+    toggleVisible(visible: boolean): void;
+    updateParams(newOptions: Layer.Config): Promise<void>;
+}
+export {};

package/types/components/map/methods/wmsLayer.d.ts

@@ -0,0 +1,36 @@
+import { TileWMS } from "ol/source";
+type WmsLayerConfig = Record<string, string | number | boolean | string[] | undefined>;
+type WmsColorOptions = {
+    styles?: string;
+    colorScaleRange?: string | [number, number];
+    numColorBands?: string | number;
+    aboveMaxColor?: string;
+    belowMinColor?: string;
+    bgColor?: string;
+    logScale?: boolean | string;
+};
+export declare class WmsLayer {
+    map: Layer.Map;
+    options: Layer.Config;
+    constructor(map: Layer.Map, options: Layer.Config);
+    getClassName(): string;
+    getConfig(): Layer.Config["config"] & {
+        opacity?: number;
+        layerConfig?: WmsLayerConfig;
+    };
+    normalizeParamValue(value: unknown): string | undefined;
+    buildWmsParams(): Record<string, string>;
+    splitUrlAndParams(rawUrl: string): {
+        baseUrl: string;
+        urlParams: Record<string, string>;
+    };
+    getTintColorRGB(): [number, number, number] | null;
+    tintBlobToDataUrl(blob: Blob, tintRGB: [number, number, number]): Promise<string>;
+    createSource(): TileWMS;
+    add(): void;
+    delete(): void;
+    toggleVisible(visible: boolean): void;
+    updateParams(newOptions: Layer.Config): void;
+    updateColor(colorOptions: WmsColorOptions): void;
+}
+export {};

package/types/request/typhoon.d.ts

@@ -0,0 +1,50 @@
+export declare const TYPHOON_SERVICE_BASE_URL: any;
+export declare const TYPHOON_AUTHORIZATION: any;
+export declare const TYPHOON_DATA_PATH: any;
+export interface TyphoonListItem {
+    num_inati: string;
+    num_nati: string;
+    name_en: string;
+    name_cn: string;
+    data_id?: string;
+    init_grade?: string | null;
+    first_seen_file?: string;
+    first_seen_ts?: string;
+    latest_ts?: string;
+    obs_points?: number;
+    fcst_sources?: number;
+}
+export interface TyphoonPoint {
+    datetime: string;
+    file_ts: string;
+    validtime: number;
+    lat: number;
+    lon: number;
+    prs_hpa: number | null;
+    wind_max_ms: number | null;
+    wind_gust_ms: number | null;
+    grade: string | null;
+    move_dir_deg: number | null;
+    move_speed_ms: number | null;
+    radius_7: (number | null)[];
+    radius_10: (number | null)[];
+    radius_12: (number | null)[];
+}
+export interface TyphoonForecast {
+    file_ts?: string;
+    points?: TyphoonPoint[];
+}
+export interface TyphoonDetail {
+    typhoon_num: string;
+    name_cn: string;
+    name_en: string;
+    updated?: string;
+    obs?: Record<string, TyphoonPoint[] | TyphoonForecast>;
+    fcst?: Record<string, TyphoonPoint[] | TyphoonForecast>;
+}
+export interface TyphoonRequestOptions {
+    dataPath?: string;
+    authorization?: string;
+}
+export declare function getTyphoonList(options?: TyphoonRequestOptions): Promise<TyphoonListItem[]>;
+export declare function getTyphoonDetail(typhoonNum: string, options?: TyphoonRequestOptions): Promise<TyphoonDetail>;

package/types/serivce/api/tds.d.ts

@@ -0,0 +1,16 @@
+import type { ResponseType } from "axios";
+export declare function fetchXmlData(url: string, auth?: string): Promise<any>;
+export declare function fetchXMLFromUrl(url: string, auth?: string): Promise<any>;
+export declare function fetchExcel(url: string, auth?: string): Promise<any>;
+export declare function fetchTxtOrJson(url: string, params?: any, auth?: string): Promise<any>;
+export declare function fetchTdsGet(url: string, params?: any, auth?: string, options?: {
+    responseType?: ResponseType;
+}): Promise<any>;
+/**
+ * 通过已有代理请求图片并返回 base64(DataURL)
+ */
+export declare function fetchTdsImageBase64(url: string, params?: any): Promise<string>;
+/**
+ * 统一获取图片 base64
+ */
+export declare function fetchImageBase64(url: string, paramsOrAuth?: any, auth?: string): Promise<string>;

package/types/serivce/request/index.d.ts

@@ -0,0 +1,2 @@
+declare const service: import("axios").AxiosInstance;
+export default service;

package/types/typings/layer.d.ts

@@ -0,0 +1,222 @@
+declare namespace Layer {
+  type Map = import("ol").Map;
+  type Dayjs = import("dayjs").Dayjs;
+
+  /** 图层类型：只显示图例，网格，渐变，等高线，可见性，箭头，micaps，uv风，风杆 */
+  type LegendType =
+    | "legend"
+    | "grid"
+    | "gradual"
+    | "isoline"
+    | "contour"
+    | "visible"
+    | "arrow"
+    | "micaps"
+    | "wms"
+    | "uv"
+    | "windShaft"
+    | "typhoon";
+  /** 图层模式：离散、渐变、网格 */
+  type LayerMode = "discrete" | "gradient" | "grid";
+  type Legend = {
+    name: string;
+    scope?: number[];
+    color: string;
+  }[];
+
+  interface Config {
+    /** 图层id，唯一标识 */
+    readonly id: string;
+    /** 图层标题 */
+    readonly title: string;
+    /** 图层标签 */
+    label: string;
+    /** 图层类型 */
+    type: LegendType | LegendType[];
+    /** 图层数据文件路径 */
+    filePath: string;
+    /** 主数据目录不可用时使用的备用目录 */
+    fallbackFilePath?: string;
+    /** 图层数据url地址 */
+    url?: string;
+    /** 图层是否显示，默认true */
+    show?: boolean;
+    /** 菜单图标名称 */
+    icon?: string;
+    /** 目录接口返回的节点类型 */
+    fileListType?: "file" | "menu";
+    /** 数据单位 */
+    unit?: string;
+    /** 菜单项请求头 Authorization，优先于环境变量 */
+    authorization?: string;
+    /** 备用目录对应的 Authorization */
+    fallbackAuthorization?: string;
+    /** 数据时间 */
+    time?: string | Dayjs;
+    config: {
+      /** 是否缓存图层数据，默认false，---！！该参数准备作废！！--- */
+      cache?: boolean;
+      /** 图片边界取值bbox */
+      extent: [number, number, number, number];
+      /** 图层zIndex，默认0，数值越大越靠上 */
+      zIndex?: number;
+      /** 图层透明度，取值范围 0-1 */
+      opacity?: number;
+      /** 等值线线宽 */
+      lineWidth?: number;
+      /** 等值线线宽，优先于 lineWidth */
+      isolineLineWidth?: number;
+      /** 是否启用等值线平滑，默认 true */
+      isolineSmooth?: boolean;
+      /** 等值线平滑度，0 表示关闭，1-3 表示逐级增强，默认 1 */
+      isolineSmoothness?: number;
+      /** 色斑图是否使用与等值线相同的数值场和平滑边界，默认 false */
+      alignWithIsoline?: boolean;
+      /** 等值线颜色；true 表示跟随图例 */
+      isolineColor?: string | boolean;
+      /** 等值面边界颜色 */
+      isolineBorderColor?: string;
+      /** 是否绘制分级等值面 */
+      isolineFill?: boolean;
+      /** 是否沿等值线显示数值 */
+      showIsolineValue?: boolean;
+      /** showIsolineValue 的兼容配置名 */
+      showIsolineLabel?: boolean;
+      /** MICAPS 是否显示文本 */
+      showText?: boolean;
+      /** MICAPS 是否填色 */
+      showFillcolor?: boolean;
+      /** MICAPS 是否显示等值线 */
+      showIsoline?: boolean;
+      /** MICAPS 是否显示符号点 */
+      showPointMarkers?: boolean;
+      /** 图例色带范围 */
+      legend: Legend;
+      /** 图例色带类型 visible：不显示色带 legend: 显示色块文字 grid：显示网格色带 gradual：显示渐变色带 */
+      legendType: "visible" | "legend" | "grid" | "gradual";
+      /** 图例色带范围（图例下标），只有在legendType为visible时有效，空数组表示不限制范围 */
+      legendScope?: [] | [number, number];
+      /** 数据值域；不设置时，从 TDS 自动获取最大/最小值 */
+      scope?: [number, number];
+      /**
+       * 对栅格值进行二次计算后再参与绘制与查询。
+       * 返回 null/undefined/NaN 时，该像素按无效值处理。
+       * 也支持字符串符号引用，例如 #sym:valueTransform。
+       */
+      valueTransform?:
+        | ((
+            value: number,
+            context: {
+              x: number;
+              y: number;
+              width: number;
+              height: number;
+              source: "raw" | "smooth";
+            },
+          ) => number | null | undefined)
+        | string;
+      /**
+       * valueTransform 结果是否参与范围过滤，默认 true。
+       * false 时仅用于显示值，不改变过滤判定。
+       */
+      valueTransformAffectsScope?: boolean;
+      /** 掩膜边缘平滑开关，默认false */
+      smooth?: boolean;
+      /** Chaikin 平滑迭代次数，默认2，建议1-3，取值范围1-5 */
+      smoothIterations?: number;
+      mode: LayerMode;
+      /** tds图层配置项 */
+      layerConfig?: Record<string, any>;
+      /** grid图层配置项 */
+      gridConfig?: {
+        /** 网格文本像素间距，默认40，单位px */
+        pixelStep: number | string;
+        /** 网格文本字体大小，默认14，单位px */
+        fontSize: number | string;
+        /** 网格文本小数位数，默认1 */
+        decimals: number | string;
+        /** 网格文本颜色，默认#000 */
+        fontColor: string;
+        /** 网格文本描边颜色，默认#fff */
+        strokeColor: string;
+        /** 网格文本描边宽度，默认2，单位px */
+        strokeWidth: number | string;
+        /** 网格文本字体，默认Arial, sans-serif */
+        fontFamily: string;
+        /** 是否开启文本描边，默认true */
+        useDevicePixelRatio: boolean;
+      };
+      /** wind图层配置项 */
+      windConfig?: Record<string, any>;
+      /** windShaft图层配置项 */
+      windShaftConfig?: {
+        /** 风杆采样像素步长，默认20，单位px */
+        pixelStep?: number | string;
+        /** 风杆尺寸，默认18，单位px */
+        fontSize?: number | string;
+        /** 风杆叠加颜色，默认rgb(255,255,255) */
+        color?: string;
+        /** 过滤最小风速，默认0.01 */
+        minWindSpeed?: number | string;
+        /** 风速分级步长，默认2 */
+        speedLevelStep?: number | string;
+        /** 风速级别上限，默认30 */
+        maxLevel?: number | string;
+        /** 雪碧图单格尺寸，默认32 */
+        spriteCellSize?: number | string;
+        /** 图标缩放基准字号，默认32 */
+        baseFontSize?: number | string;
+        /** 图标Y轴偏移比例，默认0.7 */
+        iconYOffsetRatio?: number | string;
+        /** 雪碧图第一行最大等级，默认3 */
+        firstRowMaxLevel?: number | string;
+        /** 雪碧图第一行起始X，默认28 */
+        firstRowStartX?: number | string;
+        /** 雪碧图第一行Y，默认4 */
+        firstRowY?: number | string;
+        /** 雪碧图第二行X偏移，默认4 */
+        secondRowOffsetX?: number | string;
+        /** 雪碧图第二行Y，默认5 */
+        secondRowY?: number | string;
+      };
+      /** 台风路径图层配置 */
+      typhoonConfig?: {
+        /** TDS fileServer 下的台风 JSON 目录 */
+        dataPath?: string;
+        /** 只加载指定台风编号；不传则加载列表内全部台风 */
+        typhoonNums?: string[];
+        /** 优先显示的实况/预报来源 */
+        sourcePriority?: string[];
+        /** 是否显示预报路径 */
+        showForecast?: boolean;
+        /** 加载后是否自动缩放到路径范围 */
+        fitToExtent?: boolean;
+      };
+    };
+  }
+
+  interface TimeInfoResult {
+    /** 单时次or多时次 */
+    type: TimeOrderType;
+    /** 数据经纬度四角范围 */
+    latLonBox: LatLonBox;
+    /** 时间序列数量 */
+    npts?: string;
+    /** 数据时间间隔 */
+    increment?: string;
+    /** 请求连接 */
+    url: string;
+    /** 时间单位（hour | hours | minute） */
+    units: string;
+    /** 时间序列 */
+    timeOrder: TimeOrder[];
+    /** 起始时间 */
+    startTime: Date;
+    /** 结束时间 */
+    endTime: Date;
+    /** 高度层信息 */
+    level?: string[];
+    heightAboveGround?: string;
+    [key: string]: any;
+  }
+}