@jorgmoritz/gis-manager 0.1.43 → 0.1.45

package/dist/index.d.cts

@@ -2595,6 +2595,141 @@ declare function calculateAbsoluteHeight(altitudeMode: 'absolute' | 'relativeToG
  */
 declare function calculateRelativeHeight(altitudeMode: 'absolute' | 'relativeToGround' | 'relativeToStart', absoluteHeight: number, startPointAltitude: number, terrainHeight: number): number;
 
+/**
+ * 几何计算工具函数
+ * 提供两点之间的距离和中点计算
+ */
+
+/**
+ * 计算两点之间的距离和中点
+ * @param CesiumNS Cesium 命名空间
+ * @param point1 第一个点 (Cartesian3)
+ * @param point2 第二个点 (Cartesian3)
+ * @returns { distance: number, midpoint: Cartesian3 }
+ */
+declare function calculateDistanceAndMidpoint(CesiumNS: typeof Cesium, point1: Cesium.Cartesian3, point2: Cesium.Cartesian3): {
+    distance: number;
+    midpoint: Cesium.Cartesian3;
+};
+/**
+ * 计算两点之间的距离
+ * @param CesiumNS Cesium 命名空间
+ * @param point1 第一个点 (Cartesian3)
+ * @param point2 第二个点 (Cartesian3)
+ * @returns 距离（米）
+ */
+declare function calculateDistance(CesiumNS: typeof Cesium, point1: Cesium.Cartesian3, point2: Cesium.Cartesian3): number;
+/**
+ * 计算两点的中点坐标
+ * @param CesiumNS Cesium 命名空间
+ * @param point1 第一个点 (Cartesian3)
+ * @param point2 第二个点 (Cartesian3)
+ * @returns 中点 (Cartesian3)
+ */
+declare function calculateMidpoint(CesiumNS: typeof Cesium, point1: Cesium.Cartesian3, point2: Cesium.Cartesian3): Cesium.Cartesian3;
+/**
+ * 计算从 point1 指向 point2 的航向角（度）
+ * @param CesiumNS Cesium 命名空间
+ * @param point1 起点 (Cartesian3)
+ * @param point2 终点 (Cartesian3)
+ * @returns 航向角（度，范围 [-180, 180]）
+ */
+declare function calculateHeadingBetweenPoints(CesiumNS: typeof Cesium, point1: Cesium.Cartesian3, point2: Cesium.Cartesian3): number;
+
+/**
+ * 实时航点数据
+ */
+interface RealtimeWaypoint {
+    longitude: number;
+    latitude: number;
+    altitude: number;
+    heading?: number;
+    pitch?: number;
+    roll?: number;
+    timestamp?: number;
+}
+/**
+ * 轨迹样式选项
+ */
+interface TrackStyleOptions {
+    /** 轨迹颜色 */
+    color?: Cesium.Color;
+    /** 轨迹线宽 */
+    width?: number;
+    /** 是否贴地 */
+    clampToGround?: boolean;
+    /** 最大轨迹点数（防止内存溢出），默认 1000 */
+    maxPoints?: number;
+}
+/**
+ * 实时飞行追踪器选项
+ */
+interface RealtimeFlightTrackerOptions {
+    /** 是否显示飞过的轨迹，默认 true */
+    showTrack?: boolean;
+    /** 轨迹样式 */
+    trackStyle?: TrackStyleOptions;
+    /** 视锥体角度，默认 50 */
+    fovDeg?: number;
+    /** 自定义图层 */
+    layer?: Cesium.CustomDataSource;
+}
+/**
+ * 实时飞行追踪器
+ *
+ * 用于接收 WebSocket 推送的实时航点数据，更新飞机位置并绘制飞过的轨迹
+ */
+declare class RealtimeFlightTracker {
+    private CesiumNS;
+    private viewer;
+    private options;
+    private airplaneCursor?;
+    private trackEntity?;
+    private trackPositions;
+    private isInitialized;
+    constructor(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, options?: RealtimeFlightTrackerOptions);
+    /**
+     * 更新飞机位置（接收新航点）
+     * @param waypoint 实时航点数据
+     */
+    updatePosition(waypoint: RealtimeWaypoint): void;
+    /**
+     * 初始化飞机和轨迹实体
+     */
+    private initialize;
+    /**
+     * 创建轨迹实体
+     */
+    private createTrackEntity;
+    /**
+     * 添加轨迹点
+     */
+    private addTrackPoint;
+    /**
+     * 清除轨迹
+     */
+    clearTrack(): void;
+    /**
+     * 获取当前轨迹点数
+     */
+    getTrackPointCount(): number;
+    /**
+     * 设置轨迹可见性
+     */
+    setTrackVisible(visible: boolean): void;
+    /**
+     * 飞到当前飞机位置
+     */
+    flyToAirplane(options?: {
+        height?: number;
+        duration?: number;
+    }): void;
+    /**
+     * 销毁并清理资源
+     */
+    destroy(): void;
+}
+
 /**
  * Path 编辑保存结果数据接口
  * 对应 pathEditing.ts 中 saveAndStop() 返回的数据结构
@@ -2617,6 +2752,8 @@ interface PathEditingSaveResult {
         relativeHeight?: number;
         /** 🆕 是否使用全局默认高度（true: 高度=defaultAltitude, false: 高度=实际计算值） */
         useGlobalHeight?: boolean;
+        /** 🆕 航点ID（原有航点保留ID，新插入航点为 undefined） */
+        waypointId?: string | number;
     }>;
     altitudeMode?: string;
     /** 航线默认高度（米） */
