vue-openlayers-plugin 1.1.13 → 1.1.14

package/README.md

@@ -336,6 +336,209 @@ layerManager.addLayer({
 })
 ```
 
+#### GeoJSON 图层请求配置
+
+GeoJSON 图层除了支持直接传入 `data` 和 `url`，现在也支持更完整的接口配置，适合通用组件场景下的查询、筛选与动态刷新。
+
+最简单的用法仍然保持不变：
+
+```typescript
+layerManager.addLayer({
+  id: 'geojson-static',
+  name: '静态 GeoJSON',
+  type: 'geojson',
+  visible: true,
+  opacity: 1,
+  zIndex: 10,
+  data: featureCollection
+})
+```
+
+如果需要从接口加载数据，推荐使用 `geojsonConfig.request`：
+
+```typescript
+layerManager.addLayer({
+  id: 'poi-api',
+  name: '接口点位',
+  type: 'geojson',
+  visible: true,
+  opacity: 1,
+  zIndex: 20,
+  projection: 'EPSG:4326',
+  geojsonConfig: {
+    request: {
+      url: '/api/poi/list',
+      method: 'GET',
+      params: {
+        city: 'hangzhou',
+        category: 'restaurant'
+      },
+      headers: {
+        Authorization: 'Bearer token'
+      },
+      dataPath: 'data.list'
+    }
+  }
+})
+```
+
+也兼容扁平写法，适合快速接入：
+
+```typescript
+layerManager.addLayer({
+  id: 'geojson-flat',
+  name: '快速接入图层',
+  type: 'geojson',
+  url: '/api/geojson',
+  method: 'POST',
+  params: {
+    cityCode: '330100'
+  },
+  body: {
+    keyword: '商圈'
+  },
+  dataPath: 'result.features',
+  visible: true,
+  opacity: 1,
+  zIndex: 15
+})
+```
+
+#### GeoJSON 配置项说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| data | `object \| string` | 直接传入 GeoJSON 数据，适合本地数据或已拿到结果的场景 |
+| url | `string` | GeoJSON 请求地址，保留原有用法 |
+| method | `'GET' \| 'POST' \| 'PUT' \| 'PATCH' \| 'DELETE'` | 请求方法 |
+| headers | `Record<string, string>` | 请求头 |
+| params | `Record<string, any>` | 请求参数，`GET` 时会自动拼接到 URL |
+| body | `Record<string, any> \| string` | 请求体，适用于 `POST` 等方法 |
+| dataPath | `string` | 响应中 GeoJSON 数据所在路径，例如 `data.list` |
+| geojsonConfig.request | `object` | 推荐写法，统一管理请求配置 |
+| geojsonConfig.refresh | `object` | 刷新配置，支持定时、移动后、缩放后刷新 |
+| geojsonConfig.clearOnError | `boolean` | 请求失败时是否清空当前图层要素 |
+
+#### 刷新配置示例
+
+```typescript
+layerManager.addLayer({
+  id: 'geojson-refresh',
+  name: '动态刷新图层',
+  type: 'geojson',
+  visible: true,
+  opacity: 1,
+  zIndex: 30,
+  projection: 'EPSG:4326',
+  geojsonConfig: {
+    request: {
+      url: '/api/device/query',
+      method: 'GET',
+      params: {
+        status: 'online'
+      },
+      dataPath: 'data.features'
+    },
+    refresh: {
+      enabled: true,
+      interval: 30000,
+      onMoveEnd: true,
+      onZoomEnd: false,
+      debounce: 300,
+      useExtent: true,
+      extentParamName: 'bbox',
+      extentTarget: 'params',
+      extentProjection: 'EPSG:4326'
+    }
+  }
+})
+```
+
+`refresh` 字段说明：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| enabled | `boolean` | 是否启用刷新能力，默认开启 |
+| interval | `number` | 定时刷新间隔，单位毫秒 |
+| onMoveEnd | `boolean` | 地图移动结束后自动刷新 |
+| onZoomEnd | `boolean` | 地图缩放结束后自动刷新 |
+| debounce | `number` | 地图事件触发后的防抖时间，单位毫秒 |
+| useExtent | `boolean` | 是否自动将当前地图范围作为查询参数传给接口 |
+| extentParamName | `string` | 视野范围参数名，默认 `bbox` |
+| extentTarget | `'params' \| 'body'` | 将范围写入查询参数还是请求体 |
+| extentProjection | `string` | 范围参数使用的坐标系，默认跟随图层投影 |
+
+#### 手动刷新与动态更新参数
+
+如果使用的是 `OlMap` / `CustomOpenlayer` 组件实例，也可以直接调用暴露的方法：
+
+```vue
+<template>
+  <CustomOpenlayer ref="mapRef" :config="mapConfig" />
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue'
+import { CustomOpenlayer } from 'vue-openlayers-plugin'
+
+const mapRef = ref<InstanceType<typeof CustomOpenlayer> | null>(null)
+
+const reloadLayer = async () => {
+  mapRef.value?.updateLayerRequestParams('poi-api', {
+    city: 'ningbo',
+    category: 'hotel'
+  })
+
+  await mapRef.value?.refreshLayer('poi-api')
+}
+</script>
+```
+
+公开方法说明：
+
+| 方法 | 参数 | 说明 |
+|------|------|------|
+| refreshLayer | `(layerId, options?)` | 手动刷新指定图层，可临时传入 `params` / `body` |
+| updateLayerRequestParams | `(layerId, params)` | 更新图层默认请求参数，并立即重新拉取数据 |
+
+#### 高级响应处理
+
+当接口返回结构不固定时，可以通过拦截器或解析器做统一适配：
+
+```typescript
+layerManager.addLayer({
+  id: 'geojson-advanced',
+  name: '高级响应处理',
+  type: 'geojson',
+  visible: true,
+  opacity: 1,
+  zIndex: 40,
+  geojsonConfig: {
+    request: {
+      url: '/api/map/search',
+      method: 'POST',
+      body: {
+        keyword: '学校'
+      },
+      requestInterceptor: async (request) => {
+        return {
+          ...request,
+          headers: {
+            ...request.headers,
+            Authorization: 'Bearer token'
+          }
+        }
+      },
+      responseInterceptor: async (response) => response.result,
+      responseParser: async (response) => ({
+        type: 'FeatureCollection',
+        features: response.items
+      })
+    }
+  }
+})
+```
+
 ### 标绘工具
 
 ```typescript
