@go-home-early/go-home-early98 0.3.8 → 0.4.0

package/README.md

@@ -1,14 +1,13 @@
 # go-home-early🚀
 
-## Project setup ⚙️
+## 快速安装 ⚙️
 ```
 1. npm i @go-home-early/go-home-early98
 
-2. 此项目依赖cesium和element-ui，如果没有请执行以下命令
-   npm i cesium@1.95 element-ui
-
 3. 在main.js中引用
     import GoHomeEarly from '@go-home-early/go-home-early98';
+    import "@cesium/widgets/Source/widgets.css";
+    import "@go-home-early/go-home-early98/dist/go-home-early.css"
     Vue.use(GoHomeEarly);
 
 4. 请在vue.config.vue中添加以下配置
@@ -34,3 +33,7 @@
       }
     };
 ```
+## 按需导入
+```
+    import { cesium } from '@go-home-early/go-home-early98';
+```

package/dist/go-home-early.umd.js

@@ -42177,7 +42177,7 @@ if (typeof window !== 'undefined') {
 // Indicate to webpack that this file can be concatenated
 /* harmony default export */ var setPublicPath = (null);
 
-// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"f4d49478-vue-loader-template"}!./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--6!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/packages/Cesium/index.vue?vue&type=template&id=ec7fecf6&scoped=true
+// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"b4e6f62e-vue-loader-template"}!./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--6!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/packages/Cesium/index.vue?vue&type=template&id=ec7fecf6&scoped=true
 var Cesiumvue_type_template_id_ec7fecf6_scoped_true_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
@@ -417622,7 +417622,7 @@ function CesiumNavigation_initialize(viewerCesiumWidget, options) {
 
 /* harmony default export */ var dist_CesiumNavigation = (CesiumNavigation);
 
-// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"f4d49478-vue-loader-template"}!./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--6!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/packages/Cesium/DrawMap/index.vue?vue&type=template&id=37acc99b&scoped=true
+// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"b4e6f62e-vue-loader-template"}!./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--6!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/packages/Cesium/DrawMap/index.vue?vue&type=template&id=37acc99b&scoped=true
 var DrawMapvue_type_template_id_37acc99b_scoped_true_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
@@ -422333,7 +422333,7 @@ var component = normalizeComponent(
 var terraformer_wkt_parser = __webpack_require__("5a1f");
 var terraformer_wkt_parser_default = /*#__PURE__*/__webpack_require__.n(terraformer_wkt_parser);
 
-// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"f4d49478-vue-loader-template"}!./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--6!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/packages/Cesium/components/Popup.vue?vue&type=template&id=3cb00216&scoped=true
+// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"b4e6f62e-vue-loader-template"}!./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--6!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/packages/Cesium/components/Popup.vue?vue&type=template&id=3cb00216&scoped=true
 var Popupvue_type_template_id_3cb00216_scoped_true_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
@@ -422697,7 +422697,7 @@ var Popup_component = normalizeComponent(
 )
 
 /* harmony default export */ var Popup = (Popup_component.exports);
-// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"f4d49478-vue-loader-template"}!./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--6!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/packages/Cesium/components/LocationDialog.vue?vue&type=template&id=8660a454&scoped=true
+// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"b4e6f62e-vue-loader-template"}!./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--6!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/packages/Cesium/components/LocationDialog.vue?vue&type=template&id=8660a454&scoped=true
 var LocationDialogvue_type_template_id_8660a454_scoped_true_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
@@ -423132,7 +423132,7 @@ var LocationDialog_component = normalizeComponent(
 )
 
 /* harmony default export */ var LocationDialog = (LocationDialog_component.exports);
-// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"f4d49478-vue-loader-template"}!./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--6!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/packages/Cesium/components/PoumianDialog.vue?vue&type=template&id=854b6d14&scoped=true
+// CONCATENATED MODULE: ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"b4e6f62e-vue-loader-template"}!./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/thread-loader/dist/cjs.js!./node_modules/babel-loader/lib!./node_modules/vue-loader/lib/loaders/templateLoader.js??ref--6!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/packages/Cesium/components/PoumianDialog.vue?vue&type=template&id=854b6d14&scoped=true
 var PoumianDialogvue_type_template_id_854b6d14_scoped_true_render = function render() {
   var _vm = this,
     _c = _vm._self._c;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-home-early/go-home-early98",
-  "version": "0.3.8",
+  "version": "0.4.0",
   "private": false,
   "main": "dist/go-home-early.umd.js",
   "description": "text-components",

package/src/packages/Cesium/index.md

@@ -2,7 +2,7 @@
 
 本文档记录了 Cesium 地图组件的封装方法、常用功能以及图层叠加的步骤。
 
-> **📝 注意**: 当前项目使用 `index.vue`，`index1.vue` 作为未经修改的原始副本。
+>[object Object]副本。
 
 ---
 
@@ -22,6 +22,65 @@
 
 ## 🛠️ 常用方法简介
 
+> 下表基于 `src/packages/Cesium/index.vue` 中公开的方法进行整理，**所有经纬度均默认为 EPSG:4326（十进制度）**，除非另有说明。
+>
+> `viewer` 参数若未显式给出，则默认取组件内部的 `this.viewer` 实例。
+
+| 方法 | 参数 | 返回值 | 作用 |
+| --- | --- | --- | --- |
+| `changeMapMode()` | 无 | `void` | 在 2D 与 3D 场景模式之间切换，相机自动保持当前中心点。 |
+| `handleZoomIn()` | 无 | `void` | 按照当前相机高度的 `10 %` 进行放大。 |
+| `handleZoomOut()` | 无 | `void` | 按照当前相机高度的 `10 %` 进行缩小。 |
+| `init([viewerParams])` | `viewerParams?: Object` – 透传给 `Cesium.Viewer` 的构造参数 | `void` | 初始化 Cesium 实例、底图及地形。组件挂载时自动调用。 |
+| `initFlyTo(viewer?)` | `viewer? : Cesium.Viewer` | `void` | 飞行到江西省范围（作为起始视域）。 |
+| `flyToDefault()` | 无 | `void` | 重置到预设的默认视域（江西省）并保持顶视角。 |
+| `flyToPoint(options, viewer?)` | `options: { point: string(WKT); height?: number; heading?: number; pitch?: number; roll?: number; range?: number; duration?: number; surround?: boolean }` | `Promise<void>` | 飞行到指定 WKT 点。可选支持环绕 (`surround=true`) 及自定义相机姿态。 |
+| `getCameraInfo(viewer?)` | 无 | `void` | 监听相机变化并实时把 `{height,longitude,latitude,heading,pitch,roll}` 写入 `this.cameraInfo`。 |
+| `storeViewer(viewer?)` | 无 | `void` | 把当前相机位置和姿态存入 `this.currentViewer` 以便后续恢复。 |
+| `restoreViewer(viewer?)` | 无 | `void` | 根据 `storeViewer` 保存的信息复原视角。 |
+| `getCameraDistance()` | 无 | `number` | 计算当前相机到地表交点的距离（米）。 |
+| `addB3dmLayer({url:string}, viewer?)` | `{ url:string }` | `Promise<Cesium.Cesium3DTileset>` | 加载 3DTiles 数据集并自动飞行至数据范围。 |
+| `addGltfLayer(params, viewer?)` | `{ url:string; boundaryLine:string(WKT Point); scale?:number; size?:number }` | `Promise<Cesium.Model>` | 在指定 WKT 点位置加载 glTF 模型并自动调整视角。 |
+| `addWmsLayer(params, viewer?)` | `{ name:string; url:string; work:string; layerName:string; style?:string; filter?:string; layerEventFun?:Function }` | `void` | 新增一个 WMS 影像图层并可绑定点击回调。 |
+| `delWmsLayer(name, viewer?)` | `name:string` | `void` | 根据名称移除 WMS 图层。 |
+| `setWmsLayerVisible({name,active})` | `{name:string; active:boolean}` | `void` | 控制 WMS 图层显隐。 |
+| `changeStreetSelector(active)` | `active:boolean` | `void` | 开关天地图路网注记 (CIA 图层)。 |
+| `addWktLayer(options, viewer?)` | 详见下方*WKT 图层参数* | `Promise<void>` | 根据 WKT / 数据列表叠加矢量数据，支持聚合、贴地、自动飞行、点击/悬浮事件等高级功能。 |
+| `delWktLayer(name, viewer?)` | `name:string` | `void` | 删除指定 WKT 数据源及所有实体。 |
+| `setWktLayerVisible({name,active})` | `{name:string; active:boolean}` | `void` | 控制 WKT 图层显隐。 |
+| `getFeatureInfoUrl(opts, viewer?)` | `{url,work,name,position,width?,height?,infoFormat?,filterSql?}` | `string` | 组装符合 GeoServer WMS `GetFeatureInfo` 的请求 URL。 |
+| `getPointHeight([lng,lat], viewer?)` | `[number,number]` | `Promise<number>` | 采样单点地形高程 (米)。 |
+| `getTerrainHeight(pointsArray)` | `Array<[lng,lat]>` | `Promise<Cartographic[]>` | 批量采样地形高程并带缓存。 |
+| `drawLayer(cfg, cb)` | `cfg:{name,type:'Point'\|'LineString'\|'Polygon'; single?:boolean; style?:Object; ...}` | `void` | 在自定义数据源上启动交互绘制，结束后回调结果。 |
+| `clearDrawLayer({name,active})` | `{name:string; active?:boolean}` | `void` | 清空指定绘制数据源上的所有实体并恢复鼠标状态。 |
+| `loadTrackPlayBackData(trackData, opts?, frustum?)` | `trackData:Array<TrackPoint>` `opts?:{speed?:number}` `frustum?:FrustumCfg` | `void` | 加载无人机轨迹并按时钟回放，可同时绘制实时视椎体。 |
+| `clearTrackPlayback()` | 无 | `void` | 清除回放实体、视椎体并复位时钟。 |
+| `addFrustum(cfg)` | `cfg:{longitude,latitude,height,heading,pitch,roll?,fov,near?,far?,aspectRatio}` | `void` | 在指定相机参数处绘制视椎体 (实体 + 轮廓 Primitive)。 |
+| `clearFrustum()` | 无 | `void` | 移除当前视椎体 Primitive。 |
+| `updateSizeFunction()` | 无 | `void` | 手动触发 Cesium 重新计算容器大小并请求渲染，用于外层布局变化。 |
+| `extentFromWkt(wkt)` | `wkt:string` | `{west,south,east,north,width,height}` | 解析任意 WKT 计算外包矩形边界。 |
+| `dmsToDegrees(dms)` | `dms:string\|number` | `number` | 将度分秒字符串转换为十进制度 (浮点)。 |
+| `destroy()` | 无 | `void` | 彻底销毁 Viewer 实例并释放 WebGL 上下文。 |
+
+### WKT 图层参数（`addWktLayer`）
+主要字段：
+```ts
+interface WktLayerOptions {
+  name: string;                 // 图层名称
+  list?: any[];                 // 数据数组
+  coordsArr?: any[];            // 自定义坐标数组
+  coordField?: string;          // 坐标字段名，默认 'boundaryLine'
+  coordsStyle?: Object;         // 通用样式配置（点/线/面）
+  vectorEventFun?: (entity, info)=>void; // 点击/悬浮回调
+  clampToGround?: boolean;      // 是否贴地
+  fit?: boolean;                // 是否自动飞行到范围
+  isCluster?: boolean;          // 是否启用聚合
+  clusterStyle?: Object;        // 聚合显示样式
+  fitOptions?: Cesium.Camera.FlightOptions; // 自定义飞行参数
+}
+```
+
+
 `changeMapMode()`
 :   在二维和三维模式之间切换地图。
 
@@ -49,9 +108,6 @@
 `drawLayer()`
 :   绘制图层。绘制的图层对象会存入 `drawLayerObj` 中，可通过 `drawLayerObj[name]` 获取。
 
-`toDegrees(radians)`
-:   将 Cartographic (大地坐标) 的弧度值转换为经纬度角度值。
-
 `formatWktToPoint(wkt)`
 :   将 `POINT(114.19 26.52)` 格式的 WKT 字符串转换为 `['114.19', '26.52']` 格式的数组。
 
@@ -100,11 +156,218 @@
 `dmsToDegrees()`
 :   将度分秒格式的坐标 `117° 47' 16.85"` 转换为角度格式 `'114.19'`。
 
+`processGeoJSONData()`
+:   处理 GeoJSON 数据。
+
+`loadMaskPrimitive()`
+:   加载遮罩图元。
+
+`handleTool()`
+:   处理工具栏操作。
+
+`destroy()`
+:   销毁 Cesium 实例。
+
+`setCesiumStyle()`
+:   设置 Cesium 样式。
+
+`drawCircleByWkt()`
+:   通过 WKT 绘制圆形。
+
+`init()`
+:   初始化 Cesium Viewer。
+
+`getCameraInfo()`
+:   获取相机信息。
+
+`addGltfLayer()`
+:   添加 GLTF 模型图层。
+
+`initFlyTo()`
+:   初始化飞行定位。
+
+`flyToPoint()`
+:   飞行到指定点。
+
+`restoreViewer()`
+:   恢复之前存储的视角。
+
+`delWktLayer()`
+:   删除 WKT 图层。
+
+`setWktLayerVisible()`
+:   设置 WKT 图层可见性。
+
+`getFeatureInfoUrl()`
+:   获取 WMS 图层要素信息 URL。
+
+`handleColor()`
+:   处理颜色值。
+
+`handleStyle()`
+:   处理图层样式。
+
+`handleItemStyle()`
+:   处理单个图元样式。
+
+`handleClusterImageIcon()`
+:   处理聚合图标（图片）。
+
+`handleClusterColorIcon()`
+:   处理聚合图标（颜色）。
+
+`isWkt()`
+:   判断是否为 WKT 格式。
+
+`addPopup()`
+:   添加弹窗。
+
+`closePopup()`
+:   关闭弹窗。
+
+`updatePopupPosition()`
+:   更新弹窗位置。
+
+`zoomToCluster()`
+:   缩放到聚合点。
+
+`startSurround()`
+:   开始环绕飞行。
+
+`stopSurround()`
+:   停止环绕飞行。
+
+`toggleSurround()`
+:   切换环绕飞行状态。
+
+`removeLayerByName()`
+:   根据名称移除图层。
+
+`getFeatureByWKT()`
+:   通过 WKT 获取要素。
+
+`getCoordinatesByWkt()`
+:   通过 WKT 获取坐标。
+
+`getAreaByWkt()`
+:   通过 WKT 获取面积或长度。
+
+`calculatePolygonArea()`
+:   计算多边形面积。
+
+`calculateSinglePolygonArea()`
+:   计算单个多边形面积。
+
+`calculateRingArea()`
+:   计算环面积。
+
+`calculateLineLength()`
+:   计算线长度。
+
+`calculateSingleLineLength()`
+:   计算单条线长度。
+
+`calculateDistance()`
+:   计算两点间距离。
+
+`getCameraDistance()`
+:   获取相机到地图中心的距离。
+
+`drawPoint()`
+:   绘制点。
+
+`drawLineString()`
+:   绘制线。
+
+`drawPolygon()`
+:   绘制多边形。
+
+`getDrawStyle()`
+:   获取绘制样式。
+
+`getCenterByWkt()`
+:   通过 WKT 获取中心点。
+
+`calculateGeometryCenter()`
+:   计算几何中心。
+
+`calculatePolygonCenter()`
+:   计算多边形中心。
+
+`calculateMultiPolygonBoundsCenter()`
+:   计算多个多边形边界中心。
+
+`calculatePointsBoundsCenter()`
+:   计算点集边界中心。
+
+`updateSizeFunction()`
+:   更新地图尺寸。
+
+`getBufferWkt()`
+:   获取 WKT 缓冲区的 WKT。
+
+`calculateBufferPoints()`
+:   计算缓冲区点。
+
+`calculatePolygonBuffer()`
+:   计算多边形缓冲区。
+
+`loadTrackPlayBackData()`
+:   加载轨迹回放数据。
+
+`clearTrackPlayback()`
+:   清除轨迹回放。
+
+`loadGeoJson()`
+:   加载 GeoJSON 数据。
+
+`addFrustum()`
+:   添加视锥体。
+
+`clearFrustum()`
+:   清除视锥体。
+
+`updatePosition()`
+:   更新实体位置。
+
+`drawBtnClick()`
+:   绘制按钮点击事件。
+
+`mangAddLayer()`
+:   管理后台添加图层。
+
+`mangDefaultLayer()`
+:   管理后台默认图层。
+
+`handleCoordinateLength()`
+:   处理坐标长度。
+
+`setPositioningData()`
+:   设置定位数据。
+
+`deleteMangLayerClick()`
+:   删除管理后台图层点击事件。
+
+`initDrawBtn()`
+:   初始化绘制按钮。
+
+`updateMapBtn()`
+:   更新地图按钮。
+
 ---
 
 ## ⚙️ Props
 
--   `scale` (Number): 当地图容器被缩放时，需传入此缩放比例以进行兼容性调整。
+| Prop | Type | Default | 说明 |
+| --- | --- | --- | --- |
+| `params` | `Object` | `{ autoFlyTo: true }` | 传递给 `Cesium.Viewer` 的初始化参数。`autoFlyTo` 控制加载后是否自动飞行至默认视域（江西省）。 |
+| `height` | `String` | `"100%"` | 地图容器的高度，支持所有合法的 CSS `height` 值。 |
+| `showNavigation` | `Boolean` | `false` | 是否显示内置的导航控件（指北针、模式切换、缩放、底图切换）。 |
+| `showTimeline` | `Boolean` | `false` | 是否在底部显示 Cesium 的时间轴控件。 |
+| `scale` | `Number` | `1` | 当地图容器被外层 CSS `transform: scale()` 缩放时，传入此比例以修正鼠标事件的坐标拾取。 |
+| `mangDrawType` | `String` | `'Point'` | 在后台管理模式下，允许绘制的几何类型。可选值为 `'Point'`, `'LineString'`, `'Polygon'`, `'PointPolygon'`。 |
+| `isShowCoordinate` | `Boolean` | `false` | 是否显示为后台管理设计的坐标采集面板。 |
+
 
 ---
 
@@ -119,9 +382,7 @@ Cesium 中主要包含以下几种图层集合：
 
 ---
 
-## 🔗 图层、数据源与实体的关系
-
--   **关系**: `Entity` 是数据本身，`DataSource` 是装载数据的容器，而 `Layer` 是将容器中的数据展示到地图上的工具。
+##[object Object]数据本身，`DataSource` 是装载数据的容器，而 `Layer` 是将容器中的数据展示到地图上的工具。
 -   `drawLayer()` 和 `addWktLayer()` 方法都是通过新建数据源并向其中添加实体来工作的。
 
 -   **叠加图层流程**:
@@ -289,4 +550,4 @@ Cesium 的架构自下而上分为六层：
 | `shadows` | `Property` | `ShadowMode.DISABLED` | 阴影模式。 |
 | `distanceDisplayCondition` | `Property` | `—` | 控制可见性的距离条件。 |
 | `classificationType` | `Property` | `ClassificationType.BOTH` | 分类类型。 |
-| `zIndex` | `Property` | `0` | `clampToGround` 为 true 时的 Z-index 排序。 |
+| `zIndex` | `Property` | `0` | `clampToGround` 为 true 时的 Z-index 排序。 |