@@ -2821,4 +2958,4 @@ declare const placeholder: {
 };
 declare const droneModelUrl: string;
 
-export { type AltitudeMode, CZMLManager, type CameraDestinationInput, CameraEventBus, type CameraFOVChangeEvent, CameraFOVController, type CameraFlyOptions, type CameraInitOptions, CameraManager, type CameraOrientation, type CameraPoseChangeEvent, type CameraSetViewOptions, type CameraView, type CaptureWithViewOptions, type CesiumAssetsOptions, type ConvertedWaylineData, type ConvertedWaypointData, type CursorPoseChangeEvent, type CzmlExportOptions, type CzmlImportOptions, type EditingChange, Emitter, type FOVChangeEvent, type FOVControllerOptions, type FlightPathPreviewController, FlightSimulator, type FlightSimulatorController, type FlightSimulatorOptions, type FlightSimulatorState, type FlightSimulatorStateChangeEvent, type FlyToBoundsOptions, type FlyToOptions, FrustumPyramid, type FrustumPyramidOptions, type FrustumShapeChangeEvent, type GeoBounds, type GeoPoint, type ImageryOptions, type ImageryProviderKind, type InitOptions, type LayerEvents, type LayerHandle, LayerManager, type LayerType, type Listener, type LoadMapLayersResult, type LoadSliceJsonOptions, type LoadSliceJsonResult, type LonLatHeight, type MapLayerConfig, type Orientation, type PathEditingSaveResult, type PathOptions, type PathSafetyCheckOptions, type PathSafetyCheckResult, PathSafetyChecker, type PathToSinoflyOptions, type PhotoBillboardItem, type PhotoBillboardLayerOptions, type PhotoBillboardResult, type PointCloudPickResult, type PointCloudPickSession, PointCloudPicker, type PointCloudPickerOptions, type PolygonDrawingOptions, type PolygonEditingSession, PolygonEditor, type PreviousViewChange, type QuickEditOptions, type RenderFlightPathOptions, type RenderFlightPathPreviewOptions, SceneManager, type SceneOptions, type ScreenshotOptions, type ScreenshotResult, type SegmentSafetyResult, type SelectionChange, type SelectionResult, type SelectionSession, Selector, type ShapeLineProps, type ShapePointProps, type ShapePolygonProps, type SinoflyAdapterOptions, type SinoflyWaylineData, type SinoflyWaypointInfo, type SliceJsonData, StateManager, type TerrainKind, type TerrainOptions, type Toggle2D3DContext, type Toggle2D3DOptions, type VersionInfo, assertCesiumAssetsConfigured, calculateAbsoluteHeight, calculateBoundsDiagonal, calculateGeoBounds, calculateRelativeHeight, configureCesiumAssets, configureCesiumIonToken, convertPathToSinofly, convertSinoflyWayline, convertSinoflyWaylines, droneModelUrl, ensureCesiumIonToken, expandBounds, getCesiumBaseUrl, getCesiumIonToken, globalCameraEventBus, globalState, isPointInBounds, mergeBounds, placeholder, queryTerrainHeightAsync, queryTerrainHeightByLonLat, queryTerrainHeightByLonLatSync, queryTerrainHeightSync, queryTerrainHeights, queryTerrainHeightsByLonLat, renderFlightPath, renderFlightPathPreview, toggle2D3D, version, versionInfo };
+export { type AltitudeMode, CZMLManager, type CameraDestinationInput, CameraEventBus, type CameraFOVChangeEvent, CameraFOVController, type CameraFlyOptions, type CameraInitOptions, CameraManager, type CameraOrientation, type CameraPoseChangeEvent, type CameraSetViewOptions, type CameraView, type CaptureWithViewOptions, type CesiumAssetsOptions, type ConvertedWaylineData, type ConvertedWaypointData, type CursorPoseChangeEvent, type CzmlExportOptions, type CzmlImportOptions, type EditingChange, Emitter, type FOVChangeEvent, type FOVControllerOptions, type FlightPathPreviewController, FlightSimulator, type FlightSimulatorController, type FlightSimulatorOptions, type FlightSimulatorState, type FlightSimulatorStateChangeEvent, type FlyToBoundsOptions, type FlyToOptions, FrustumPyramid, type FrustumPyramidOptions, type FrustumShapeChangeEvent, type GeoBounds, type GeoPoint, type ImageryOptions, type ImageryProviderKind, type InitOptions, type LayerEvents, type LayerHandle, LayerManager, type LayerType, type Listener, type LoadMapLayersResult, type LoadSliceJsonOptions, type LoadSliceJsonResult, type LonLatHeight, type MapLayerConfig, type Orientation, type PathEditingSaveResult, type PathOptions, type PathSafetyCheckOptions, type PathSafetyCheckResult, PathSafetyChecker, type PathToSinoflyOptions, type PhotoBillboardItem, type PhotoBillboardLayerOptions, type PhotoBillboardResult, type PointCloudPickResult, type PointCloudPickSession, PointCloudPicker, type PointCloudPickerOptions, type PolygonDrawingOptions, type PolygonEditingSession, PolygonEditor, type PreviousViewChange, type QuickEditOptions, RealtimeFlightTracker, type RealtimeFlightTrackerOptions, type RealtimeWaypoint, type RenderFlightPathOptions, type RenderFlightPathPreviewOptions, SceneManager, type SceneOptions, type ScreenshotOptions, type ScreenshotResult, type SegmentSafetyResult, type SelectionChange, type SelectionResult, type SelectionSession, Selector, type ShapeLineProps, type ShapePointProps, type ShapePolygonProps, type SinoflyAdapterOptions, type SinoflyWaylineData, type SinoflyWaypointInfo, type SliceJsonData, StateManager, type TerrainKind, type TerrainOptions, type Toggle2D3DContext, type Toggle2D3DOptions, type TrackStyleOptions, type VersionInfo, assertCesiumAssetsConfigured, calculateAbsoluteHeight, calculateBoundsDiagonal, calculateDistance, calculateDistanceAndMidpoint, calculateGeoBounds, calculateHeadingBetweenPoints, calculateMidpoint, calculateRelativeHeight, configureCesiumAssets, configureCesiumIonToken, convertPathToSinofly, convertSinoflyWayline, convertSinoflyWaylines, droneModelUrl, ensureCesiumIonToken, expandBounds, getCesiumBaseUrl, getCesiumIonToken, globalCameraEventBus, globalState, isPointInBounds, mergeBounds, placeholder, queryTerrainHeightAsync, queryTerrainHeightByLonLat, queryTerrainHeightByLonLatSync, queryTerrainHeightSync, queryTerrainHeights, queryTerrainHeightsByLonLat, renderFlightPath, renderFlightPathPreview, toggle2D3D, version, versionInfo };

