@xingm/vmap-cesium-toolbar 0.0.3 → 0.0.4-alpha.2

package/README.md

@@ -104,6 +104,13 @@ import { initCesium } from '@xingm/vmap-cesium-toolbar';
 const { viewer } = await initCesium('cesiumContainer', {
   cesiumToken: 'your_cesium_ion_token',
 });
+
+// 使用天地图时可指定底图类型（默认 imagery）
+const { viewer: tdtViewer } = await initCesium('cesiumContainer', {
+  mapType: 'tiandi',
+  tdtMapTypeId: 'terrain',
+  token: 'your_tianditu_token',
+});
 ```
 
 ## 配置选项

package/dist/hooks/useDrawHelper.d.ts

@@ -6,55 +6,7 @@ import * as Cesium from "cesium";
  * - 提供线、矩形、圆形、多边形的绘制示例方法
  */
 export declare function useDrawHelper(viewer: Ref<Cesium.Viewer | undefined>, message: Ref<string>): {
-    drawHelper: Ref<{
-        handleSceneModeChanged: () => void;
-        startDrawingLine: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingPolygon: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingRectangle: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingCircle: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        endDrawing: () => void;
-        cancelDrawing: () => void;
-        clearAll: () => void;
-        clearAllEntities: () => void;
-        clearAllPoints: () => void;
-        removeEntity: (entity: Cesium.Entity) => void;
-        getEntityLabelEntities: (entity: Cesium.Entity) => Cesium.Entity[];
-        getFinishedEntities: () => Cesium.Entity[];
-        onMeasureComplete: (callback: (result: {
-            type: "line" | "polygon" | "rectangle" | "circle";
-            positions: Cesium.Cartesian3[];
-            distance?: number;
-            areaKm2?: number;
-        }) => void) => void;
-        onDrawStart: (callback: () => void) => void;
-        onDrawEnd: (callback: (entity: Cesium.Entity | null) => void) => void;
-        onEntityRemoved: (callback: (entity: Cesium.Entity) => void) => void;
-        destroy: () => void;
-    } | null, DrawHelper | {
-        handleSceneModeChanged: () => void;
-        startDrawingLine: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingPolygon: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingRectangle: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        startDrawingCircle: (options?: import('../libs/drawHelper').DrawOptions) => void;
-        endDrawing: () => void;
-        cancelDrawing: () => void;
-        clearAll: () => void;
-        clearAllEntities: () => void;
-        clearAllPoints: () => void;
-        removeEntity: (entity: Cesium.Entity) => void;
-        getEntityLabelEntities: (entity: Cesium.Entity) => Cesium.Entity[];
-        getFinishedEntities: () => Cesium.Entity[];
-        onMeasureComplete: (callback: (result: {
-            type: "line" | "polygon" | "rectangle" | "circle";
-            positions: Cesium.Cartesian3[];
-            distance?: number;
-            areaKm2?: number;
-        }) => void) => void;
-        onDrawStart: (callback: () => void) => void;
-        onDrawEnd: (callback: (entity: Cesium.Entity | null) => void) => void;
-        onEntityRemoved: (callback: (entity: Cesium.Entity) => void) => void;
-        destroy: () => void;
-    } | null>;
+    drawHelper: import('vue').ShallowRef<DrawHelper | null, DrawHelper | null>;
     isDrawing: Ref<boolean, boolean>;
     currentDrawMode: Ref<string | null, string | null>;
     initDrawHelper: () => void;

package/dist/hooks/useHeatmapHelper.d.ts

@@ -5,23 +5,7 @@ import * as Cesium from "cesium";
  * 热力图相关的辅助逻辑
  */
 export declare function useHeatmapHelper(viewer: Ref<Cesium.Viewer | undefined>): {
-    heatmapLayer: Ref<{
-        setData: (points: HeatPoint[]) => void;
-        setGradient: (gradient: HeatmapGradient) => void;
-        setOpacity: (opacity: number) => void;
-        setVisible: (visible: boolean) => void;
-        destroy: () => void;
-        setAutoUpdate: (options?: HeatmapAutoUpdateOptions) => void;
-        stopAutoUpdate: () => void;
-    } | null, CesiumHeatmapLayer | {
-        setData: (points: HeatPoint[]) => void;
-        setGradient: (gradient: HeatmapGradient) => void;
-        setOpacity: (opacity: number) => void;
-        setVisible: (visible: boolean) => void;
-        destroy: () => void;
-        setAutoUpdate: (options?: HeatmapAutoUpdateOptions) => void;
-        stopAutoUpdate: () => void;
-    } | null>;
+    heatmapLayer: import('vue').ShallowRef<CesiumHeatmapLayer | null, CesiumHeatmapLayer | null>;
     visible: Ref<boolean, boolean>;
     initHeatmap: (options?: HeatmapOptions) => void;
     updateHeatmapData: (points: HeatPoint[]) => void;

package/dist/hooks/useOverlayHelper.d.ts

@@ -17,227 +17,7 @@ type OverlayHelperOptions = {
  * - 管理点位模式的事件处理及清理
  */
 export declare function useOverlayHelper(viewer: Ref<Cesium.Viewer | undefined>, message: Ref<string>): {
-    overlayService: Ref<{
-        beginBulkUpdate: () => void;
-        endBulkUpdate: () => void;
-        bulkUpdate: <T>(fn: () => T) => T;
-        readonly marker: {
-            add: (options: import('../libs/overlay').MarkerOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').MarkerOptions, "color" | "outlineColor" | "outlineWidth" | "pixelSize">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        readonly label: {
-            add: (options: import('../libs/overlay').LabelOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateText: (entity: Entity, text: string) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').LabelOptions, "fillColor" | "outlineColor" | "outlineWidth" | "font" | "scale">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        readonly icon: {
-            add: (options: import('../libs/overlay').IconOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateImage: (entity: Entity, image: string) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').IconOptions, "scale" | "rotation" | "color">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        readonly svg: {
-            add: (options: import('../libs/overlay').SvgOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateSvg: (entity: Entity, svg: string) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').SvgOptions, "scale" | "rotation" | "color">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        readonly infoWindow: {
-            setDefaultUpdateInterval: (ms: number) => void;
-            forceUpdateAll: () => void;
-            bringToFront: (entity: Entity) => void;
-            add: (options: import('../libs/overlay').InfoWindowOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateContent: (entity: Entity, content: string | HTMLElement) => void;
-            setVisible: (entity: Entity, visible: boolean) => void;
-            show: (entity: Entity) => void;
-            hide: (entity: Entity) => void;
-            remove: (entity: Entity) => void;
-            destroy: () => void;
-        };
-        readonly polyline: {
-            add: (options: import('../libs/overlay').PolylineOptions) => Entity;
-            updatePositions: (entity: Entity, positions: import('../libs/overlay').OverlayPosition[]) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').PolylineOptions, "width" | "material">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        readonly polygon: {
-            add: (options: import('../libs/overlay').PolygonOptions) => Entity;
-            updatePositions: (entity: Entity, positions: import('../libs/overlay').OverlayPosition[]) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').PolygonOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
-            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
-            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
-        };
-        readonly rectangle: {
-            add: (options: import('../libs/overlay').RectangleOptions) => Entity;
-            updateCoordinates: (entity: Entity, coordinates: Cesium.Rectangle) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').RectangleOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
-            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
-            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
-        };
-        readonly circle: {
-            add: (options: import('../libs/overlay').CircleOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateRadius: (entity: Entity, radius: number) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').CircleOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
-            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
-            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
-        };
-        readonly ring: {
-            add: (options: import('../libs/overlay').RingOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateRadius: (entity: Entity, radius: number) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').RingOptions, "color" | "showInnerLine" | "lineColor" | "lineStyle" | "lineMaterialMode" | "stripeRepeat" | "dashLength" | "dashPattern" | "gapColor" | "width" | "glowWidth" | "lineWidth" | "glowPower" | "clampToGround" | "segments">>) => void;
-            setVisible: (entity: Entity, visible: boolean) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        setOverlayEditMode: (enabled: boolean) => void;
-        getOverlayEditModeEnabled: () => boolean;
-        stopOverlayEdit: () => void;
-        startOverlayEdit: (entityOrId: (import('..').DrawEntity & OverlayEntity) | string) => boolean;
-        toggleOverlayHighlight: (entity: OverlayEntity, reason?: "click" | "hover") => void;
-        setOverlayHighlight: (entityOrId: OverlayEntity | string, enabled: boolean, reason?: "click" | "hover") => boolean;
-        addMarker: (options: import('../libs/overlay').MarkerOptions) => Entity;
-        addLabel: (options: import('../libs/overlay').LabelOptions) => Entity;
-        addIcon: (options: import('../libs/overlay').IconOptions) => Entity;
-        addSvg: (options: import('../libs/overlay').SvgOptions) => Entity;
-        addInfoWindow: (options: import('../libs/overlay').InfoWindowOptions) => Entity;
-        addPolyline: (options: import('../libs/overlay').PolylineOptions) => Entity;
-        addPolygon: (options: import('../libs/overlay').PolygonOptions) => Entity;
-        addRectangle: (options: import('../libs/overlay').RectangleOptions) => Entity;
-        addCircle: (options: import('../libs/overlay').CircleOptions) => Entity;
-        addRing: (options: import('../libs/overlay').RingOptions) => Entity;
-        getOverlay: (id: string) => Entity | undefined;
-        removeOverlay: (id: string) => boolean;
-        removeAllOverlays: () => void;
-        updateOverlayPosition: (id: string, position: import('../libs/overlay').OverlayPosition) => boolean;
-        setOverlayVisible: (id: string, visible: boolean) => boolean;
-        getAllOverlayIds: () => string[];
-        getAllOverlays: () => Entity[];
-        destroy: () => void;
-    } | null, CesiumOverlayService | {
-        beginBulkUpdate: () => void;
-        endBulkUpdate: () => void;
-        bulkUpdate: <T>(fn: () => T) => T;
-        readonly marker: {
-            add: (options: import('../libs/overlay').MarkerOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').MarkerOptions, "color" | "outlineColor" | "outlineWidth" | "pixelSize">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        readonly label: {
-            add: (options: import('../libs/overlay').LabelOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateText: (entity: Entity, text: string) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').LabelOptions, "fillColor" | "outlineColor" | "outlineWidth" | "font" | "scale">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        readonly icon: {
-            add: (options: import('../libs/overlay').IconOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateImage: (entity: Entity, image: string) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').IconOptions, "scale" | "rotation" | "color">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        readonly svg: {
-            add: (options: import('../libs/overlay').SvgOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateSvg: (entity: Entity, svg: string) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').SvgOptions, "scale" | "rotation" | "color">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        readonly infoWindow: {
-            setDefaultUpdateInterval: (ms: number) => void;
-            forceUpdateAll: () => void;
-            bringToFront: (entity: Entity) => void;
-            add: (options: import('../libs/overlay').InfoWindowOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateContent: (entity: Entity, content: string | HTMLElement) => void;
-            setVisible: (entity: Entity, visible: boolean) => void;
-            show: (entity: Entity) => void;
-            hide: (entity: Entity) => void;
-            remove: (entity: Entity) => void;
-            destroy: () => void;
-        };
-        readonly polyline: {
-            add: (options: import('../libs/overlay').PolylineOptions) => Entity;
-            updatePositions: (entity: Entity, positions: import('../libs/overlay').OverlayPosition[]) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').PolylineOptions, "width" | "material">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        readonly polygon: {
-            add: (options: import('../libs/overlay').PolygonOptions) => Entity;
-            updatePositions: (entity: Entity, positions: import('../libs/overlay').OverlayPosition[]) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').PolygonOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
-            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
-            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
-        };
-        readonly rectangle: {
-            add: (options: import('../libs/overlay').RectangleOptions) => Entity;
-            updateCoordinates: (entity: Entity, coordinates: Cesium.Rectangle) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').RectangleOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
-            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
-            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
-        };
-        readonly circle: {
-            add: (options: import('../libs/overlay').CircleOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateRadius: (entity: Entity, radius: number) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').CircleOptions, "material" | "outline" | "outlineColor" | "outlineWidth">>) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-            setPrimitiveVisible: (entity: Entity, visible: boolean) => void;
-            applyPrimitiveHighlight: (entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number) => void;
-            restorePrimitiveHighlight: (entity: OverlayEntity) => void;
-        };
-        readonly ring: {
-            add: (options: import('../libs/overlay').RingOptions) => Entity;
-            updatePosition: (entity: Entity, position: import('../libs/overlay').OverlayPosition) => void;
-            updateRadius: (entity: Entity, radius: number) => void;
-            updateStyle: (entity: Entity, options: Partial<Pick<import('../libs/overlay').RingOptions, "color" | "showInnerLine" | "lineColor" | "lineStyle" | "lineMaterialMode" | "stripeRepeat" | "dashLength" | "dashPattern" | "gapColor" | "width" | "glowWidth" | "lineWidth" | "glowPower" | "clampToGround" | "segments">>) => void;
-            setVisible: (entity: Entity, visible: boolean) => void;
-            remove: (entityOrId: Entity | string) => boolean;
-        };
-        setOverlayEditMode: (enabled: boolean) => void;
-        getOverlayEditModeEnabled: () => boolean;
-        stopOverlayEdit: () => void;
-        startOverlayEdit: (entityOrId: (import('..').DrawEntity & OverlayEntity) | string) => boolean;
-        toggleOverlayHighlight: (entity: OverlayEntity, reason?: "click" | "hover") => void;
-        setOverlayHighlight: (entityOrId: OverlayEntity | string, enabled: boolean, reason?: "click" | "hover") => boolean;
-        addMarker: (options: import('../libs/overlay').MarkerOptions) => Entity;
-        addLabel: (options: import('../libs/overlay').LabelOptions) => Entity;
-        addIcon: (options: import('../libs/overlay').IconOptions) => Entity;
-        addSvg: (options: import('../libs/overlay').SvgOptions) => Entity;
-        addInfoWindow: (options: import('../libs/overlay').InfoWindowOptions) => Entity;
-        addPolyline: (options: import('../libs/overlay').PolylineOptions) => Entity;
-        addPolygon: (options: import('../libs/overlay').PolygonOptions) => Entity;
-        addRectangle: (options: import('../libs/overlay').RectangleOptions) => Entity;
-        addCircle: (options: import('../libs/overlay').CircleOptions) => Entity;
-        addRing: (options: import('../libs/overlay').RingOptions) => Entity;
-        getOverlay: (id: string) => Entity | undefined;
-        removeOverlay: (id: string) => boolean;
-        removeAllOverlays: () => void;
-        updateOverlayPosition: (id: string, position: import('../libs/overlay').OverlayPosition) => boolean;
-        setOverlayVisible: (id: string, visible: boolean) => boolean;
-        getAllOverlayIds: () => string[];
-        getAllOverlays: () => Entity[];
-        destroy: () => void;
-    } | null>;
+    overlayService: import('vue').ShallowRef<CesiumOverlayService | null, CesiumOverlayService | null>;
     initOverlayService: (options?: OverlayHelperOptions) => void;
     addMarker: () => void;
     addMarkerWithLabel: () => void;

package/dist/hooks/usePointClusterHelper.d.ts

@@ -5,17 +5,7 @@ import * as Cesium from 'cesium';
  * 点聚类图层相关的辅助逻辑（Vue3 composition API）
  */
 export declare function usePointClusterHelper(viewer: Ref<Cesium.Viewer | undefined>): {
-    clusterLayer: Ref<{
-        setData: (points: ClusterPoint[]) => void;
-        setVisible: (visible: boolean) => void;
-        setClusteringEnabled: (enabled: boolean) => void;
-        destroy: () => void;
-    } | null, CesiumPointClusterLayer | {
-        setData: (points: ClusterPoint[]) => void;
-        setVisible: (visible: boolean) => void;
-        setClusteringEnabled: (enabled: boolean) => void;
-        destroy: () => void;
-    } | null>;
+    clusterLayer: import('vue').ShallowRef<CesiumPointClusterLayer | null, CesiumPointClusterLayer | null>;
     visible: Ref<boolean, boolean>;
     initCluster: (options?: PointClusterLayerOptions) => void;
     updateClusterData: (points: ClusterPoint[]) => void;

package/dist/i18n/en-US.d.ts

@@ -70,6 +70,11 @@ declare const enUS: {
             stop: string;
         };
     };
+    layers: {
+        map_type: {
+            place_name: string;
+        };
+    };
     draw: {
         start: {
             line: string;

package/dist/i18n/zh-CN.d.ts

@@ -70,6 +70,11 @@ declare const zhCN: {
             stop: string;
         };
     };
+    layers: {
+        map_type: {
+            place_name: string;
+        };
+    };
     draw: {
         start: {
             line: string;