@xingm/vmap-cesium-toolbar 0.0.1-beta.8 → 0.0.1-beta.9

package/dist/libs/CesiumMapHelper.d.ts

@@ -19,6 +19,9 @@ declare class DrawHelper {
     private finishedPointEntities;
     private publicEntities;
     private _doubleClickPending;
+    private currentLineEntity;
+    private currentSegmentLabels;
+    private currentTotalLabel;
     private screenSpaceEventHandler;
     private onDrawStartCallback;
     private onDrawEndCallback;
@@ -129,6 +132,13 @@ declare class DrawHelper {
     private calculateRectangleArea;
     private calculatePolygonArea;
     private calculatePolygonCenter;
+    /**
+     * 格式化距离显示
+     * 超过1000m时转换为km，保留两位小数
+     * @param distance 距离（米）
+     * @returns 格式化后的距离字符串
+     */
+    private formatDistance;
     /**
      * 设置开始绘制时的回调函数
      * @param callback 回调函数
@@ -172,6 +182,11 @@ declare class DrawHelper {
         name?: string;
         groundHeight?: number;
     }): Cesium.Entity;
+    /**
+     * 更新所有已完成实体以适应场景模式变化
+     * 当从2D切换到3D或从3D切换到2D时，需要更新实体的高度参考和位置
+     */
+    private updateFinishedEntitiesForModeChange;
     /**
      * 销毁工具，清理所有事件监听器
      */

package/dist/libs/CesiumMapLoader.d.ts

@@ -19,6 +19,7 @@ interface InitOptions {
     sceneModePicker?: boolean;
     timeline?: boolean;
     animation?: boolean;
+    isFly?: boolean;
     baseLayerPicker?: boolean;
     navigationInstructionsInitiallyVisible?: boolean;
     clock?: Cesium.Clock;

package/dist/libs/CesiumMapModel.d.ts

@@ -43,6 +43,7 @@ export interface CustomButtonConfig {
     activeColor?: string;
     backgroundColor?: string;
     activeIcon?: string | HTMLElement | false;
+    callback?: () => void;
     onClick?: (buttonId: string, buttonElement: HTMLElement) => void;
 }
 export interface SearchCallback {

package/dist/libs/CesiumMapToolbar.d.ts

@@ -18,6 +18,8 @@ export declare class CesiumMapToolbar {
     private currentMapType;
     TD_Token: string;
     mapTypes: MapType[];
+    private noFlyZoneEntities;
+    private isNoFlyZoneVisible;
     constructor(viewer: Viewer, container: HTMLElement, config?: ToolbarConfig, callbacks?: {
         search?: SearchCallback;
         measurement?: MeasurementCallback;
@@ -69,6 +71,13 @@ export declare class CesiumMapToolbar {
      * 设置绘图助手回调
      */
     private setupDrawHelperCallbacks;
+    /**
+     * 格式化距离显示
+     * 超过1000m时转换为km，保留两位小数
+     * @param distance 距离（米）
+     * @returns 格式化后的距离字符串
+     */
+    private formatDistance;
     /**
      * 计算多边形面积
      */
@@ -109,6 +118,10 @@ export declare class CesiumMapToolbar {
      * 按钮鼠标离开时关闭菜单
      */
     private closeMenuOnButtonLeave;
+    /**
+     * 关闭搜索框
+     */
+    private closeSearchContainer;
     /**
      * 处理按钮点击
      */
@@ -153,6 +166,16 @@ export declare class CesiumMapToolbar {
      * 复位到初始位置
      */
     private resetLocation;
+    /**
+     * 获取当前地图层级
+     * @returns 当前层级（1-18）
+     */
+    private getCurrentZoomLevel;
+    /**
+     * 设置地图层级
+     * @param zoomLevel 目标层级（1-18）
+     */
+    private setZoomLevel;
     /**
      * 放大
      */
@@ -173,6 +196,27 @@ export declare class CesiumMapToolbar {
      * 退出全屏
      */
     private exitFullscreen;
+    /**
+     * 加载并显示机场禁飞区
+     */
+    showNoFlyZones(): Promise<void>;
+    /**
+     * 隐藏机场禁飞区
+     */
+    hideNoFlyZones(): void;
+    /**
+     * 切换机场禁飞区显示状态
+     */
+    toggleNoFlyZones(): Promise<void>;
+    /**
+     * 获取禁飞区显示状态
+     */
+    getNoFlyZoneVisible(): boolean;
+    /**
+     * 自动加载禁飞区（如果默认勾选）
+     * 在创建 toolbar 后自动调用
+     */
+    private autoLoadNoFlyZones;
     /**
      * 销毁工具栏
      */

package/dist/package.json

@@ -10,7 +10,8 @@
     "index.js",
     "index.d.ts",
     "style.css",
-    "README.md"
+    "README.md",
+    "geojson"
   ],
   "exports": {
     ".": {

package/dist/utils/common.d.ts

@@ -1 +1,13 @@
 export declare function getViteTdToken(): any;
+/**
+ * 将相机高度转换为地图层级
+ * @param height 相机高度（米）
+ * @returns 地图层级（1-18）
+ */
+export declare function heightToZoomLevel(height: number): number;
+/**
+ * 将地图层级转换为相机高度
+ * @param zoomLevel 地图层级（1-18）
+ * @returns 相机高度（米）
+ */
+export declare function zoomLevelToHeight(zoomLevel: number): number;

package/dist/utils/geojson.d.ts

@@ -0,0 +1,86 @@
+/**
+ * GeoJSON 类型定义
+ */
+export interface GeoJSONPoint {
+    type: 'Point';
+    coordinates: [number, number];
+}
+export interface GeoJSONPolygon {
+    type: 'Polygon';
+    coordinates: number[][][];
+}
+export interface GeoJSONFeature<T = GeoJSONPolygon> {
+    type: 'Feature';
+    geometry: T;
+    properties?: Record<string, any>;
+}
+export interface GeoJSONFeatureCollection<T = GeoJSONPolygon> {
+    type: 'FeatureCollection';
+    features: GeoJSONFeature<T>[];
+    name?: string;
+}
+/**
+ * 机场禁飞区数据接口
+ */
+export interface AirportNoFlyZone {
+    name: string;
+    feature: GeoJSONFeature<GeoJSONPolygon>;
+    fileName: string;
+}
+/**
+ * GeoJSON 加载配置
+ */
+export interface GeoJSONLoaderConfig {
+    /**
+     * GeoJSON 文件的基础路径
+     * 开发环境: '/geojson' (指向 public/geojson)
+     * 生产环境: 可以是 '/geojson' 或用户自定义路径
+     * @default '/geojson'
+     */
+    basePath?: string;
+    /**
+     * 是否在加载失败时静默处理（不抛出错误）
+     * @default false
+     */
+    silent?: boolean;
+}
+/**
+ * 读取所有机场禁飞区 GeoJSON 文件
+ *
+ * 注意：由于无法直接获取目录文件列表，需要提供文件列表
+ * 可以通过以下方式之一：
+ * 1. 提供 fileList 参数
+ * 2. 在 public/geojson 目录下放置 file-list.json 文件
+ * 3. 使用 getAllAirportNoFlyZonesWithList 方法
+ *
+ * @param fileList 可选的文件名列表（不含扩展名）
+ * @param config 加载配置
+ * @returns Promise<AirportNoFlyZone[]> 机场禁飞区数据数组
+ */
+export declare function loadAllAirportNoFlyZones(fileList?: string[], config?: GeoJSONLoaderConfig): Promise<AirportNoFlyZone[]>;
+/**
+ * 读取单个机场禁飞区 GeoJSON 文件
+ * @param fileName 文件名（不含扩展名，如 '珠海_金湾机场'）
+ * @param config 加载配置
+ * @returns Promise<AirportNoFlyZone | null> 机场禁飞区数据或 null
+ */
+export declare function loadAirportNoFlyZone(fileName: string, config?: GeoJSONLoaderConfig): Promise<AirportNoFlyZone | null>;
+/**
+ * 将 GeoJSON 坐标转换为 Cesium Cartesian3 数组
+ * @param coordinates GeoJSON 多边形坐标数组
+ * @param height 高度偏移（米），默认为 0
+ * @returns 包含 longitude, latitude, height 的对象数组
+ */
+export declare function geojsonCoordinatesToCartesian3(coordinates: number[][], height?: number): Array<{
+    longitude: number;
+    latitude: number;
+    height: number;
+}>;
+/**
+ * 从文件名列表生成 file-list.json
+ * 这个函数可以在构建时使用，生成文件列表
+ *
+ * @param fileNames 文件名列表（不含扩展名）
+ * @returns JSON 字符串
+ */
+export declare function generateFileListJson(fileNames: string[]): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.1-beta.8",
+  "version": "0.0.1-beta.9",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
   "main": "dist/index.js",
@@ -25,6 +25,7 @@
     "build": "vite build && vite build --mode lib",
     "build:lib": "vite build --mode lib",
     "build:plugin": "node scripts/build-plugin.js",
+    "generate:file-list": "node scripts/generate-file-list.js",
     "preview": "vite preview",
     "type-check": "vue-tsc --noEmit"
   },