package/dist/index.d.ts

@@ -2595,6 +2595,141 @@ declare function calculateAbsoluteHeight(altitudeMode: 'absolute' | 'relativeToG
  */
 declare function calculateRelativeHeight(altitudeMode: 'absolute' | 'relativeToGround' | 'relativeToStart', absoluteHeight: number, startPointAltitude: number, terrainHeight: number): number;
 
+/**
+ * 几何计算工具函数
+ * 提供两点之间的距离和中点计算
+ */
+
+/**
+ * 计算两点之间的距离和中点
+ * @param CesiumNS Cesium 命名空间
+ * @param point1 第一个点 (Cartesian3)
+ * @param point2 第二个点 (Cartesian3)
+ * @returns { distance: number, midpoint: Cartesian3 }
+ */
+declare function calculateDistanceAndMidpoint(CesiumNS: typeof Cesium, point1: Cesium.Cartesian3, point2: Cesium.Cartesian3): {
+    distance: number;
+    midpoint: Cesium.Cartesian3;
+};
+/**
+ * 计算两点之间的距离
+ * @param CesiumNS Cesium 命名空间
+ * @param point1 第一个点 (Cartesian3)
+ * @param point2 第二个点 (Cartesian3)
+ * @returns 距离（米）
+ */
+declare function calculateDistance(CesiumNS: typeof Cesium, point1: Cesium.Cartesian3, point2: Cesium.Cartesian3): number;
+/**
+ * 计算两点的中点坐标
+ * @param CesiumNS Cesium 命名空间
+ * @param point1 第一个点 (Cartesian3)
+ * @param point2 第二个点 (Cartesian3)
+ * @returns 中点 (Cartesian3)
+ */
+declare function calculateMidpoint(CesiumNS: typeof Cesium, point1: Cesium.Cartesian3, point2: Cesium.Cartesian3): Cesium.Cartesian3;
+/**
+ * 计算从 point1 指向 point2 的航向角（度）
+ * @param CesiumNS Cesium 命名空间
+ * @param point1 起点 (Cartesian3)
+ * @param point2 终点 (Cartesian3)
+ * @returns 航向角（度，范围 [-180, 180]）
+ */
+declare function calculateHeadingBetweenPoints(CesiumNS: typeof Cesium, point1: Cesium.Cartesian3, point2: Cesium.Cartesian3): number;
+
+/**
+ * 实时航点数据
+ */
+interface RealtimeWaypoint {
+    longitude: number;
+    latitude: number;
+    altitude: number;
+    heading?: number;
+    pitch?: number;
+    roll?: number;
+    timestamp?: number;
+}
+/**
+ * 轨迹样式选项
+ */
+interface TrackStyleOptions {
+    /** 轨迹颜色 */
+    color?: Cesium.Color;
+    /** 轨迹线宽 */
+    width?: number;
+    /** 是否贴地 */
+    clampToGround?: boolean;
+    /** 最大轨迹点数（防止内存溢出），默认 1000 */
+    maxPoints?: number;
+}
+/**
+ * 实时飞行追踪器选项
+ */
+interface RealtimeFlightTrackerOptions {
+    /** 是否显示飞过的轨迹，默认 true */
+    showTrack?: boolean;
+    /** 轨迹样式 */
+    trackStyle?: TrackStyleOptions;
+    /** 视锥体角度，默认 50 */
+    fovDeg?: number;
+    /** 自定义图层 */
+    layer?: Cesium.CustomDataSource;
+}
+/**
+ * 实时飞行追踪器
+ *
+ * 用于接收 WebSocket 推送的实时航点数据，更新飞机位置并绘制飞过的轨迹
+ */
+declare class RealtimeFlightTracker {
+    private CesiumNS;
+    private viewer;
+    private options;
+    private airplaneCursor?;
+    private trackEntity?;
+    private trackPositions;
+    private isInitialized;
+    constructor(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, options?: RealtimeFlightTrackerOptions);
+    /**
+     * 更新飞机位置（接收新航点）
+     * @param waypoint 实时航点数据
+     */
+    updatePosition(waypoint: RealtimeWaypoint): void;
+    /**
+     * 初始化飞机和轨迹实体
+     */
+    private initialize;
+    /**
+     * 创建轨迹实体
+     */
+    private createTrackEntity;
+    /**
+     * 添加轨迹点
+     */
+    private addTrackPoint;
+    /**
+     * 清除轨迹
+     */
+    clearTrack(): void;
+    /**
+     * 获取当前轨迹点数
+     */
+    getTrackPointCount(): number;
+    /**
+     * 设置轨迹可见性
+     */
+    setTrackVisible(visible: boolean): void;
+    /**
+     * 飞到当前飞机位置
+     */
+    flyToAirplane(options?: {
+        height?: number;
+        duration?: number;
+    }): void;
+    /**
+     * 销毁并清理资源
+     */
+    destroy(): void;
+}
+
 /**
  * Path 编辑保存结果数据接口
  * 对应 pathEditing.ts 中 saveAndStop() 返回的数据结构
@@ -2617,6 +2752,8 @@ interface PathEditingSaveResult {
         relativeHeight?: number;
         /** 🆕 是否使用全局默认高度（true: 高度=defaultAltitude, false: 高度=实际计算值） */
         useGlobalHeight?: boolean;
+        /** 🆕 航点ID（原有航点保留ID，新插入航点为 undefined） */
+        waypointId?: string | number;
     }>;
     altitudeMode?: string;
     /** 航线默认高度（米） */
