@jorgmoritz/gis-manager 0.1.41 → 0.1.43

package/dist/index.d.cts

@@ -209,6 +209,81 @@ interface PhotoBillboardResult {
     added: number;
     total: number;
 }
+/**
+ * 地图图层配置（从字典加载）
+ */
+interface MapLayerConfig {
+    /** 正射影像 URL */
+    imgUrl?: string;
+    /** 中文注记 URL */
+    ciaUrl?: string;
+    /** 地形数据 URL */
+    terrUrl?: string;
+}
+/**
+ * 从字典加载地图图层的结果
+ */
+interface LoadMapLayersResult {
+    /** 正射影像图层 */
+    imageryLayer?: Cesium.ImageryLayer;
+    /** 中文注记图层 */
+    annotationLayer?: Cesium.ImageryLayer;
+    /** 地形 Provider */
+    terrainProvider?: Cesium.TerrainProvider;
+    /** 加载状态 */
+    success: boolean;
+    /** 错误信息 */
+    errors: string[];
+}
+/**
+ * SliceJson 数据格式（TIF 切片配置）
+ */
+interface SliceJsonData {
+    /** 数据类型：dom（正射影像）或 terrain（地形） */
+    type: 'dom' | 'terrain';
+    /** 切片服务根 URL */
+    urlroot: string;
+    /** 范围 [west, south, east, north] */
+    bounds?: [number, number, number, number];
+    /** 中心点 [lon, lat, height?] */
+    center?: [number, number, number?];
+    /** 最小缩放级别 */
+    minZoom?: number;
+    /** 最大缩放级别 */
+    maxZoom?: number;
+}
+/**
+ * 加载 SliceJson 的选项
+ */
+interface LoadSliceJsonOptions {
+    /** 图层 ID（用于后续管理） */
+    layerId?: string;
+    /** 是否飞行到目标位置，默认 true */
+    flyTo?: boolean;
+    /** 飞行时长（秒），默认 2 */
+    flyDuration?: number;
+    /** 影像透明度，默认 1 */
+    opacity?: number;
+}
+/**
+ * 加载 SliceJson 的结果
+ */
+interface LoadSliceJsonResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 数据类型 */
+    type: 'dom' | 'terrain';
+    /** 图层句柄（仅 DOM 类型） */
+    handle?: LayerHandle;
+    /** 影像图层（仅 DOM 类型） */
+    imageryLayer?: Cesium.ImageryLayer;
+    /** 地形 Provider（仅 terrain 类型） */
+    terrainProvider?: Cesium.TerrainProvider;
+    /** 原始数据 */
+    data: SliceJsonData;
+    /** 错误信息 */
+    error?: string;
+}
 declare class LayerManager {
     private CesiumNS;
     private viewer;
@@ -234,6 +309,45 @@ declare class LayerManager {
     private createTerrain;
     getImageryLayer(id: string): Cesium.ImageryLayer | undefined;
     getTileset(id: string): Cesium.Cesium3DTileset | undefined;
+    /**
+     * 从配置加载地图图层（正射影像、中文注记、地形）
+     * @param config 地图图层配置
+     * @param options 可选配置
+     * @returns 加载结果
+     */
+    loadMapLayersFromConfig(config: MapLayerConfig, options?: {
+        /** 天地图 Token（用于 WMTS 格式时的默认值） */
+        tiandituToken?: string;
+        /** 子域名列表 */
+        subdomains?: string[];
+        /** 最大缩放级别 */
+        maximumLevel?: number;
+    }): Promise<LoadMapLayersResult>;
+    /**
+     * 根据 URL 格式自动创建合适的 ImageryProvider
+     * @param url 影像 URL
+     * @param options 配置选项
+     */
+    private createImageryProviderFromUrl;
+    /**
+     * 从 SliceJson 配置加载 TIF 切片数据（DOM 正射影像或 Terrain 地形）
+     * @param sliceJsonData JSON 字符串或已解析的对象
+     * @param options 加载选项
+     * @returns 加载结果
+     */
+    loadFromSliceJson(sliceJsonData: string | SliceJsonData, options?: LoadSliceJsonOptions): Promise<LoadSliceJsonResult>;
+    /**
+     * 加载 DOM 正射影像
+     */
+    private loadDomFromSliceJson;
+    /**
+     * 加载 Terrain 地形数据
+     */
+    private loadTerrainFromSliceJson;
+    /**
+     * 飞行到 SliceJson 数据的目标位置
+     */
+    private flyToSliceJsonTarget;
 }
 
 type Toggle2D3DOptions = {
@@ -261,6 +375,94 @@ interface Toggle2D3DContext {
  */
 declare function toggle2D3D(ctx: Toggle2D3DContext, options?: Toggle2D3DOptions): void;
 
+/**
+ * 地理边界计算工具
+ * 提供航点/坐标集合的边界框计算功能
+ */
+/**
+ * 地理坐标点
+ */
+interface GeoPoint {
+    /** 经度（度） */
+    lon: number;
+    /** 纬度（度） */
+    lat: number;
+    /** 高度（米，可选） */
+    alt?: number;
+}
+/**
+ * 地理边界框
+ */
+interface GeoBounds {
+    /** 西边界（最小经度） */
+    west: number;
+    /** 东边界（最大经度） */
+    east: number;
+    /** 南边界（最小纬度） */
+    south: number;
+    /** 北边界（最大纬度） */
+    north: number;
+    /** 中心经度 */
+    centerLon: number;
+    /** 中心纬度 */
+    centerLat: number;
+    /** 经度跨度（度） */
+    width: number;
+    /** 纬度跨度（度） */
+    height: number;
+    /** 最小高度（如果有高度数据） */
+    minAlt?: number;
+    /** 最大高度（如果有高度数据） */
+    maxAlt?: number;
+}
+/**
+ * 计算坐标点集合的地理边界框
+ * @param points 坐标点数组
+ * @returns 边界框，如果输入为空则返回 null
+ *
+ * @example
+ * ```typescript
+ * const waypoints = [
+ *   { lon: 104.0, lat: 30.5 },
+ *   { lon: 104.1, lat: 30.6 },
+ *   { lon: 104.05, lat: 30.55 },
+ * ];
+ * const bounds = calculateGeoBounds(waypoints);
+ * // bounds = { west: 104.0, east: 104.1, south: 30.5, north: 30.6, ... }
+ * ```
+ */
+declare function calculateGeoBounds(points: Array<GeoPoint | {
+    lon: number;
+    lat: number;
+    alt?: number;
+}>): GeoBounds | null;
+/**
+ * 计算边界框的对角线距离（米）
+ * @param bounds 边界框
+ * @returns 对角线距离（米）
+ */
+declare function calculateBoundsDiagonal(bounds: GeoBounds): number;
+/**
+ * 扩展边界框（添加 padding）
+ * @param bounds 原始边界框
+ * @param padding padding 比例（0-1），默认 0.1 表示 10%
+ * @returns 扩展后的边界框
+ */
+declare function expandBounds(bounds: GeoBounds, padding?: number): GeoBounds;
+/**
+ * 检查点是否在边界框内
+ * @param point 坐标点
+ * @param bounds 边界框
+ * @returns 是否在边界框内
+ */
+declare function isPointInBounds(point: GeoPoint, bounds: GeoBounds): boolean;
+/**
+ * 合并多个边界框
+ * @param boundsArray 边界框数组
+ * @returns 合并后的边界框
+ */
+declare function mergeBounds(boundsArray: GeoBounds[]): GeoBounds | null;
+
 interface FlyToOptions {
     duration?: number;
 }
@@ -268,6 +470,56 @@ interface PathOptions {
     speed?: number;
     loop?: boolean;
 }
+/**
+ * 截图选项
+ */
+interface ScreenshotOptions {
+    /** 图片格式，默认 'image/png' */
+    format?: 'image/png' | 'image/jpeg' | 'image/webp';
+    /** JPEG/WebP 质量 (0-1)，默认 0.92 */
+    quality?: number;
+    /** 生成的文件名，默认 'screenshot_时间戳.png' */
+    fileName?: string;
+}
+/**
+ * 截图结果
+ */
+interface ScreenshotResult {
+    /** Base64 格式的图片数据 */
+    dataUrl: string;
+    /** Blob 对象 */
+    blob: Blob;
+    /** File 对象 */
+    file: File;
+}
+/**
+ * 带视角调整的截图选项
+ */
+interface CaptureWithViewOptions extends ScreenshotOptions {
+    /** 航点列表，用于计算航线范围 */
+    waypoints?: GeoPoint[];
+    /** 是否使用垂直俯视角度，默认 true */
+    topDown?: boolean;
+    /** 边距比例（0-1），默认 0.3 */
+    padding?: number;
+    /** 是否恢复原始相机位置，默认 true */
+    restoreCamera?: boolean;
+    /** 等待渲染的时间（毫秒），默认 800 */
+    renderDelay?: number;
+}
+/**
+ * 飞行到边界框的选项
+ */
+interface FlyToBoundsOptions {
+    /** 边距比例（0-1），默认 0.3 */
+    padding?: number;
+    /** 是否使用垂直俯视角度，默认 true */
+    topDown?: boolean;
+    /** 飞行动画时长（秒），默认 0（立即设置） */
+    duration?: number;
+    /** 额外高度系数，默认 1.05 */
+    heightMultiplier?: number;
+}
 declare class CameraManager {
     private CesiumNS;
     private viewer;
@@ -283,10 +535,6 @@ declare class CameraManager {
      * Toggle between 2D and 3D scene modes while preserving and restoring a 3D orientation.
      */
     toggle2D3D(options?: Toggle2D3DOptions): void;
-    /**
-     * @deprecated Use toggle2D3D instead.
-     */
-    toggleBirdsEye3D(options?: Toggle2D3DOptions): void;
     /**
      * 切换鸟瞰视角（垂直俯视）
      * 在当前3D场景中切换到垂直向下的俯视角度，并可选择使用正交投影
@@ -346,8 +594,6 @@ declare class CameraManager {
      */
     isBirdsEyeView(): boolean;
     setView(view: CameraView): void;
-    moveToChengdu(): void;
-    isitwork(): void;
     setViewEasy(args: {
         destination: CameraDestinationInput;
         orientation?: CameraOrientation;
@@ -379,6 +625,78 @@ declare class CameraManager {
      * @returns
      */
     private flyToAsync;
+    /**
+     * 飞行到边界框位置（用于截图）
+     * 根据航点计算边界框，并将相机移动到合适位置以覆盖整个区域
+     *
+     * @param waypoints 航点数组
+     * @param options 配置选项
+     * @returns 计算出的相机高度
+     *
+     * @example
+     * ```typescript
+     * const waypoints = [
+     *   { lon: 104.0, lat: 30.5 },
+     *   { lon: 104.1, lat: 30.6 },
+     * ];
+     * await cameraManager.flyToBoundsForScreenshot(waypoints, { topDown: true });
+     * ```
+     */
+    flyToBoundsForScreenshot(waypoints: GeoPoint[], options?: FlyToBoundsOptions): number | null;
+    /**
+     * 对当前 Cesium 场景进行截图
+     *
+     * @param options 截图选项
+     * @returns 截图结果，包含 dataUrl、blob、file
+     *
+     * @example
+     * ```typescript
+     * const result = cameraManager.captureScreenshot();
+     * console.log(result.dataUrl); // base64 图片
+     * ```
+     */
+    captureScreenshot(options?: ScreenshotOptions): ScreenshotResult;
+    /**
+     * 调整视角并截图（异步）
+     * 根据航点自动调整相机位置，等待渲染完成后截图
+     *
+     * @param options 截图选项
+     * @returns 截图结果
+     *
+     * @example
+     * ```typescript
+     * const waypoints = [
+     *   { lon: 104.0, lat: 30.5 },
+     *   { lon: 104.1, lat: 30.6 },
+     * ];
+     * const result = await cameraManager.captureScreenshotWithView({
+     *   waypoints,
+     *   topDown: true,
+     *   padding: 0.3,
+     * });
+     * ```
+     */
+    captureScreenshotWithView(options?: CaptureWithViewOptions): Promise<ScreenshotResult>;
+    /**
+     * 等待渲染完成后截图
+     */
+    private captureAfterRender;
+    /**
+     * 将 Base64 DataURL 转换为 Blob
+     */
+    private dataURLtoBlob;
+    /**
+     * 生成截图文件名
+     */
+    private generateScreenshotFileName;
+    /**
+     * 延迟工具函数
+     */
+    private delay;
+    /**
+     * 等待下一个动画帧
+     */
+    private waitForAnimationFrame;
 }
 
 interface SceneOptions {
@@ -2230,8 +2548,36 @@ declare function queryTerrainHeightSync(CesiumNS: typeof Cesium, viewer: Cesium.
  */
 declare function queryTerrainHeightAsync(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, position: Cesium.Cartesian3): Promise<number>;
 /**
- * 根据高度模式计算航点的绝对高度
+ * 根据经纬度查询地形高度（异步）
+ * @param CesiumNS Cesium 命名空间
+ * @param viewer Cesium Viewer 实例
+ * @param lon 经度（度）
+ * @param lat 纬度（度）
+ * @returns 地形高度
+ */
+declare function queryTerrainHeightByLonLat(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, lon: number, lat: number): Promise<number>;
+/**
+ * 根据经纬度批量查询地形高度（异步）
  * @param CesiumNS Cesium 命名空间
+ * @param viewer Cesium Viewer 实例
+ * @param coordinates 经纬度数组，每个元素为 [lon, lat] 或 { lon, lat }
+ * @returns 每个位置对应的地形高度数组
+ */
+declare function queryTerrainHeightsByLonLat(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, coordinates: Array<[number, number] | {
+    lon: number;
+    lat: number;
+}>): Promise<number[]>;
+/**
+ * 根据经纬度同步查询地形高度
+ * @param CesiumNS Cesium 命名空间
+ * @param viewer Cesium Viewer 实例
+ * @param lon 经度（度）
+ * @param lat 纬度（度）
+ * @returns 地形高度（无法获取时返回 0）
+ */
+declare function queryTerrainHeightByLonLatSync(CesiumNS: typeof Cesium, viewer: Cesium.Viewer, lon: number, lat: number): number;
+/**
+ * 根据高度模式计算航点的绝对高度
  * @param altitudeMode 高度模式
  * @param defaultAltitude 默认高度（相对高度值）
  * @param startPointAltitude 起飞点高度（用于 relativeToStart 模式）
@@ -2475,4 +2821,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 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 FlyToOptions, FrustumPyramid, type FrustumPyramidOptions, type FrustumShapeChangeEvent, type ImageryOptions, type ImageryProviderKind, type InitOptions, type LayerEvents, type LayerHandle, LayerManager, type LayerType, type Listener, type LonLatHeight, 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 SegmentSafetyResult, type SelectionChange, type SelectionResult, type SelectionSession, Selector, type ShapeLineProps, type ShapePointProps, type ShapePolygonProps, type SinoflyAdapterOptions, type SinoflyWaylineData, type SinoflyWaypointInfo, StateManager, type TerrainKind, type TerrainOptions, type Toggle2D3DContext, type Toggle2D3DOptions, type VersionInfo, assertCesiumAssetsConfigured, calculateAbsoluteHeight, calculateRelativeHeight, configureCesiumAssets, configureCesiumIonToken, convertPathToSinofly, convertSinoflyWayline, convertSinoflyWaylines, droneModelUrl, ensureCesiumIonToken, getCesiumBaseUrl, getCesiumIonToken, globalCameraEventBus, globalState, placeholder, queryTerrainHeightAsync, queryTerrainHeightSync, queryTerrainHeights, 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, 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 };