@supermapgis/iclient-ol 12.1.0-r → 12.1.2

package/mapping/ImageSuperMapRest.js

@@ -39,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倍，以此类推。
@@ -124,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

@@ -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/TileSuperMapRest.js

@@ -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 * 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 {Array.<string>} options.urls - 服务地址数组,例如: 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,7 +74,18 @@ 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 {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
  */
@@ -46,6 +96,7 @@ export class TileSuperMapRest extends TileImage {
         options.attributions || 'Map Data <span>© SuperMap iServer</span> with <span>© SuperMap iClient</span>';
 
       options.format = options.format ? options.format : 'png';
+      const tileGrid = wrapTileGridWithOverflow(options.tileGrid, options.overflowTiles);
 
       super({
         attributions: options.attributions,
@@ -57,7 +108,7 @@ export class TileSuperMapRest extends TileImage {
         reprojectionErrorThreshold: options.reprojectionErrorThreshold,
         state: options.state,
         tileClass: options.tileClass,
-        tileGrid: options.tileGrid,
+        tileGrid: tileGrid,
         tileLoadFunction: options.tileLoadFunction,
         tilePixelRatio: options.tilePixelRatio,
         tileUrlFunction: options.tileUrlFunction || tileUrlFunction,
@@ -68,10 +119,12 @@ export class TileSuperMapRest extends TileImage {
       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);
@@ -138,6 +191,9 @@ export class TileSuperMapRest extends TileImage {
         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);
         }
@@ -218,19 +274,25 @@ export class TileSuperMapRest extends TileImage {
       function tileUrlFunction(tileCoord, pixelRatio, projection) {
         if (!me.tileGrid) {
           if (options.extent) {
-            me.tileGrid = TileSuperMapRest.createTileGrid(options.extent);
+            me.tileGrid = wrapTileGridWithOverflow(TileSuperMapRest.createTileGrid(options.extent), options.overflowTiles);
             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.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 (projection.getCode() === 'EPSG:4326') {
-              me.tileGrid = TileSuperMapRest.createTileGrid([-180, -90, 180, 90]);
+              me.tileGrid = wrapTileGridWithOverflow(
+                TileSuperMapRest.createTileGrid([-180, -90, 180, 90]),
+                options.overflowTiles
+              );
               me.extent = [-180, -90, 180, 90];
             }
           }
@@ -414,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();
     }
 }

package/mapping/WebMap.js

@@ -111,6 +111,7 @@ const WMTS_ARRAY_NODE_PATHS = [
  * @param {function} [options.mapSetting.controls] - 地图的控件。
  * @param {function} [options.mapSetting.interactions] - 地图控制的参数。
  * @param {number} [options.restDataSingleRequestCount=1000] - 自定义 restData 分批请求，单次请求数量。
+ * @param {number} [options.overflowTiles=0] - RestMap 栅格图层瓦片范围向外扩大的圈数。
  * @extends {ol.Observable}
  * @usage
  */
@@ -142,6 +143,7 @@ export class WebMap extends Observable {
     this.webMap = options.webMap;
     this.tileFormat = options.tileFormat && options.tileFormat.toLowerCase();
     this.restDataSingleRequestCount = options.restDataSingleRequestCount || 1000;
+    this.overflowTiles = typeof options.overflowTiles === 'undefined' ? 1 : options.overflowTiles;
     this.tileRequestParameters = options.tileRequestParameters;
     this.createMap(options.mapSetting);
     if (this.webMap) {
@@ -1314,6 +1316,10 @@ export class WebMap extends Observable {
     ) {
       options.tileProxy = this.server + 'apps/viewer/getUrlResource.png?url=';
     }
+    if(this.overflowTiles) {
+      options.overflowTiles = this.overflowTiles;
+      layerInfo.restMapExtentExpanded = true;
+    }
     let source = new TileSuperMapRest(options);
     SecurityManager[`register${keyfix}`](layerInfo.url);
     return source;
@@ -1401,7 +1407,11 @@ export class WebMap extends Observable {
   getLayerOtherOptions(layerInfo) {
     const { layerType, extent, minZoom, maxZoom } = layerInfo;
     const extentVal = layerType === 'ZXY_TILE' ? this._getZXYTileMapBounds(layerInfo) : extent;
-    const options = { extent: extentVal };
+    const options = {};
+    if (!layerInfo.restMapExtentExpanded) {
+      // 扩大 RestMap 栅格图层的 tileGrid 后，不再向图层传递 extent
+      options.extent = extentVal;
+    }
     if (typeof minZoom === 'number' && minZoom !== 0) {
       options.minZoom = minZoom - 1;
     }

package/overlay/DataFlow.js

@@ -13,9 +13,9 @@ import GeoJSON from 'ol/format/GeoJSON';
  * @param {Object} opt_options - 参数。
  * @param {string} opt_options.ws - SuperMap iServer 数据流服务地址，例如：http://localhost:8090/iserver/services/dataflowTest/dataflow。
  * @param {string} [opt_options.idField = 'id'] - 要素属性中表示唯一标识的字段。
- * @param {GeoJSONObject} [opt_options.geometry] - 指定几何范围，只有在该范围内的要素才能被订阅。
+ * @param {GeoJSONObject} [opt_options.geometry] - 空间范围，只有在该范围内的要素才能被接收。
  * @param {Object} [opt_options.prjCoordSys] - 请求的地图的坐标参考系统。当此参数设置的坐标系统不同于地图的原有坐标系统时，系统会进行动态投影，并返回动态投影后的地图瓦片。例如：{"epsgCode":3857}。
- * @param {Object} [opt_options.excludeField] - 排除字段。
+ * @param {Object} [opt_options.excludeField] - 过滤字段。传入此参数，接收到的信息将不包含过滤掉的字段。
  * @extends {ol.source.Vector}
  * @example
  * var source = new DataFlow({
@@ -69,8 +69,8 @@ export class DataFlow extends VectorSource {
 
     /**
      * @function DataFlow.prototype.setExcludeField
-     * @description 设置唯一字段。
-     * @param {Object} excludeField - 排除字段。
+     * @description 设置过滤字段。传入此参数，接收到的信息将不包含过滤掉的字段。
+     * @param {Object} excludeField - 过滤字段。
      */
     setExcludeField(excludeField) {
         this.dataService.setExcludeField(excludeField);

package/overlay/theme/Theme.js

@@ -19,7 +19,7 @@ import GeoJSON from 'ol/format/GeoJSON';
  * @class Theme
  * @browsernamespace ol.source
  * @category Visualization Theme
- * @classdesc 专题图基类。地图学中将突出而深入地表示一种或几种要素或现象，即集中表示一个主题内容的地图称为专题地图。
+ * @classdesc 专题图基类。地图学中将突出而深入地表示一种或几种要素或现象，即集中表示一个主题内容的地图称为专题地图。<br>
  * 在 SuperMap 中，专题图是地图图层的符号化显示，即用各种图形渲染风格（大小，颜色，线型，填充等）来图形化地表现专题要素的某方面特征。
  * 调用建议：使用其子类实现该类。
  * @modulecategory Overlay

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@supermapgis/iclient-ol",
   "description": "",
-  "version": "12.1.0-r",
+  "version": "12.1.2",
   "keywords": [
     "SuperMap",
     "OpenLayers"
@@ -15,7 +15,7 @@
   "author": "SuperMap",
   "license": "Apache-2.0",
   "dependencies": {
-    "@supermapgis/iclient-common": "12.1.0-r",
+    "@supermapgis/iclient-common": "12.1.2",
     "@supermapgis/tile-decryptor": "^1.0.0",
     "@turf/turf": "7.2.0",
     "mapv": "2.0.62",

package/services/AddressMatchService.js

@@ -14,7 +14,7 @@ import { Util as CommonUtil } from '@supermapgis/iclient-common/commontypes/Util
  *      .code(function(result){
  *          //doSomething
  *      })
- * @param {string} url - 服务地址。
+ * @param {string} url - 地址匹配服务地址，如 http://{ip}:{port}/iserver/services/addressmatch-Address/restjsr/v1/address 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。

package/services/ChartService.js

@@ -22,7 +22,7 @@ import { ChartService as CommonChartService } from '@supermapgis/iclient-common/
  * }).queryChart(param,function(result){
  *     //doSomething
  * })
- * @param {string} url - 服务地址。
+ * @param {string} url - 地图服务地址，如 http://{ip}:{port}/iserver/services/map-chart/rest/maps/GB4X0000_52000 。
  * @param {string} [dataUrl] - 数据服务地址。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。

package/services/DataFlowService.js

@@ -15,14 +15,14 @@ import { DataFlowService as DataFlow } from '@supermapgis/iclient-common/iServer
  *      new DataFlowService(url).queryChart(param,function(result){
  *          //doSomething
  *      })
- * @param {string} url - 服务地址。
+ * @param {string} url - 数据流服务地址，如 ws://{ip}:{port}/iserver/services/dataflowTest/dataflow 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。
  * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
  * @param {Object} [options.headers] - 请求头。
- * @param {GeoJSONObject} [options.geometry] - 指定几何范围，只有在该范围内的要素才能被订阅。
- * @param {Object} [options.excludeField] - 排除字段。
+ * @param {GeoJSONObject} [options.geometry] - 空间范围，只有在该范围内的要素才能被接收。
+ * @param {Object} [options.excludeField] - 过滤字段。传入此参数，接收到的信息将不包含过滤掉的字段。
  * @usage
  */
 export class DataFlowService extends ServiceBase {
@@ -77,8 +77,8 @@ export class DataFlowService extends ServiceBase {
 
     /**
      * @function DataFlowService.prototype.setExcludeField
-     * @description 设置排除字段。
-     * @param {Object} excludeField - 排除字段。
+     * @description 设置过滤字段。传入此参数，接收到的信息将不包含过滤掉的字段。
+     * @param {Object} excludeField - 过滤字段。
      */
     setExcludeField(excludeField) {
         this.dataFlow.setExcludeField(excludeField);
@@ -88,8 +88,8 @@ export class DataFlowService extends ServiceBase {
 
     /**
      * @function DataFlowService.prototype.setGeometry
-     * @description 设置添加的几何要素数据。
-     * @param {GeoJSONObject} geometry - 指定几何范围，只有在该范围内的要素才能被订阅。
+     * @description 设置空间范围，只有在该范围内的要素才能被接收。
+     * @param {GeoJSONObject} geometry - 空间范围。
      */
     setGeometry(geometry) {
         this.dataFlow.setGeometry(geometry);

package/services/DatasetService.js

@@ -11,7 +11,7 @@ import { UpdateDatasetParameters } from '@supermapgis/iclient-common/iServer/Upd
  * @category  iServer Data Dataset
  * @classdesc 数据集信息服务类。提供方法：查询数据集集合、查询指定数据集信息，在指定数据源下新增、修改、删除数据集等。
  * @modulecategory Services
- * @param {string} url - 服务地址。
+ * @param {string} url - 数据服务地址，如 http://{ip}:{port}/iserver/services/data-world/rest/data 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。
@@ -34,7 +34,7 @@ export class DatasetService extends ServiceBase {
 
     /**
      * @function DatasetService.prototype.getDatasets
-     * @description 数据集查询服务。
+     * @description 根据数据源名称查询该数据源下所有数据集的信息。
      * @param {string} datasourceName - 数据源名称。
      * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
      * @returns {Promise} Promise 对象。
@@ -48,7 +48,7 @@ export class DatasetService extends ServiceBase {
 
     /**
      * @function DatasetService.prototype.getDataset
-     * @description 数据集查询服务。
+     * @description 根据数据源名称、数据集名称查询该数据集的信息
      * @param {string} datasourceName - 数据源名称。
      * @param {string} datasetName - 数据集名称。
      * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。

package/services/DatasourceService.js

@@ -10,7 +10,7 @@ import { SetDatasourceParameters } from '@supermapgis/iclient-common/iServer/Set
  * @category  iServer Data Datasource
  * @classdesc 数据源服务类。提供方法：查询数据源集合、查询指定数据源信息、设置指定数据源信息。可以获取的数据源信息包括数据源名称、数据源描述、引擎类型、距离单位、坐标单位、投影信息等。
  * @modulecategory Services
- * @param {string} url - 服务地址。
+ * @param {string} url - 数据服务地址，如 http://{ip}:{port}/iserver/services/data-world/rest/data 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。
@@ -33,7 +33,7 @@ export class DatasourceService extends ServiceBase {
 
     /**
      * @function DatasourceService.prototype.getDatasources
-     * @description 数据源集合查询服务。
+     * @description 获取当前服务下所有数据源信息。
      * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
      */
     getDatasources(callback) {
@@ -42,7 +42,7 @@ export class DatasourceService extends ServiceBase {
 
     /**
      * @function DatasourceService.prototype.getDatasource
-     * @description 数据源信息查询服务。
+     * @description 根据数据源名称获取指定数据源的信息。
      * @param {string} datasourceName - 数据源名称。
      * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
      * @returns {Promise} Promise 对象。

package/services/FeatureService.js

@@ -13,13 +13,13 @@ import Polygon from 'ol/geom/Polygon';
  * @class FeatureService
  * @constructs FeatureService
  * @category  iServer Data Feature
- * @classdesc 要素数据集类。提供：ID 查询，范围查询，SQL查询，几何查询，缓冲区查询，地物编辑，要素附件查询、编辑等方法。
+ * @classdesc 要素数据集类。提供：ID 查询，范围查询，SQL查询，空间查询，缓冲区查询，地物编辑，要素附件查询、编辑等方法。
  * @modulecategory Services
  * @example
  *      new FeatureService(url).getFeaturesByIDs(param,function(result){
  *          //doSomething
  *      })
- * @param {string} url - 服务地址。
+ * @param {string} url - 数据服务地址，如 http://{ip}:{port}/iserver/services/data-world/rest/data 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。
@@ -88,8 +88,8 @@ export class FeatureService extends ServiceBase {
 
   /**
    * @function FeatureService.prototype.getFeaturesByGeometry
-   * @description 数据集几何查询服务类。
-   * @param {GetFeaturesByGeometryParameters} params - 数据集几何查询参数类。
+   * @description 数据集空间查询服务类。
+   * @param {GetFeaturesByGeometryParameters} params - 数据集空间查询参数类。
    * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
    * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的数据格式。
    * @returns {Promise} Promise 对象。

package/services/FieldService.js

@@ -13,7 +13,7 @@ import { FieldService as CommonFieldService } from '@supermapgis/iclient-common/
  *           //doSomething
  *      });
  * @modulecategory Services
- * @param {string} url - 服务地址。
+ * @param {string} url - 数据服务地址，如 http://{ip}:{port}/iserver/services/data-world/rest/data 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。

package/services/GeoprocessingService.js

@@ -26,7 +26,7 @@ import { ServiceBase } from './ServiceBase';
        console.log(serverResult);
      });
    })
- * @param {string} url - 服务地址。
+ * @param {string} url - 处理自动化服务地址，如 http://{ip}:{port}/iserver/services/geoprocessing/restjsr/gp/v2 。
  * @param {Object} options - 参数。
  * @usage
  */

package/services/GridCellInfosService.js

@@ -16,8 +16,7 @@ import { GetGridCellInfosService } from '@supermapgis/iclient-common/iServer/Get
  *      .getGridCellInfos(param,function(result){
  *           //doSomething
  *      })
- * @param {string} url - 服务地址。请求地图服务，URL 应为：
- *                       http://{服务器地址}:{服务端口号}/iserver/services/{地图服务名}/rest/maps/{地图名}/tempLayersSet/{tempLayerID}/Rivers@World@@World。
+ * @param {string} url - 数据服务地址，如 http://{ip}:{port}/iserver/services/data-world/rest/data 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。

package/services/ImageCollectionService.js

@@ -16,7 +16,7 @@ import CommonMatchImageCollectionService from '@supermapgis/iclient-common/iServ
  *      new ImageCollectionService(url,options).getLegend(queryParams,function(result){
  *          //doSomething
  *      })
- * @param {string} url - 服务地址。例如: http://{ip}:{port}/iserver/{imageservice-imageserviceName}/restjsr/
+ * @param {string} url - 影像服务地址。例如: http://{ip}:{port}/iserver/{imageservice-imageserviceName}/restjsr/
  * @param {Object} options - 参数。
  * @param {string} options.collectionId 影像集合（Collection）的 ID，在一个影像服务中唯一标识影像集合。
  * @param {string} [options.proxy] - 服务代理地址。

package/services/ImageService.js

@@ -17,7 +17,7 @@ import CommonMatchImageService from '@supermapgis/iclient-common/iServer/ImageSe
  *      ImageService(url,options).getCollections(function(result){
  *          //doSomething
  *      })
- * @param {string} url - 服务地址。例如: http://{ip}:{port}/iserver/{imageservice-imageserviceName}/restjsr/
+ * @param {string} url - 影像服务地址。例如: http://{ip}:{port}/iserver/{imageservice-imageserviceName}/restjsr/
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。

package/services/KnowledgeGraphService.js

@@ -16,7 +16,7 @@ import { KnowledgeGraphService as CommonKnowledgeGraphService } from '@supermapg
  *     //doSomething
  * })
  * @extends {ServiceBase}
- * @param {string} url - 服务地址。
+ * @param {string} url - 知识图谱服务地址，如 http://{ip}:{port}/iserver/services/knowledgeGraph-test/restjsr/graph 。
  * @param {Object} options -参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。

package/services/LayerInfoService.js

@@ -13,7 +13,7 @@ import { LayerInfoService as CommonLayerInfoService } from '@supermapgis/iclient
  *      new LayerInfoService(url).getLayersInfo(function(result){
  *           //doSomething
  *      })
- * @param {string} url - 服务地址。请求地图服务，URL 应为：
+ * @param {string} url - 地图服务地址。请求地图服务，URL 应为：
  *                       http://{服务器地址}:{服务端口号}/iserver/services/{地图服务名}/rest/maps/{地图名}/tempLayersSet/{tempLayerID}/Rivers@World@@World"。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。

package/services/MapService.js

@@ -11,7 +11,7 @@ import { TilesetsService } from '@supermapgis/iclient-common/iServer/TilesetsSer
  * @classdesc 地图信息服务类。通过该类可以获得地图的基本信息、投影信息、切片列表信息等等。
  * @modulecategory Services
  * @extends {ServiceBase}
- * @param {string} url - 服务地址。
+ * @param {string} url - 地图服务地址，如 http://{ip}:{port}/iserver/services/map-world/rest/maps/World 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。

package/services/MeasureService.js

@@ -11,7 +11,7 @@ import { MeasureService as CommonMeasureService } from '@supermapgis/iclient-com
  * @classdesc 量算服务类。提供方法：面积量算、距离量算等。
  * @modulecategory Services
  * @extends {ServiceBase}
- * @param {string} url -  服务地址。如：http://localhost:8090/iserver/services/map-world/rest/maps/World+Map 。
+ * @param {string} url -  地图服务地址。如：http://localhost:8090/iserver/services/map-world/rest/maps/World+Map 。
  * @param {Object} options -  参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。

package/services/NetworkAnalyst3DService.js

@@ -13,9 +13,7 @@ import { NetworkAnalyst3DService as CommonNetworkAnalyst3DService } from '@super
  *      new NetworkAnalyst3DService(url).sinksFacilityAnalyst(params,function(result){
  *           //doSomething
  *      })
- * @param {string} url - 网络分析服务地址。请求网络分析服务，URL 应为：
- *                       http://{服务器地址}:{服务端口号}/iserver/services/{网络分析服务名}/rest/networkanalyst/{网络数据集@数据源}；
- *                       例如:"http://localhost:8090/iserver/services/components-rest/rest/networkanalyst/RoadNet@Changchun"。
+ * @param {string} url - 三维网络分析服务地址。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。

package/services/NetworkAnalystService.js

@@ -18,9 +18,7 @@ import Point from 'ol/geom/Point';
  *      new NetworkAnalystService(url).findPath(params,function(result){
  *           //doSomething
  *      })
- * @param {string} url - 网络分析服务地址。请求网络分析服务，URL 应为:
- *                       http://{服务器地址}:{服务端口号}/iserver/services/{网络分析服务名}/rest/networkanalyst/{网络数据集@数据源}；<br>
- *                       例如: "http://localhost:8090/iserver/services/test/rest/networkanalyst/WaterNet@FacilityNet"。
+ * @param {string} url - 网络分析服务地址，如 http://{ip}:{port}/iserver/services/{网络分析服务名}/rest/networkanalyst/{网络数据集@数据源}。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。
@@ -78,7 +76,7 @@ export class NetworkAnalystService extends ServiceBase {
     /**
      * @function NetworkAnalystService.prototype.traceAnalyst
      * @description 上游/下游 追踪分析服务。<br>
-     * 查找给定弧段或节点的上游/下游弧段和结点。
+     * 查找给定弧段或结点的上游/下游弧段和结点。
      * @version 11.1.1
      * @param {TraceAnalystParameters} params - 上游/下游 追踪分析服务参数类。
      * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。

package/services/ProcessingService.js

@@ -17,7 +17,7 @@ import {ServiceBase} from './ServiceBase';
  *      new ProcessingService(url,options).getKernelDensityJobs(function(result){
  *          //doSomething
  *      })
- * @param {string} url - 服务地址。
+ * @param {string} url - 分布式分析服务地址，如 http://{ip}:{port}/iserver/services/distributedanalyst/rest/v1/jobs 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。

package/services/QueryService.js

@@ -12,10 +12,10 @@ import Point from 'ol/geom/Point';
  * @class QueryService
  * @category  iServer Map QueryResults
  * @classdesc 地图查询服务类。
- *            提供：范围查询，SQL 查询，几何查询，距离查询。
+ *            提供：范围查询，SQL 查询，空间查询，距离查询。
  * @modulecategory Services
  * @extends {ServiceBase}
- * @param {string} url - 服务地址。
+ * @param {string} url - 地图服务地址，如 http://{ip}:{port}/iserver/services/map-world/rest/maps/World 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。
@@ -37,7 +37,7 @@ export class QueryService extends ServiceBase {
 
     /**
      * @function QueryService.prototype.queryByBounds
-     * @description 范围查询地图服务。
+     * @description 范围查询。查询指定矩形范围内的要素，以及外接矩形与指定范围相交的几何对象。
      * @param {QueryByBoundsParameters} params - 范围查询参数类。
      * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
      * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回结果类型。
@@ -76,8 +76,8 @@ export class QueryService extends ServiceBase {
 
     /**
      * @function QueryService.prototype.queryByGeometry
-     * @description 地图几何查询服务。
-     * @param {QueryByGeometryParameters} params - 几何查询参数类。
+     * @description 空间查询。查询与指定的几何对象符合某种空间关系和查询条件的要素。
+     * @param {QueryByGeometryParameters} params - 空间查询参数类。
      * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
      * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回结果类型。
      * @returns {Promise} Promise 对象。

package/services/ServiceBase.js

@@ -7,7 +7,7 @@ import Observable from 'ol/Observable';
  * @class ServiceBase
  * @category iServer Core
  * @classdesc ol.supermap 的服务基类。
- * @param {string} url - 服务地址。
+ * @param {string} url - 服务地址。具体地址类型由子类决定。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。

package/services/SpatialAnalystService.js

@@ -20,7 +20,7 @@ import LineString from 'ol/geom/LineString';
  *      new SpatialAnalystService(url).bufferAnalysis(params,function(result){
  *          //doSomething
  *      })
- * @param {string} url - 服务地址。
+ * @param {string} url - 空间分析服务地址，如 http://{ip}:{port}/iserver/services/spatialanalyst-changchun/restjsr/spatialanalyst 。
  * @param {Object} options - 参数。
  * @param {string} [options.proxy] - 服务代理地址。
  * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。