@xingm/vmap-cesium-toolbar 0.0.2-alpha.15 → 0.0.2-alpha.16

package/README.md

@@ -28,12 +28,14 @@ import { CesiumMapToolbar, initCesium } from '@xingm/vmap-cesium-toolbar';
 import '@xingm/vmap-cesium-toolbar/style';
 
 // 初始化Cesium
-const viewer = initCesium('cesiumContainer', {
-  terrainProvider: Cesium.createWorldTerrain()
-});
+(async () => {
+  const { viewer } = await initCesium('cesiumContainer', {
+    terrainProvider: Cesium.createWorldTerrain(),
+  });
 
-// 创建工具栏
-const toolbar = new CesiumMapToolbar(viewer, document.getElementById('toolbar'));
+  // 创建工具栏
+  const toolbar = new CesiumMapToolbar(viewer, document.getElementById('toolbar'));
+})();
 ```
 
 ### Vue 3 项目中使用
@@ -52,11 +54,12 @@ import '@xingm/vmap-cesium-toolbar/style';
 let viewer;
 let toolbar;
 
-onMounted(() => {
+onMounted(async () => {
   // 初始化Cesium
-  viewer = initCesium('cesiumContainer', {
-    terrainProvider: Cesium.createWorldTerrain()
+  const result = await initCesium('cesiumContainer', {
+    terrainProvider: Cesium.createWorldTerrain(),
   });
+  viewer = result.viewer;
 
   // 创建工具栏
   toolbar = new CesiumMapToolbar(viewer, document.getElementById('toolbar'));
@@ -80,30 +83,26 @@ const toolbar = new CesiumMapToolbar(
 );
 ```
 
-### CesiumMapHelper
+### DrawHelper
 
-地图辅助工具类，提供绘制和测量功能。
+绘制工具类（包的默认导出），提供线/面/矩形/圆等交互绘制能力。
 
 ```typescript
-import { CesiumMapHelper } from '@xingm/vmap-cesium-toolbar';
+import DrawHelper from '@xingm/vmap-cesium-toolbar';
 
-const helper = new CesiumMapHelper(viewer);
-helper.startDrawing('line');  // 开始绘制线条
-helper.startMeasurement('distance'); // 开始距离测量
+const drawHelper = new DrawHelper(viewer);
+drawHelper.startDrawingPolygon();
 ```
 
-### CesiumMapLoader
+### initCesium
 
-Cesium初始化工具，简化Cesium的配置和初始化。
+Cesium 初始化函数，简化 Viewer 创建、底图/地形与初始视角配置。
 
 ```typescript
-import { CesiumMapLoader } from '@xingm/vmap-cesium-toolbar';
+import { initCesium } from '@xingm/vmap-cesium-toolbar';
 
-const viewer = CesiumMapLoader.init('container', {
-  terrainProvider: Cesium.createWorldTerrain(),
-  imageryProvider: new Cesium.OpenStreetMapImageryProvider({
-    url: 'https://a.tile.openstreetmap.org/'
-  })
+const { viewer } = await initCesium('cesiumContainer', {
+  cesiumToken: 'your_cesium_ion_token',
 });
 ```
 
@@ -231,6 +230,7 @@ npm run dev
 - [CesiumMapToolbar API](./doc/CesiumMapToolbar_API.md)
 - [CesiumMapHelper API](./doc/CesiumMapHelper_API.md)
 - [CesiumMapLoader API](./doc/CesiumMapLoader_API.md)
+- [CesiumOverlayService API](./doc/CesiumOverlayService_API.md)
 
 ## 依赖要求
 

package/dist/index.d.ts

@@ -216,9 +216,33 @@ export declare class CesiumMapToolbar {
       search?: SearchCallback;
       measurement?: MeasurementCallback;
       zoom?: ZoomCallback;
+      fullscreen?: (isFullscreen: boolean) => void;
+      resetLocation?: () => void;
     },
     initialCenter?: { longitude: number; latitude: number; height: number }
   );
+
+  /** 天地图 Token（可直接修改或配合 setTDToken） */
+  TD_Token: string;
+
+  /** 当前可用的底图类型列表 */
+  mapTypes: MapType[];
+
+  /** 获取内部搜索服务实例 */
+  getSearchService(): SearchService;
+
+  /** 获取内部禁飞区服务实例 */
+  getNotFlyZonesService(): NotFlyZonesService;
+
+  /** 获取内部测量服务实例 */
+  getMeasurementService(): any; // MeasurementService (内部未在 d.ts 中单独暴露)
+
+  /** 获取内部地图控制器实例 */
+  getCesiumMapCtrl(): CesiumMapController;
+
+  /** 获取内部图层服务实例 */
+  getMapLayersService(): MapLayersService;
+
   setMapTypes(mapTypes: MapType[]): void;
   setTDToken(TD_Token: string): void;
   setInitialCenter(center: { longitude: number; latitude: number; height: number }): void;
@@ -298,6 +322,9 @@ export interface OverlayEntity extends Entity {
   _innerRadius?: number;
   _outerRectangle?: Cesium.Rectangle;
 
+  /** primitive layer key: 用于分层批处理路由 */
+  _primitiveLayerKey?: string;
+
   /** primitive circle: 内部使用的纯色缓存（用于高亮恢复） */
   _primitiveRingBaseColor?: any;
   _primitiveFillBaseColor?: any;
@@ -451,6 +478,8 @@ export interface PolygonOptions {
   clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
+  /** primitive 分层渲染 key（不同 key 会进入不同批次并按创建顺序确定上下层） */
+  layerKey?: string;
   id?: string;
 }
 
@@ -469,6 +498,8 @@ export interface RectangleOptions {
   clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
+  /** primitive 分层渲染 key（不同 key 会进入不同批次并按创建顺序确定上下层） */
+  layerKey?: string;
   id?: string;
 }
 
@@ -489,6 +520,8 @@ export interface CircleOptions {
   clickHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   hoverHighlight?: boolean | { color?: any | string; fillAlpha?: number };
   onClick?: (entity: Entity) => void;
+  /** primitive 分层渲染 key（不同 key 会进入不同批次并按创建顺序确定上下层） */
+  layerKey?: string;
   id?: string;
 }
 
@@ -676,6 +709,10 @@ export interface CesiumMapControllerOptions {
   getToken?: () => string;
   zoomCallback?: ZoomCallback;
   onSceneModeChanged?: () => void;
+    /** 全屏切换回调 */
+  fullscreenCallback?: (isFullscreen: boolean) => void;
+  /** 复位位置回调 */
+  resetLocationCallback?: () => void;
 }
 
 export declare class CesiumMapController {
@@ -779,6 +816,14 @@ export interface DrawOptions {
    * 默认 true；设为 false 可禁用绘制完成后自动创建的面积标签。
    */
   showAreaLabel?: boolean;
+
+  /**
+   * 是否启用多边形自相交校验。
+   * - false/未设置：默认允许交叉（不做校验）
+   * - true：启用自相交校验（结合 selfIntersectionAllowTouch/AllowContinue 控制行为）
+   */
+  selfIntersectionEnabled?: boolean;
+  
   /**
    * 多边形自相交校验：是否允许“擦边/顶点落在旧边上”等仅接触（touch）情况。
    * - false/未设置：touch 也视为不合法