@supermapgis/iclient-ol 12.0.1-r → 12.1.2

package/index.js

@@ -1,4 +1,4 @@
-/* Copyright© 2000 - 2025 SuperMap Software Co.Ltd. All rights reserved.
+/* Copyright© 2000 - 2026 SuperMap Software Co.Ltd. All rights reserved.
  * This program are made available under the terms of the Apache License, Version 2.0
  * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
 export * from '@supermapgis/iclient-common/index.common';

package/mapping/BaiduMap.js

@@ -1,4 +1,4 @@
-/* Copyright© 2000 - 2025 SuperMap Software Co.Ltd. All rights reserved.
+/* Copyright© 2000 - 2026 SuperMap Software Co.Ltd. All rights reserved.
  * This program are made available under the terms of the Apache License, Version 2.0
  * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
 import TileImage from 'ol/source/TileImage';

package/mapping/ImageSuperMapRest.js

@@ -1,4 +1,4 @@
-/* Copyright© 2000 - 2025 SuperMap Software Co.Ltd. All rights reserved.
+/* Copyright© 2000 - 2026 SuperMap Software Co.Ltd. All rights reserved.
  * This program are made available under the terms of the Apache License, Version 2.0
  * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
 import { SecurityManager } from '@supermapgis/iclient-common/security/SecurityManager';
@@ -8,8 +8,6 @@ import { ServerGeometry } from '@supermapgis/iclient-common/iServer/ServerGeomet
 import { Util } from '../core/Util';
 import ImageSource from 'ol/source/Image';
 import ImageWrapper, { decode } from 'ol/Image';
-import Geometry from 'ol/geom/Geometry';
-import GeoJSON from 'ol/format/GeoJSON';
 import { containsExtent, getCenter, getHeight, getWidth, getForViewAndSize } from 'ol/extent';
 
 /**
@@ -41,6 +39,16 @@ import { containsExtent, getCenter, getHeight, getWidth, getForViewAndSize } fro
  * @param {string} [options.tileversion] - 切片版本名称，_cache 为 true 时有效。
  * @param {string} [options.tileProxy] - 代理地址。
  * @param {NDVIParameter|HillshadeParameter} [options.rasterfunction] - 栅格分析参数。
+ * @param {Object} [options.displayFilters] - 图层的显示过滤条件，利用该参数控制图层中可显示的要素。
+ * 参数结构：
+ * {
+ * "<layerName1>": "{displayFilter}",
+ * "<layerName2>": "{displayFilter}"
+ * }
+ * 其中，
+ * <layerName> 为地图中某图层名称，可从 layer 资源响应体参数 name 中获取；
+ * {displayFilter} 为属性过滤条件，仅对数据中存在的属性生效。
+ * 当前仅支持对工作空间数据源发布的地图进行属性过滤，支持对多图层同时过滤。
  * @param {string} [options.format = 'png'] - 瓦片表述类型，支持 "png" 、"webp"、"bmp" 、"jpg"、"gif" 等图片类型。
  * @deprecated {Function} [options.imageLoadFunction] - 加载图片的方法。默认为function(imageTile, src) {imageTile.getImage().src = src;};
  * @param {string} [options.ratio=1.5] - 	请求图片大小比例。 1 表示请求图片大小和地图视窗范围一致，2 表示请求图片大小是地图视窗范围的2倍，以此类推。
@@ -109,8 +117,8 @@ export class ImageSuperMapRest extends ImageSource {
     if (options.prjCoordSys) {
       params['prjCoordSys'] = JSON.stringify(options.prjCoordSys);
     }
-    if (options.clipRegionEnabled && options.clipRegion instanceof Geometry) {
-      options.clipRegion = Util.toSuperMapGeometry(new GeoJSON().writeGeometryObject(options.clipRegion));
+    if (options.clipRegionEnabled) {
+      options.clipRegion = Util.toSuperMapGeometry(options.clipRegion);
       options.clipRegion = CommonUtil.toJSON(ServerGeometry.fromGeometry(options.clipRegion));
       params['clipRegionEnabled'] = options.clipRegionEnabled;
       params['clipRegion'] = JSON.stringify(options.clipRegion);
@@ -126,6 +134,9 @@ export class ImageSuperMapRest extends ImageSource {
     if (options.rasterfunction) {
       params['rasterfunction'] = JSON.stringify(options.rasterfunction);
     }
+    if (options.displayFilters) {
+      params['displayFilters'] = JSON.stringify(options.displayFilters);
+    }
     //是否反走样地图,默认为false
     if (options.antialias !== undefined) {
       params['antialias'] = options.antialias;

package/mapping/ImageTileSuperMapRest.js

@@ -1,4 +1,4 @@
-/* Copyright© 2000 - 2025 SuperMap Software Co.Ltd. All rights reserved.
+/* Copyright© 2000 - 2026 SuperMap Software Co.Ltd. All rights reserved.
  * This program are made available under the terms of the Apache License, Version 2.0
  * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
 
@@ -21,7 +21,7 @@ import { Util as CommonUtil } from '@supermapgis/iclient-common/commontypes/Util
  * @param {Array.<string>} [options.names] 返回影像集合中指定名称影像的瓦片资源。影像名称包含文件后缀，如 S-60-45.tif。
  * @param {string} [options.format='png'] - 瓦片表述类型，瓦片格式目前支持 png、jpg 和 webp 三种格式。
  * @param {boolean} [options.transparent=true] - 瓦片是否透明。默认透明。
- * @param {boolean} [options.cacheEnabled=true] - 是否启用缓存。
+ * @param {boolean} [options.cacheEnabled=true] - 是否缓存到本地。为 true 时，访问发布的服务时就可以在本地生成地图瓦片，从而可以提高后续服务浏览访问的速度。
  * @param {string} [options.tileProxy] -  代理地址。
  * @param {string} [options.attribution='Map Data <span>© <a href='http://support.supermap.com.cn/product/iServer.aspx' title='SuperMap iServer' target='_blank'>SuperMap iServer</a></span>'] - 版权描述信息。
  * @extends {ol.source.XYZ}

package/mapping/InitMap.js

@@ -23,7 +23,7 @@ window.proj4 = proj4;
  * @param {Object} [options.layerOptions] - 图层配置，参数设置参考 {@link https://openlayers.org/en/v6.15.1/apidoc/module-ol_layer_Tile-TileLayer.html} ，未设置的情况下，默认使用 SuperMap iServer 服务参数进行设置。
  * @param {Object} [options.sourceOptions] - 数据源配置，参数设置参考 {@link TileSuperMapRest} ，未设置的情况下，默认使用 SuperMap iServer 服务参数进行设置。
  * @param {string} [options.proxy] - 服务代理地址。
- * @param {boolean} [options.withCredentials=false] - 请求是否携带 cookie。
+ * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。
  * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
  * @param {Object} [options.headers] - 请求头。
  * @returns {Object} 实例对象，对象包括地图实例，图层实例，数据源实例。

package/mapping/SuperMapCloud.js

@@ -1,4 +1,4 @@
-/* Copyright© 2000 - 2025 SuperMap Software Co.Ltd. All rights reserved.
+/* Copyright© 2000 - 2026 SuperMap Software Co.Ltd. All rights reserved.
  * This program are made available under the terms of the Apache License, Version 2.0
  * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
 

package/mapping/Tianditu.js

@@ -1,4 +1,4 @@
-/* Copyright© 2000 - 2025 SuperMap Software Co.Ltd. All rights reserved.
+/* Copyright© 2000 - 2026 SuperMap Software Co.Ltd. All rights reserved.
  * This program are made available under the terms of the Apache License, Version 2.0
  * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
 
@@ -12,8 +12,8 @@ import WMTSTileGrid from 'ol/tilegrid/WMTS';
  * @classdesc 天地图图层源。
  * @modulecategory Mapping
  * @param {Object} opt_options - 参数。
- * @param {string} [opt_options.url='http://t{0-7}.tianditu.gov.cn/{layer}_{proj}/wmts?'] - 服务地址。
- * @param {string} opt_options.key - 天地图服务密钥。详见{@link http://lbs.tianditu.gov.cn/server/MapService.html}
+ * @param {string} [opt_options.url='https://t{0-7}.tianditu.gov.cn/{layer}_{proj}/wmts?'] - 服务地址。
+ * @param {string} opt_options.key - 天地图服务密钥。详见{@link https://lbs.tianditu.gov.cn/server/MapService.html}
  * @param {string} [opt_options.layerType='vec'] - 图层类型。(vec:矢量图层，img:影像图层，ter:地形图层)
  * @param {string} [opt_options.attributions] - 版权描述信息。
  * @param {number} [opt_options.cacheSize = 2048] - 缓冲大小。
@@ -39,14 +39,14 @@ export class Tianditu extends WMTS {
       "img": 18
     }
     var options = opt_options || {};
-    var attributions = options.attributions || "Map Data <a href='http://www.tianditu.gov.cn' target='_blank'><img style='background-color:transparent;bottom:2px;opacity:1;' " +
-    "src='http://api.tianditu.gov.cn/img/map/logo.png' width='53px' height='22px' opacity='0'></a> with " +
+    var attributions = options.attributions || "Map Data <a href='https://www.tianditu.gov.cn' target='_blank'><img style='background-color:transparent;bottom:2px;opacity:1;' " +
+    "src='https://api.tianditu.gov.cn/img/map/logo.png' width='53px' height='22px' opacity='0'></a> with " +
     "<span>© SuperMap iClient</span>"
     options.layerType = options.layerType || "vec";
     options.layerType = options.isLabel ? layerLabelMap[options.layerType] : options.layerType;
     options.matrixSet = (options.projection === 'EPSG:4326' || options.projection === 'EPSG:4490') ? "c" : "w";
     if (!options.url && !options.urls) {
-      options.url = "http://t{0-7}.tianditu.gov.cn/{layer}_{proj}/wmts?"
+      options.url = "https://t{0-7}.tianditu.gov.cn/{layer}_{proj}/wmts?"
     }
     if (options.key) {
       options.url = `${options.url}tk=${options.key}`;

package/mapping/TileSuperMapRest.js

@@ -1,4 +1,4 @@
-/* Copyright© 2000 - 2025 SuperMap Software Co.Ltd. All rights reserved.
+/* Copyright© 2000 - 2026 SuperMap Software Co.Ltd. All rights reserved.
  * This program are made available under the terms of the Apache License, Version 2.0
  * which accompanies this distribution and is available at http://www.apache.org/licenses/LICENSE-2.0.html.*/
 import { SecurityManager } from '@supermapgis/iclient-common/security/SecurityManager';