@@ -435,6 +638,12 @@ MIT License
 
 ## 更新日志
 
+### 1.1.14
+
+- ✨ 新增 GeoJSON 图层接口配置说明，支持 `method`、`headers`、`params`、`body`、`dataPath`
+- ✨ 新增 GeoJSON 图层动态刷新说明，支持定时刷新、移动后刷新、缩放后刷新与视野范围参数
+- ✨ 新增 `refreshLayer` 与 `updateLayerRequestParams` 用法示例，便于业务侧快速接入
+
 ### 1.2.0
 
 - ✨ 新增图标图例功能，支持 PNG、JPG、SVG、GIF、WebP 等图像格式

package/lib/{BasemapPanel-a8d7373d.mjs → BasemapPanel-d022a31a.mjs}

@@ -1,5 +1,5 @@
 import { defineComponent, inject, computed, ref, watch, onMounted, onUnmounted, openBlock, createBlock, unref, withCtx, createElementVNode, createElementBlock, Fragment, renderList, normalizeClass, toDisplayString } from "vue";
-import { r as resolveBasemapThumbnail, l as layerEventBus, X, b as _export_sfc } from "./index-98c677b7.mjs";
+import { r as resolveBasemapThumbnail, l as layerEventBus, X, b as _export_sfc } from "./index-e868c4e2.mjs";
 import "@element-plus/icons-vue";
 import "ol";
 import "proj4";

package/lib/{CoordinateLocationDialog-274aff1a.mjs → CoordinateLocationDialog-6cdf239b.mjs}

@@ -1,6 +1,6 @@
 import { defineComponent, inject, computed, ref, reactive, resolveComponent, openBlock, createBlock, unref, withCtx, createElementVNode, createVNode, createTextVNode } from "vue";
 import { Aim } from "@element-plus/icons-vue";
-import { X, T as TooltipHelper, b as _export_sfc } from "./index-98c677b7.mjs";
+import { X, T as TooltipHelper, b as _export_sfc } from "./index-e868c4e2.mjs";
 import "ol";
 import "proj4";
 import "@supermapgis/iclient-ol";

