Add SEO metadata and security headers

2026-05-23 11:17:29 +08:00
parent cc65395b59
commit 582a4214b6
40 changed files with 15323 additions and 5 deletions
@@ -0,0 +1,420 @@
+## 行业标准图层
+
+符合 OGC 标准或者行业通行规范的的图层类型
+
+
+## WMS
+
+**Extends TileLayer**
+
+用于加载OGC标准的WMS地图服务的一种图层类，仅支持EPSG3857坐标系统的WMS图层。 </br>
+[查看 WMS的OGC标准][53]。
+
+### Parameters
+
+-   `opts` **WMSLayerOptions** 默认图层参数
+    -   `opts.url` **String** wmts服务的url地址，如：'[https://services.arcgisonline.com/arcgis/rest/services/'+][54]
+        'Demographics/USA_Population_Density/MapServer/WMTS/'
+    -   `opts.blend` **Boolean** 地图级别切换时，不同级别的图片是否进行混合，如图层的图像内容为部分透明请设置为false
+    -   `opts.param` **Object** OGC标准的WMS地图服务的GetMap接口的参数，包括VERSION、LAYERS、STYLES、FORMAT、TRANSPARENT等， </br>
+        CRS、BBOX、REQUEST、WIDTH、HEIGHT等参数请勿添加，例如： </br>
+        { </br>
+            LAYERS: 'topp:states', </br>
+            VERSION:'1.3.0', </br>
+            FORMAT:'image/png' </br>
+        }
+    -   `opts.zooms` **\[Number, Number]** 支持的缩放级别范围，默认范围 [2-30] (optional, default `[2,30]`)
+    -   `opts.opacity` **Number** 透明度，默认 1 (optional, default `1`)
+    -   `opts.visible` **Boolean** 是否显示，默认 true (optional, default `true`)
+    -   `opts.zIndex` **Number** 图层叠加的顺序值，1 表示最底层。默认 zIndex：4 (optional, default `4`)
+
+### setParams
+
+设置OGC标准的WMS getMap接口的参数，包括VERSION、LAYERS、STYLES、FORMAT、TRANSPARENT等
+
+#### Parameters
+
+-   `params` **Object** 参数集合，{VERSION: '1.0', ...}
+
+### getParams
+
+获取 OGC 标准的 WMS getMap 接口的参数
+
+### setUrl
+
+设置 WMS 服务地址
+
+#### Parameters
+
+-   `url` **String** 服务地址
+
+### setUrl
+
+设置 WMS 服务地址
+
+#### Parameters
+
+-   `url` **String** 服务地址
+
+### getOptions
+
+获取图层参数信息
+
+Returns **Object** 图层参数信息
+
+### getzIndex
+
+获取图层层级
+
+Returns **Number** zIndex 图层层级
+
+### setzIndex
+
+设置图层层级，数字越大图层层级越高
+
+#### Parameters
+
+-   `zIndex` **Number** 图层层级值
+
+### getOpacity
+
+获取图层透明度
+
+Returns **Number** opacity 图层透明度
+
+### setOpacity
+
+设置图层透明度，范围 [0 ~ 1]
+
+#### Parameters
+
+-   `opacity` **Number** 图层透明度
+
+### getZooms
+
+获取该图层可显示的级别范围，默认取值范围为[2-30]
+
+Returns **\[Number, Number]** 缩放范围
+
+### setZooms
+
+获取该图层可显示的级别范围
+
+#### Parameters
+
+-   `zooms` **\[Number, Number]** 缩放范围
+
+### show
+
+设置图层可见
+
+### hide
+
+设置图层隐藏
+
+## WMTS
+
+**Extends TileLayer**
+
+用于加载 OGC 标准的 WMTS 地图服务的一种图层类，仅支持 EPSG3857 坐标系统的 WMTS 图层 </br>
+[查看 WMTS 标准][55] </br>
+[相关示例][56]
+
+### Parameters
+
+-   `opts` **WMTSLayerOptions** 默认图层参数
+    -   `opts.url` **String** wms服务的url地址，如'[https://ahocevar.com/geoserver/wms][57]'
+    -   `opts.blend` **Boolean** 地图级别切换时，不同级别的图片是否进行混合，如图层的图像内容为部分透明请设置为false
+    -   `opts.param` **Object** OGC标准的WMTS地图服务的GetTile接口的参数，包括Version、Layer、
+        Style、Format、Service等，TileMatrixSet、TileRow、TileCol、Request等参数请勿添加，例如： </br>
+        { </br>
+            Layer: '0', </br>
+            Version:'1.0.0', </br>
+            Format: 'image/png' </br>
+        }
+    -   `opts.zooms` **\[Number, Number]** 支持的缩放级别范围，默认范围 [2-30] (optional, default `[2,30]`)
+    -   `opts.opacity` **Number** 透明度，默认 1 (optional, default `1`)
+    -   `opts.visible` **Boolean** 是否显示，默认 true (optional, default `true`)
+    -   `opts.zIndex` **Number** 图层叠加的顺序值，1 表示最底层。默认 zIndex：4 (optional, default `4`)
+
+### setParams
+
+设置 OGC 标准的 WMTS getTile接口的参数，包括Version、Layer、Style、Format、Service等
+
+#### Parameters
+
+-   `params` **Object** 参数集合，{VERSION: '1.0', ...}
+
+### getParams
+
+获取 OGC 标准的 WMTS getMap 接口的参数
+
+### getUrl
+
+获取 WMTS 服务地址
+
+Returns **String** 地址
+
+### setUrl
+
+设置 WMTS 服务地址
+
+#### Parameters
+
+-   `url` **String** 服务地址
+
+### getOptions
+
+获取图层参数信息
+
+Returns **Object** 图层参数信息
+
+### getzIndex
+
+获取图层层级
+
+Returns **Number** zIndex 图层层级
+
+### setzIndex
+
+设置图层层级，数字越大图层层级越高
+
+#### Parameters
+
+-   `zIndex` **Number** 图层层级值
+
+### getOpacity
+
+获取图层透明度
+
+Returns **Number** opacity 图层透明度
+
+### setOpacity
+
+设置图层透明度，范围 [0 ~ 1]
+
+#### Parameters
+
+-   `opacity` **Number** 图层透明度
+
+### getZooms
+
+获取该图层可显示的级别范围，默认取值范围为[2-30]
+
+Returns **\[Number, Number]** 缩放范围
+
+### setZooms
+
+获取该图层可显示的级别范围
+
+#### Parameters
+
+-   `zooms` **\[Number, Number]** 缩放范围
+
+### show
+
+设置图层可见
+
+### hide
+
+设置图层隐藏
+
+## MapboxVectorTileLayer
+
+**Extends Layer**
+
+为了满足基于矢量瓦片块的数据可视化、矢量瓦片边界展示等开发需求，通过 AMap.MapboxVectorTileLayer 插件提供了简易矢量瓦片图层</br>
+此图层可以使用标准的 MVT 瓦片服务作为数据源。</br>
+可以配合[GeoHub-数据中心][58]发布的矢量瓦片服务。
+注意：使用高德数据平台发布服务，由于服务 URL 地址是明文，建议自行做服务代理转发，防止服务 ID 和 Key 明文传输导致数据泄露。</br>
+[相关示例][59]
+
+### Parameters
+
+-   `opts` **MapboxVTLayerOptions** 图层初始化参数
+    -   `opts.zIndex` **Number** 图层的层级 (optional, default `80`)
+    -   `opts.opacity` **Number** 图层透明度 (optional, default `1`)
+    -   `opts.url` **String?** MVT 数据的链接地址
+    -   `opts.visible` **Boolean** 图层是否可见 (optional, default `true`)
+    -   `opts.zooms` **\[number, number]** 图层缩放等级范围 (optional, default `[2,22]`)
+    -   `opts.dataZooms` **\[number, number]** 瓦片数据等级范围，超过范围会使用最大/最小等级的数据 (optional, default `[2,18]`)
+    -   `opts.styles` **MapboxVTLayerStyle** 
+        -   `opts.styles.polygon` **PolygonStyle?** 面类型的样式
+            -   `opts.styles.polygon.sourceLayer` **String** 使用数据中的哪个图层，默认使用 default 图层 (optional, default `'default'`)
+            -   `opts.styles.polygon.color` **(String \| Function)?** 面填充颜色
+            -   `opts.styles.polygon.borderWidth` **(Number \| Function)?** 描边宽度
+            -   `opts.styles.polygon.dash` **(Array&lt;Number> | Function)?** 描边线的虚线配置，例如：[10,5,8,5]
+            -   `opts.styles.polygon.borderColor` **(String \| Function)?** 描边颜色
+            -   `opts.styles.polygon.injection` **Array&lt;Any>?** 其他属性值中对于函数形式的值，假如需要获取外部变量，要使用数组的形式传入，便于在函数内部访问外部变量。请看下面的示例。
+            -   `opts.styles.polygon.visible` **(Boolean \| Function)?** 是否显示
+        -   `opts.styles.line` **LineStyle?** 线类型数据的样式
+            -   `opts.styles.line.sourceLayer` **String** 使用数据中的哪个图层，默认使用 default 图层 (optional, default `'default'`)
+            -   `opts.styles.line.color` **(String \| Function)?** 线填充颜色
+            -   `opts.styles.line.lineWidth` **(Number \| Function)?** 宽度
+            -   `opts.styles.line.dash` **(String \| Function)?** 虚线配置，例如：[10,5,8,5]
+            -   `opts.styles.line.injection` **Array&lt;Any>?** 其他属性值中对于函数形式的值，假如需要获取外部变量，要使用数组的形式传入，便于在函数内部访问外部变量。请看下面的示例。
+            -   `opts.styles.line.visible` **(Boolean \| Function)?** 是否显示
+        -   `opts.styles.point` **PointStyle?** 点类型数据的样式
+            -   `opts.styles.point.sourceLayer` **String** 使用数据中的哪个图层，默认使用 default 图层 (optional, default `'default'`)
+            -   `opts.styles.point.radius` **(String \| Function)?** 圆点的半径，单位像素
+            -   `opts.styles.point.color` **(Number \| Function)?** 圆的填充颜色
+            -   `opts.styles.point.borderWidth` **(String \| Function)?** 描边的宽度
+            -   `opts.styles.point.borderColor` **(String \| Function)?** 描边的颜色
+            -   `opts.styles.point.injection` **Array&lt;Any>?** 其他属性值中对于函数形式的值，假如需要获取外部变量，要使用数组的形式传入，便于在函数内部访问外部变量。请看下面的示例。
+            -   `opts.styles.point.visible` **(Boolean \| Function)?** 是否显示
+        -   `opts.styles.polyhedron` **PolyhedronStyle?** 多面体类型的样式
+            -   `opts.styles.polyhedron.sourceLayer` **String** 使用数据中的哪个图层，默认使用 default 图层 (optional, default `'default'`)
+            -   `opts.styles.polyhedron.topColor` **(String \| Function)?** 顶面颜色
+            -   `opts.styles.polyhedron.sideColor` **(String \| Function)?** 侧面颜色
+            -   `opts.styles.polyhedron.texture` **(String \| Function)?** 侧面纹理，优先级高于侧面颜色
+            -   `opts.styles.polyhedron.injection` **Array&lt;Any>?** 其他属性值中对于函数形式的值，假如需要获取外部变量，要使用数组的形式传入，便于在函数内部访问外部变量。请看下面的示例。
+            -   `opts.styles.polyhedron.visible` **(Boolean \| Function)?** 是否显示
+
+### Examples
+
+```javascript
+var globalVar = ['这是', '一个', '外部', '变量'];
+var mvtl = new AMap.MapboxVectorTileLayer({
+     zIndex: 150,
+     opacity: 1,
+     // URL可以使用数据服务平台的服务，也可以使用自己发布的 MVT 数据服务
+     url: 'https://restapi.amap.com/rest/lbs/geohub/tiles/mvt?z=[z]&x=[x]&y=[y]&size=512&key=您申请的key值&id=数据服务ID',
+     dataZooms: [2, 18],
+     zooms: [2, 20],
+     tileSize: 256,
+     styles: {
+         point: {
+             sourceLayer: 'default',
+             visible: function (f, inject) {
+                 // 这里的 inject 参数就是一个数组，他的值就是 injection 字段的数组值：[visis]。
+                 return inject[0].indexOf('这是') > -1;
+             },
+             injection: [globalVar],
+             radius: function (props) {
+                 return Math.random() * 20 + 5;
+             },
+             color: 'red',
+             borderWidth: 20 || function (props) {
+                 return Math.random() * 5 + 2;
+             },
+             borderColor: 'rgba(255,255,255,1)',
+         },
+         polygon: {
+             sourceLayer: 'default',
+             color: function (props) {
+                 return 'rgba(0,0,0,1)';
+             },
+             dash: [10, 0, 10, 0],
+             borderColor: 'rgba(30,112,255,1)',
+             borderWidth: 5,
+         },
+         line: {
+             sourceLayer: 'default',
+             color: 'rgba(20,140,40,1)',
+             lineWidth: 5,
+             dash: [10, 0, 10, 0],
+         },
+         polyhedron: {
+             sourceLayer: 'default',
+             topColor: 'rgba(230,230,230,0.9)',
+             sideColor: 'rgba(240,240,240,0.9)',
+         },
+     }
+ });
+```
+
+### setStyles
+
+设置样式信息
+
+#### Parameters
+
+-   `styles` **MapboxVTLayerStyle** 样式信息
+
+### filterByRect
+
+获取矩形范围的要素
+
+#### Parameters
+
+-   `rect` **Polygon** 多边型，例如：\[[lng,lat],[lng,lat],[lng,lat],[lng,lat],[lng,lat]]
+-   `type` **String** 想要获取的要素类型，默认选择所有：all。可选值：all、point、polygon、line (optional, default `"all"`)
+
+Returns **Array&lt;Feature>** 
+
+### getStyles
+
+获取样式信息
+
+Returns **MapboxVTLayerStyle** 样式
+
+### on
+
+图层级别监听鼠标事件
+获取当前图层中鼠标位置的要素
+
+#### Parameters
+
+-   `type` **String** 监听事件类型，目前支持 click、mousemove
+-   `fn` **Function** 监听的回调函数，参数中的 features 是获取的鼠标位置的要素
+-   `option` **Object** 拾取参数，featType：代表需要拾取的要素类型，参考 filterByRect() 函数中的 type；buffer：5, 代表以鼠标为中心点，范围为 5 的方形区域为鼠标拾取范围。值越大，拾取的范围越大，建议使用默认值。
+
+### hide
+
+设置图层隐藏
+
+### hide
+
+设置图层隐藏
+
+### getOptions
+
+获取图层参数信息
+
+Returns **object** 图层参数信息
+
+### getzIndex
+
+获取图层层级
+
+Returns **Number** zIndex 图层层级
+
+### setzIndex
+
+设置图层层级，数字越大图层层级越高
+
+#### Parameters
+
+-   `zIndex` **Number** 图层层级值
+
+### getOpacity
+
+获取图层透明度
+
+Returns **Number** opacity 图层透明度
+
+### setOpacity
+
+设置图层透明度，范围 [0 ~ 1]
+
+#### Parameters
+
+-   `opacity` **Number** 图层透明度
+
+### getZooms
+
+获取该图层可显示的级别范围，默认取值范围为[2-20]
+
+Returns **\[number, number]** 缩放范围
+
+### setZooms
+
+获取该图层可显示的级别范围
+
+#### Parameters
+
+-   `zooms` **\[number, number]** 缩放范围
+
+### show
+
+设置图层可见