@@ -7,20 +7,59 @@ import { Util as CommonUtil } from '@supermapgis/iclient-common/commontypes/Util
 import { ServerGeometry } from '@supermapgis/iclient-common/iServer/ServerGeometry';
 import { Util } from '../core/Util';
 import TileImage from 'ol/source/TileImage';
+import TileRange from 'ol/TileRange';
 import Geometry from 'ol/geom/Geometry';
-import GeoJSON from 'ol/format/GeoJSON';
 import * as olSize from 'ol/size';
 import * as olTilegrid from 'ol/tilegrid';
 import TileGrid from 'ol/tilegrid/TileGrid';
 
+function getOverflowTileCount(overflowTiles) {
+  return Math.max(0, Math.floor(Number(overflowTiles) || 0));
+}
+
+function wrapTileGridWithOverflow(tileGrid, overflowTiles) {
+  const overflowTileCount = getOverflowTileCount(overflowTiles);
+  if (!tileGrid || !overflowTileCount) {
+    return tileGrid;
+  }
+
+  const wrappedTileGrid = Object.create(tileGrid);
+  wrappedTileGrid.overflowTiles = overflowTileCount;
+  wrappedTileGrid.getTileRangeForExtentAndZ = function (extent, z, tempTileRange) {
+    const tileRange = tileGrid.getTileRangeForExtentAndZ(extent, z, tempTileRange);
+    if (!tileRange) {
+      return tileRange;
+    }
+    tileRange.minX -= overflowTileCount;
+    tileRange.maxX += overflowTileCount;
+    tileRange.minY -= overflowTileCount;
+    tileRange.maxY += overflowTileCount;
+    return tileRange;
+  };
+  wrappedTileGrid.getFullTileRange = function (z) {
+    const tileRange = tileGrid.getFullTileRange ? tileGrid.getFullTileRange(z) : null;
+    if (!tileRange) {
+      return tileRange;
+    }
+    return new TileRange(
+      tileRange.minX - overflowTileCount,
+      tileRange.maxX + overflowTileCount,
+      tileRange.minY - overflowTileCount,
+      tileRange.maxY + overflowTileCount
+    );
+  };
+  return wrappedTileGrid;
+}
+
 /**
  * @class TileSuperMapRest
  * @browsernamespace ol.source
  * @category iServer Map Tile
  * @modulecategory Mapping
- * @classdesc SuperMap iServer TileImage 图层源。
+ * @classdesc 以地图瓦片的方式展示 SuperMap iServer 的 REST 地图服务的地图。它通过调用 TileImage 接口获取地图瓦片。
  * @param {Object} options - 参数。
- * @param {string} options.url - 服务地址,例如: http://{ip}:{port}/iserver/services/map-world/rest/maps/World。
+ * @param {string} options.url - 服务地址，例如: http://{ip}:{port}/iserver/services/map-world/rest/maps/World。
+ * @param {Array.<string>} options.urls - 服务地址数组，例如: http://{ip}:{port}/iserver/services/map-world/rest/maps/World。
  * @param {ol.tilegrid.TileGrid} [options.tileGrid] - 瓦片网格对象。当不指定时，会通过 options.extent 或投影范围生成。
  * @param {boolean} [options.redirect = false] - 是否重定向。
  * @param {boolean} [options.transparent = true] - 瓦片是否透明。
@@ -35,181 +74,251 @@ import TileGrid from 'ol/tilegrid/TileGrid';
  * @param {string} [options.tileProxy] - 服务代理地址。
  * @param {string} [options.format = 'png'] - 瓦片表述类型，支持 "png" 、"webp"、"bmp" 、"jpg"、"gif" 等图片类型。
  * @param {(NDVIParameter|HillshadeParameter)} [options.rasterfunction] - 栅格分析参数。
- * @param {ChartSetting} [options.chartSetting] - 海图显示参数设置类，用于管理海图显示环境，包括海图的显示模式、显示类型名称、颜色模式、安全水深线等各种显示风格。
+ * @param {Object} [options.displayFilters] - 图层的显示过滤条件，利用该参数控制图层中可显示的要素。
+ * 参数结构：
+ * {
+ * "&lt;layerName1&gt;": "{displayFilter}",
+ * "&lt;layerName2&gt;": "{displayFilter}"
+ * }
+ * 其中，
+ * &lt;layerName&gt; 为地图中某图层名称，可从 layer 资源响应体参数 name 中获取；
+ * {displayFilter} 为属性过滤条件，仅对数据中存在的属性生效。
+ * 当前仅支持对工作空间数据源发布的地图进行属性过滤，支持对多图层同时过滤。
+ * @param {ChartSettingS57|ChartSettingS100} [options.chartSetting] - 海图显示参数设置类，用于管理海图显示环境，包括海图的显示模式、显示类型名称、颜色模式、安全水深线等各种显示风格。
+ * @param {number} [options.overflowTiles = 0] - 在当前视口范围外额外渲染的瓦片圈数。为 1 时上下左右各多请求一圈瓦片，可用于缓解符号在图层范围边缘被裁切的问题。
  * @extends {ol.source.TileImage}
  * @usage
  */
 export class TileSuperMapRest extends TileImage {
     constructor(options) {
-        options = options || {};
-        options.attributions =
-            options.attributions || "Map Data <span>© SuperMap iServer</span> with <span>© SuperMap iClient</span>";
+      options = options || {};
+      options.attributions =
+        options.attributions || 'Map Data <span>© SuperMap iServer</span> with <span>© SuperMap iClient</span>';
 
-        options.format = options.format ? options.format : 'png';
+      options.format = options.format ? options.format : 'png';
+      const tileGrid = wrapTileGridWithOverflow(options.tileGrid, options.overflowTiles);
 
-        super({ 
-            attributions: options.attributions,
-            cacheSize: options.cacheSize,
-            crossOrigin: options.crossOrigin,
-            logo: Util.getOlVersion() === '4' ? options.logo : null,
-            opaque: options.opaque,
-            projection: options.projection,
-            reprojectionErrorThreshold: options.reprojectionErrorThreshold,
-            state: options.state,
-            tileClass: options.tileClass,
-            tileGrid: options.tileGrid,
-            tileLoadFunction: options.tileLoadFunction,
-            tilePixelRatio: options.tilePixelRatio,
-            tileUrlFunction: tileUrlFunction,
-            wrapX: options.wrapX !== undefined ? options.wrapX : false,
-            cacheEnabled: options.cacheEnabled,
-            layersID: options.layersID
-        });
-        if (options.tileProxy) {
-            this.tileProxy = options.tileProxy;
+      super({
+        attributions: options.attributions,
+        cacheSize: options.cacheSize,
+        crossOrigin: options.crossOrigin,
+        logo: Util.getOlVersion() === '4' ? options.logo : null,
+        opaque: options.opaque,
+        projection: options.projection,
+        reprojectionErrorThreshold: options.reprojectionErrorThreshold,
+        state: options.state,
+        tileClass: options.tileClass,
+        tileGrid: tileGrid,
+        tileLoadFunction: options.tileLoadFunction,
+        tilePixelRatio: options.tilePixelRatio,
+        tileUrlFunction: options.tileUrlFunction || tileUrlFunction,
+        wrapX: options.wrapX !== undefined ? options.wrapX : false,
+        cacheEnabled: options.cacheEnabled,
+        layersID: options.layersID
+      });
+      if (options.tileProxy) {
+        this.tileProxy = options.tileProxy;
+      }
+      options.tileGrid = tileGrid;
+      this.options = options;
+      //当前切片在切片集中的index
+      this.tileSetsIndex = -1;
+      this.tempIndex = -1;
+      this._paramsVersion = 0;
+      this.dpi = this.options.dpi || 96;
+      if (options.url) {
+        this._urls = expandUrl(options.url);
+        if (this._urls.length === 1) {
+          this._tileImageUrl = CommonUtil.urlPathAppend(this._urls[0], 'tileImage.' + options.format);
         }
-        this.options = options;
-        this._url = options.url;
-        //当前切片在切片集中的index
-        this.tileSetsIndex = -1;
-        this.tempIndex = -1;
-        this.dpi = this.options.dpi || 96;
-        var me = this;
-        var layerUrl = CommonUtil.urlPathAppend(options.url, 'tileImage.' + options.format);
+      } else {
+        this._urls = options.urls;
+      }
+      var me = this;
 
-        /**
-         * @function TileSuperMapRest.prototype.getAllRequestParams
-         * @description 获取全部请求参数。
-         */
-        function getAllRequestParams() {
-            var me = this,
-                params = {};
+      /**
+       * @function TileSuperMapRest.prototype.getAllRequestParams
+       * @description 获取全部请求参数。
+       */
+      function getAllRequestParams(layerUrlPrefix) {
+        var me = this,
+          params = {};
 
-            params['redirect'] = options.redirect !== undefined ? options.redirect : false;
-            //切片是否透明
-            params['transparent'] = options.transparent !== undefined ? options.transparent : true;
-            params['cacheEnabled'] = !(options.cacheEnabled === false);
-            //存储一个cacheEnabled参数
-            me.cacheEnabled = params['cacheEnabled'];
-            params['_cache'] = params['cacheEnabled'];
+        params['redirect'] = options.redirect !== undefined ? options.redirect : false;
+        //切片是否透明
+        params['transparent'] = options.transparent !== undefined ? options.transparent : true;
+        params['cacheEnabled'] = !(options.cacheEnabled === false);
+        //存储一个cacheEnabled参数
+        me.cacheEnabled = params['cacheEnabled'];
+        params['_cache'] = params['cacheEnabled'];
 
-            //设置切片原点
-            if (this.origin) {
-                params['origin'] = JSON.stringify({
-                    x: this.origin[0],
-                    y: this.origin[1]
-                });
-            }
+        //设置切片原点
+        if (this.origin) {
+          params['origin'] = JSON.stringify({
+            x: this.origin[0],
+            y: this.origin[1]
+          });
+        }
 
-            if (options.prjCoordSys) {
-                params['prjCoordSys'] = JSON.stringify(options.prjCoordSys);
-            }
+        if (options.prjCoordSys) {
+          params['prjCoordSys'] = JSON.stringify(options.prjCoordSys);
+        }
 
-            if (options.layersID) {
-                params['layersID'] = options.layersID.toString();
-            }
+        if (options.layersID) {
+          params['layersID'] = options.layersID.toString();
+        }
 
-            if (options.clipRegion instanceof Geometry) {
-                options.clipRegionEnabled = true;
-                options.clipRegion = Util.toSuperMapGeometry(new GeoJSON().writeGeometryObject(options.clipRegion));
-                options.clipRegion = CommonUtil.toJSON(ServerGeometry.fromGeometry(options.clipRegion));
-                params['clipRegionEnabled'] = options.clipRegionEnabled;
-                params['clipRegion'] = JSON.stringify(options.clipRegion);
-            }
+        if (options.clipRegion instanceof Geometry) {
+          options.clipRegionEnabled = true;
+          options.clipRegion = Util.toSuperMapGeometry(options.clipRegion);
+          options.clipRegion = CommonUtil.toJSON(ServerGeometry.fromGeometry(options.clipRegion));
+          params['clipRegionEnabled'] = options.clipRegionEnabled;
+          params['clipRegion'] = JSON.stringify(options.clipRegion);
+        }
 
-            if (!options.overlapDisplayed) {
-                params['overlapDisplayed'] = false;
-                if (options.overlapDisplayedOptions) {
-                    params['overlapDisplayedOptions'] = me.overlapDisplayedOptions.toString();
-                }
-            } else {
-                params['overlapDisplayed'] = true;
-            }
+        if (!options.overlapDisplayed) {
+          params['overlapDisplayed'] = false;
+          if (options.overlapDisplayedOptions) {
+            params['overlapDisplayedOptions'] = me.overlapDisplayedOptions.toString();
+          }
+        } else {
+          params['overlapDisplayed'] = true;
+        }
 
-            if (params.cacheEnabled && options.tileversion) {
-                params['tileversion'] = options.tileversion.toString();
-            }
-            if (options.rasterfunction) {
-                params['rasterfunction'] = JSON.stringify(options.rasterfunction);
-            }
-            if (options.chartSetting) {
-                params["chartSetting"] = JSON.stringify(options.chartSetting);
-            }
+        if (params.cacheEnabled && options.tileversion) {
+          params['tileversion'] = options.tileversion.toString();
+        }
+        if (options.rasterfunction) {
+          params['rasterfunction'] = JSON.stringify(options.rasterfunction);
+        }
+        if (options.displayFilters) {
+          params['displayFilters'] = JSON.stringify(options.displayFilters);
+        }
+        if (options.chartSetting) {
+          params['chartSetting'] = JSON.stringify(options.chartSetting);
+        }
+        const credential = SecurityManager.getCredential(layerUrlPrefix);
+        if (credential) {
+          params[credential.name] = credential.value;
+        }
+        return params;
+      }
 
-            return params;
+      /**
+       * @function TileSuperMapRest.prototype.getFullRequestUrl
+       * @description 获取完整的请求地址。
+       */
+      function getFullRequestUrl(tileCoord) {
+        //非urls的情况，尽可能复用url，减少拼接字符串
+        if (this._tileImageUrl) {
+          if (this._paramsChanged) {
+            this._tileImageWithParamsUrl = createLayerUrl.call(this, this._tileImageUrl);
+            this._paramsChanged = false;
+          }
+          return this._tileImageWithParamsUrl || createLayerUrl.call(this, this._tileImageUrl);
         }
 
-        /**
-         * @function TileSuperMapRest.prototype.getFullRequestUrl
-         * @description 获取完整的请求地址。
-         */
-        function getFullRequestUrl() {
-            if (this._paramsChanged) {
-                this._layerUrl = createLayerUrl.call(this);
-                this._paramsChanged = false;
-            }
-            return this._layerUrl || createLayerUrl.call(this);
+        const layerUrlPrefix = CommonUtil.urlPathAppend(
+          random(tileCoord, this._urls),
+          `tileImage.${this.options.format}`
+        );
+        if (this._paramsChanged) {
+          this._paramsChanged = false;
         }
+        return createLayerUrl.call(this, layerUrlPrefix);
+      }
 
-        /**
-         * @function TileSuperMapRest.prototype.createLayerUrl
-         * @description 获取新建图层地址。
-         */
-        function createLayerUrl() {
-            this.requestParams = this.requestParams || getAllRequestParams.call(this);
-            this._layerUrl = CommonUtil.urlAppend(layerUrl, CommonUtil.getParameterString(this.requestParams));
-            //为url添加安全认证信息片段
-            this._layerUrl = SecurityManager.appendCredential(this._layerUrl);
-            return this._layerUrl;
+      /**
+       * @function TileSuperMapRest.prototype.createLayerUrl
+       * @description 获取新建图层地址。
+       */
+      function createLayerUrl(layerUrlPrefix) {
+        this.requestParams = this.requestParams || getAllRequestParams.call(this, layerUrlPrefix);
+        return CommonUtil.urlAppend(layerUrlPrefix, CommonUtil.getParameterString(this.requestParams));
+      }
+      /**
+       * Copyright 2005-present, OpenLayers Contributors
+       */
+      function expandUrl(url) {
+        const urls = [];
+        let match = /\{([a-z])-([a-z])\}/.exec(url);
+        if (match) {
+          // char range
+          const startCharCode = match[1].charCodeAt(0);
+          const stopCharCode = match[2].charCodeAt(0);
+          let charCode;
+          for (charCode = startCharCode; charCode <= stopCharCode; ++charCode) {
+            urls.push(url.replace(match[0], String.fromCharCode(charCode)));
+          }
+          return urls;
         }
+        match = /\{(\d+)-(\d+)\}/.exec(url);
+        if (match) {
+          // number range
+          const stop = parseInt(match[2], 10);
+          for (let i = parseInt(match[1], 10); i <= stop; i++) {
+            urls.push(url.replace(match[0], i.toString()));
+          }
+          return urls;
+        }
+        urls.push(url);
+        return urls;
+      }
+      function random(tileCoord, urls) {
+        const a = (tileCoord[1] << tileCoord[0]) + tileCoord[2];
+        const b = urls.length;
+        const r = a % b;
+        return urls[r * b < 0 ? r + b : r];
+      }
 
-        function tileUrlFunction(tileCoord, pixelRatio, projection) {
-            if (!me.tileGrid) {
-                if (options.extent) {
-                    me.tileGrid = TileSuperMapRest.createTileGrid(options.extent);
-                    if (me.resolutions) {
-                        me.tileGrid.resolutions = me.resolutions;
-                    }
-                } else {
-                    if (projection.getCode() === 'EPSG:3857') {
-                        me.tileGrid = TileSuperMapRest.createTileGrid([
-                            -20037508.3427892,
-                            -20037508.3427892,
-                            20037508.3427892,
-                            20037508.3427892
-                        ]);
-                        me.extent = [-20037508.3427892, -20037508.3427892, 20037508.3427892, 20037508.3427892];
-                    }
-                    if (projection.getCode() === 'EPSG:4326') {
-                        me.tileGrid = TileSuperMapRest.createTileGrid([-180, -90, 180, 90]);
-                        me.extent = [-180, -90, 180, 90];
-                    }
-                }
+      function tileUrlFunction(tileCoord, pixelRatio, projection) {
+        if (!me.tileGrid) {
+          if (options.extent) {
+            me.tileGrid = wrapTileGridWithOverflow(TileSuperMapRest.createTileGrid(options.extent), options.overflowTiles);
+            if (me.resolutions) {
+              me.tileGrid.resolutions = me.resolutions;
             }
-            me.origin = me.tileGrid.getOrigin(0);
-            var z = tileCoord[0];
-            var x = tileCoord[1];
-            var y = ['4', '5'].indexOf(Util.getOlVersion()) > -1 ? -tileCoord[2] - 1 : tileCoord[2];
-            var resolution = me.tileGrid.getResolution(z);
-            var dpi = me.dpi || 96;
-            var unit = projection.getUnits() || Unit.DEGREE;
-            var scale = Util.resolutionToScale(resolution, dpi, unit);
-            var tileSize = olSize.toSize(me.tileGrid.getTileSize(z, me.tmpSize));
-            var layerUrl = getFullRequestUrl.call(me);
-            var url =
-                layerUrl +
-                encodeURI(
-                    '&x=' + x + '&y=' + y + '&width=' + tileSize[0] + '&height=' + tileSize[1] + '&scale=' + scale
-                );
-            //支持代理
-            if (me.tileProxy) {
-                url = me.tileProxy + encodeURIComponent(url);
+          } else {
+            if (projection.getCode() === 'EPSG:3857') {
+              me.tileGrid = wrapTileGridWithOverflow(
+                TileSuperMapRest.createTileGrid([
+                  -20037508.3427892, -20037508.3427892, 20037508.3427892, 20037508.3427892
+                ]),
+                options.overflowTiles
+              );
+              me.extent = [-20037508.3427892, -20037508.3427892, 20037508.3427892, 20037508.3427892];
             }
-            if (!me.cacheEnabled) {
-                url += '&_t=' + new Date().getTime();
+            if (projection.getCode() === 'EPSG:4326') {
+              me.tileGrid = wrapTileGridWithOverflow(
+                TileSuperMapRest.createTileGrid([-180, -90, 180, 90]),
+                options.overflowTiles
+              );
+              me.extent = [-180, -90, 180, 90];
             }
-            return url;
+          }
+        }
+        me.origin = me.tileGrid.getOrigin(0);
+        var z = tileCoord[0];
+        var x = tileCoord[1];
+        var y = ['4', '5'].indexOf(Util.getOlVersion()) > -1 ? -tileCoord[2] - 1 : tileCoord[2];
+        var resolution = me.tileGrid.getResolution(z);
+        var dpi = me.dpi || 96;
+        var unit = projection.getUnits() || Unit.DEGREE;
+        var scale = Util.resolutionToScale(resolution, dpi, unit);
+        var tileSize = olSize.toSize(me.tileGrid.getTileSize(z, me.tmpSize));
+        var layerUrl = getFullRequestUrl.call(me, tileCoord);
+        var url =
+          layerUrl +
+          encodeURI('&x=' + x + '&y=' + y + '&width=' + tileSize[0] + '&height=' + tileSize[1] + '&scale=' + scale);
+        //支持代理
+        if (me.tileProxy) {
+          url = me.tileProxy + encodeURIComponent(url);
+        }
+        if (!me.cacheEnabled) {
+          url += '&_t=' + new Date().getTime();
         }
+        return url;
+      }
     }
 
     /**
@@ -367,8 +476,12 @@ export class TileSuperMapRest extends TileImage {
      * @version 11.2.0
      */
     updateParams(params) {
-      Object.assign(this.requestParams, params);
+      Object.assign(this.options, params);
+      if (this.requestParams) {
+        Object.assign(this.requestParams, params);
+      }
       this._paramsChanged = true;
+      this.setKey(String(++this._paramsVersion));
       this.refresh();
     }
 }