package/lib/{MapPrintDialog-97054260.mjs → FilterPanel-de00b336.mjs}

@@ -1,4 +1,4 @@
-import { d as _sfc_main } from "./index-98c677b7.mjs";
+import { j as _sfc_main } from "./index-e868c4e2.mjs";
 import "vue";
 import "@element-plus/icons-vue";
 import "ol";

package/lib/{FilterPanel-ccdaaac3.mjs → LayerPanel-1a0456a4.mjs}

@@ -1,4 +1,4 @@
-import { j as _sfc_main } from "./index-98c677b7.mjs";
+import { e as _sfc_main } from "./index-e868c4e2.mjs";
 import "vue";
 import "@element-plus/icons-vue";
 import "ol";

package/lib/{LayerPanel-c716b7cc.mjs → MapPrintDialog-c65f685b.mjs}

@@ -1,4 +1,4 @@
-import { e as _sfc_main } from "./index-98c677b7.mjs";
+import { d as _sfc_main } from "./index-e868c4e2.mjs";
 import "vue";
 import "@element-plus/icons-vue";
 import "ol";

package/lib/{MeasurementDialog-7c08ba58.mjs → MeasurementDialog-44599074.mjs}

@@ -1,5 +1,5 @@
 import { defineComponent, inject, computed, ref, watch, resolveComponent, openBlock, createBlock, unref, withCtx, createElementVNode, createVNode, createTextVNode, toDisplayString, createElementBlock, Fragment, renderList, normalizeClass } from "vue";
-import { X, f as formatMeasurementResult, b as _export_sfc } from "./index-98c677b7.mjs";
+import { X, f as formatMeasurementResult, b as _export_sfc } from "./index-e868c4e2.mjs";
 import "@element-plus/icons-vue";
 import "ol";
 import "proj4";

package/lib/{MyMarkersDialog-89bd594e.mjs → MyMarkersDialog-dd288574.mjs}

@@ -1,7 +1,7 @@
 import { defineComponent, inject, computed, ref, reactive, onUnmounted, watch, resolveComponent, openBlock, createElementBlock, Fragment, createVNode, unref, withCtx, createElementVNode, normalizeClass, createTextVNode, toDisplayString, renderList, createBlock, withModifiers, mergeProps } from "vue";
 import { Plus, FolderOpened, Download, Delete, Search, LocationFilled, Edit } from "@element-plus/icons-vue";
 import { ElMessageBox } from "element-plus";
-import { X, M as MarkerDrawingAdapter, h as fromLonLat, t as toLonLat } from "./index-98c677b7.mjs";
+import { X, M as MarkerDrawingAdapter, h as fromLonLat, t as toLonLat } from "./index-e868c4e2.mjs";
 import "ol";
 import "proj4";
 import "@supermapgis/iclient-ol";

package/lib/{QuadCompareDialog-78dd2cf6.mjs → QuadCompareDialog-2cd17881.mjs}

@@ -1,5 +1,5 @@
 import { defineComponent, ref, inject, computed, shallowRef, reactive, watch, nextTick, onMounted, onUnmounted, resolveComponent, openBlock, createElementBlock, createVNode, unref, withCtx, createElementVNode, Fragment, renderList, createBlock, createCommentVNode } from "vue";
-import { k as layerFactory, i as getUid, m as defaults, X, n as TileLayer, I as ImageLayer, V as VectorTileLayer, H as HeatmapLayer, o as VectorLayer, L as LayerGroup, b as _export_sfc } from "./index-98c677b7.mjs";
+import { k as layerFactory, i as getUid, m as defaults, X, n as TileLayer, I as ImageLayer, V as VectorTileLayer, H as HeatmapLayer, o as VectorLayer, L as LayerGroup, b as _export_sfc } from "./index-e868c4e2.mjs";
 import { u as useMap } from "./useMap-8e3a2de5.mjs";
 import { View, Map } from "ol";
 import "@element-plus/icons-vue";

package/lib/{RegionNavigationDialog-4b7b4e5f.mjs → RegionNavigationDialog-b1cdc5f9.mjs}

@@ -1,5 +1,5 @@
 import { defineComponent, computed, ref, reactive, resolveComponent, openBlock, createBlock, unref, withCtx, createElementVNode, createVNode, createElementBlock, Fragment, renderList, createTextVNode, toDisplayString, normalizeClass } from "vue";