@@ -2821,4 +2958,4 @@ declare const placeholder: {
 };
 declare const droneModelUrl: string;
 
-export { type AltitudeMode, CZMLManager, type CameraDestinationInput, CameraEventBus, type CameraFOVChangeEvent, CameraFOVController, type CameraFlyOptions, type CameraInitOptions, CameraManager, type CameraOrientation, type CameraPoseChangeEvent, type CameraSetViewOptions, type CameraView, type CaptureWithViewOptions, type CesiumAssetsOptions, type ConvertedWaylineData, type ConvertedWaypointData, type CursorPoseChangeEvent, type CzmlExportOptions, type CzmlImportOptions, type EditingChange, Emitter, type FOVChangeEvent, type FOVControllerOptions, type FlightPathPreviewController, FlightSimulator, type FlightSimulatorController, type FlightSimulatorOptions, type FlightSimulatorState, type FlightSimulatorStateChangeEvent, type FlyToBoundsOptions, type FlyToOptions, FrustumPyramid, type FrustumPyramidOptions, type FrustumShapeChangeEvent, type GeoBounds, type GeoPoint, type ImageryOptions, type ImageryProviderKind, type InitOptions, type LayerEvents, type LayerHandle, LayerManager, type LayerType, type Listener, type LoadMapLayersResult, type LoadSliceJsonOptions, type LoadSliceJsonResult, type LonLatHeight, type MapLayerConfig, type Orientation, type PathEditingSaveResult, type PathOptions, type PathSafetyCheckOptions, type PathSafetyCheckResult, PathSafetyChecker, type PathToSinoflyOptions, type PhotoBillboardItem, type PhotoBillboardLayerOptions, type PhotoBillboardResult, type PointCloudPickResult, type PointCloudPickSession, PointCloudPicker, type PointCloudPickerOptions, type PolygonDrawingOptions, type PolygonEditingSession, PolygonEditor, type PreviousViewChange, type QuickEditOptions, type RenderFlightPathOptions, type RenderFlightPathPreviewOptions, SceneManager, type SceneOptions, type ScreenshotOptions, type ScreenshotResult, type SegmentSafetyResult, type SelectionChange, type SelectionResult, type SelectionSession, Selector, type ShapeLineProps, type ShapePointProps, type ShapePolygonProps, type SinoflyAdapterOptions, type SinoflyWaylineData, type SinoflyWaypointInfo, type SliceJsonData, StateManager, type TerrainKind, type TerrainOptions, type Toggle2D3DContext, type Toggle2D3DOptions, type VersionInfo, assertCesiumAssetsConfigured, calculateAbsoluteHeight, calculateBoundsDiagonal, calculateGeoBounds, calculateRelativeHeight, configureCesiumAssets, configureCesiumIonToken, convertPathToSinofly, convertSinoflyWayline, convertSinoflyWaylines, droneModelUrl, ensureCesiumIonToken, expandBounds, getCesiumBaseUrl, getCesiumIonToken, globalCameraEventBus, globalState, isPointInBounds, mergeBounds, placeholder, queryTerrainHeightAsync, queryTerrainHeightByLonLat, queryTerrainHeightByLonLatSync, queryTerrainHeightSync, queryTerrainHeights, queryTerrainHeightsByLonLat, renderFlightPath, renderFlightPathPreview, toggle2D3D, version, versionInfo };
+export { type AltitudeMode, CZMLManager, type CameraDestinationInput, CameraEventBus, type CameraFOVChangeEvent, CameraFOVController, type CameraFlyOptions, type CameraInitOptions, CameraManager, type CameraOrientation, type CameraPoseChangeEvent, type CameraSetViewOptions, type CameraView, type CaptureWithViewOptions, type CesiumAssetsOptions, type ConvertedWaylineData, type ConvertedWaypointData, type CursorPoseChangeEvent, type CzmlExportOptions, type CzmlImportOptions, type EditingChange, Emitter, type FOVChangeEvent, type FOVControllerOptions, type FlightPathPreviewController, FlightSimulator, type FlightSimulatorController, type FlightSimulatorOptions, type FlightSimulatorState, type FlightSimulatorStateChangeEvent, type FlyToBoundsOptions, type FlyToOptions, FrustumPyramid, type FrustumPyramidOptions, type FrustumShapeChangeEvent, type GeoBounds, type GeoPoint, type ImageryOptions, type ImageryProviderKind, type InitOptions, type LayerEvents, type LayerHandle, LayerManager, type LayerType, type Listener, type LoadMapLayersResult, type LoadSliceJsonOptions, type LoadSliceJsonResult, type LonLatHeight, type MapLayerConfig, type Orientation, type PathEditingSaveResult, type PathOptions, type PathSafetyCheckOptions, type PathSafetyCheckResult, PathSafetyChecker, type PathToSinoflyOptions, type PhotoBillboardItem, type PhotoBillboardLayerOptions, type PhotoBillboardResult, type PointCloudPickResult, type PointCloudPickSession, PointCloudPicker, type PointCloudPickerOptions, type PolygonDrawingOptions, type PolygonEditingSession, PolygonEditor, type PreviousViewChange, type QuickEditOptions, RealtimeFlightTracker, type RealtimeFlightTrackerOptions, type RealtimeWaypoint, type RenderFlightPathOptions, type RenderFlightPathPreviewOptions, SceneManager, type SceneOptions, type ScreenshotOptions, type ScreenshotResult, type SegmentSafetyResult, type SelectionChange, type SelectionResult, type SelectionSession, Selector, type ShapeLineProps, type ShapePointProps, type ShapePolygonProps, type SinoflyAdapterOptions, type SinoflyWaylineData, type SinoflyWaypointInfo, type SliceJsonData, StateManager, type TerrainKind, type TerrainOptions, type Toggle2D3DContext, type Toggle2D3DOptions, type TrackStyleOptions, type VersionInfo, assertCesiumAssetsConfigured, calculateAbsoluteHeight, calculateBoundsDiagonal, calculateDistance, calculateDistanceAndMidpoint, calculateGeoBounds, calculateHeadingBetweenPoints, calculateMidpoint, calculateRelativeHeight, configureCesiumAssets, configureCesiumIonToken, convertPathToSinofly, convertSinoflyWayline, convertSinoflyWaylines, droneModelUrl, ensureCesiumIonToken, expandBounds, getCesiumBaseUrl, getCesiumIonToken, globalCameraEventBus, globalState, isPointInBounds, mergeBounds, placeholder, queryTerrainHeightAsync, queryTerrainHeightByLonLat, queryTerrainHeightByLonLatSync, queryTerrainHeightSync, queryTerrainHeights, queryTerrainHeightsByLonLat, renderFlightPath, renderFlightPathPreview, toggle2D3D, version, versionInfo };