-import { X } from "./index-98c677b7.mjs";
+import { X } from "./index-e868c4e2.mjs";
 import "@element-plus/icons-vue";
 import "ol";
 import "proj4";

package/lib/{SplitCompareDialog-b51b55c1.mjs → SplitCompareDialog-6dd0fb71.mjs}

@@ -1,5 +1,5 @@
 import { defineComponent, ref, inject, computed, shallowRef, watch, nextTick, onMounted, onUnmounted, resolveComponent, openBlock, createElementBlock, createVNode, unref, withCtx, createElementVNode, Fragment, renderList, createBlock, createCommentVNode } from "vue";
-import { k as layerFactory, i as getUid, m as defaults, X, n as TileLayer, I as ImageLayer, V as VectorTileLayer, H as HeatmapLayer, o as VectorLayer, L as LayerGroup, b as _export_sfc } from "./index-98c677b7.mjs";
+import { k as layerFactory, i as getUid, m as defaults, X, n as TileLayer, I as ImageLayer, V as VectorTileLayer, H as HeatmapLayer, o as VectorLayer, L as LayerGroup, b as _export_sfc } from "./index-e868c4e2.mjs";
 import { u as useMap } from "./useMap-8e3a2de5.mjs";
 import { View, Map } from "ol";
 import "@element-plus/icons-vue";

package/lib/{SwipeCompareDialog-2b89b65e.mjs → SwipeCompareDialog-dfae0afd.mjs}

@@ -1,5 +1,5 @@
 import { defineComponent, ref, inject, computed, shallowRef, watch, nextTick, onMounted, onUnmounted, resolveComponent, openBlock, createElementBlock, createVNode, unref, withCtx, createElementVNode, normalizeClass, normalizeStyle, Fragment, renderList, createBlock, createCommentVNode } from "vue";
-import { k as layerFactory, i as getUid, m as defaults, X, n as TileLayer, I as ImageLayer, V as VectorTileLayer, H as HeatmapLayer, o as VectorLayer, L as LayerGroup, b as _export_sfc } from "./index-98c677b7.mjs";
+import { k as layerFactory, i as getUid, m as defaults, X, n as TileLayer, I as ImageLayer, V as VectorTileLayer, H as HeatmapLayer, o as VectorLayer, L as LayerGroup, b as _export_sfc } from "./index-e868c4e2.mjs";
 import { u as useMap } from "./useMap-8e3a2de5.mjs";
 import { View, Map } from "ol";
 import { DCaret } from "@element-plus/icons-vue";

package/lib/{ViewBookmarksDialog-7ee33d4e.mjs → ViewBookmarksDialog-2a6bc942.mjs}

@@ -1,7 +1,7 @@
 import { defineComponent, inject, computed, ref, watch, reactive, resolveComponent, openBlock, createBlock, unref, withCtx, createElementVNode, createVNode, createTextVNode, createElementBlock, Fragment, renderList, withModifiers, toDisplayString, createCommentVNode } from "vue";
 import { Plus, Delete, Search, Camera, View, Edit, Location, ZoomIn } from "@element-plus/icons-vue";
 import { ElMessage, ElMessageBox } from "element-plus";
-import { X, t as toLonLat, h as fromLonLat, i as getUid } from "./index-98c677b7.mjs";
+import { X, t as toLonLat, h as fromLonLat, i as getUid } from "./index-e868c4e2.mjs";
 import "ol";
 import "proj4";
 import "@supermapgis/iclient-ol";

package/lib/{index-3699244d.mjs → index-199c60c9.mjs}

@@ -1,6 +1,6 @@
 import { inject, computed, ref, onMounted, resolveComponent, openBlock, createElementBlock, createVNode, withCtx, Fragment, renderList, createElementVNode, normalizeClass, toDisplayString, unref, createTextVNode, createCommentVNode, createBlock } from "vue";
 import { Close } from "@element-plus/icons-vue";
-import { b as _export_sfc, D as DrawingManager, X } from "./index-98c677b7.mjs";
+import { b as _export_sfc, D as DrawingManager, X } from "./index-e868c4e2.mjs";
 import "ol";
 import "proj4";
 import "@supermapgis/iclient-ol";