[fix]文档注释修改 src：openlayers review by jinny

Author: Wenxinyu1998

src/openlayers/control/ChangeTileVersion.js

@@ -189,7 +189,7 @@ export class ChangeTileVersion extends Control {
          * @param {string} tagName - 标签名。
          * @param {string} className - 类名。
          * @param {Object} container - 容器。
-         * @returns {object|HTMLElement} 元素
+         * @returns {object|HTMLElement} 元素。
          */
         function createElement(tagName, className, container) {
             var el = document.createElement(tagName);
@@ -208,7 +208,7 @@ export class ChangeTileVersion extends Control {
          * @param {string} type - 事件类型。
          * @param {Object} fn -容器。
          * @param {Object} context -当前环境。
-         * @returns {function} 添加的事件
+         * @returns {function} 添加的事件。
          */
         function addDomEvent(obj, type, fn, context) {
             var handler = function(e) {

src/openlayers/mapping/ImageSuperMapRest.js

@@ -24,7 +24,7 @@ import { containsExtent, getCenter, getHeight, getWidth, getForViewAndSize } fro
  * @param {boolean} [options.transparent=true] - 瓦片是否透明。
  * @param {boolean} [options.antialias=false] - 是否反走样地图。
  * @param {boolean} [options.cacheEnabled=true] - 是否使用服务端的缓存，true 表示使用服务端的缓存。
- * @param {Object} [options.prjCoordSys] - 请求的地图的坐标参考系统。当此参数设置的坐标系统不同于地图的原有坐标系统时， 系统会进行动态投影，并返回动态投影后的地图瓦片。例如：{"epsgCode":3857}。
+ * @param {Object} [options.prjCoordSys] - 请求的地图的坐标参考系统。当此参数设置的坐标系统不同于地图的原有坐标系统时，系统会进行动态投影，并返回动态投影后的地图瓦片。例如：{"epsgCode":3857}。
  * @param {string} [options.layersID] - 获取进行切片的地图图层 ID，即指定进行地图切片的图层，可以是临时图层集，也可以是当前地图中图层的组合。
  * @param {boolean} [options.clipRegionEnabled = false] - 是否地图只显示该区域覆盖的部分。true 表示地图只显示该区域覆盖的部分。
  * @param {ol.geom.Geometry} [options.clipRegion] - 地图显示裁剪的区域。是一个面对象，当 clipRegionEnabled = true 时有效，即地图只显示该区域覆盖的部分。
@@ -35,14 +35,14 @@ import { containsExtent, getCenter, getHeight, getWidth, getForViewAndSize } fro
  * @param {boolean} [options.textOrientationFixed=false] - 文本朝向是否固定。
  * @param {boolean} [options.paintBackground=false] - 是否绘制地图背景。
  * @param {boolean} [options.maxVisibleTextSize] - 文本的最大可见尺寸，单位为像素。
- * @param {boolean} [options.maxVisibleVertex] - 最大几何对象可见节点数。 如果几何对象的节点数超过指定的个数，则超过的那部分节点不显示。
+ * @param {boolean} [options.maxVisibleVertex] - 最大几何对象可见节点数。如果几何对象的节点数超过指定的个数，则超过的那部分节点不显示。
  * @param {boolean} [options.minVisibleTextSize] - 文本的最小可见尺寸，单位为像素。
  * @param {string} [options.tileversion] - 切片版本名称，_cache 为 true 时有效。
  * @param {string} [options.tileProxy] - 代理地址。
  * @param {NDVIParameter|HillshadeParameter} [options.rasterfunction] - 栅格分析参数。
- * @param {string} [options.format = 'png'] - 瓦片表述类型，支持 "png" 、"webp"、"bmp" 、"jpg"、 "gif" 等图片类型。
+ * @param {string} [options.format = 'png'] - 瓦片表述类型，支持 "png" 、"webp"、"bmp" 、"jpg"、"gif" 等图片类型。
  * @param {Function} [options.imageLoadFunction] - 加载图片的方法。默认为function(imageTile, src) {imageTile.getImage().src = src;};
- * @param {string} [options.ratio=1.5] - 	请求图片大小比例. 1 表示请求图片大小和地图视窗范围一致, 2 表示请求图片大小是地图视窗范围的2倍，以此类推。
+ * @param {string} [options.ratio=1.5] - 	请求图片大小比例。 1 表示请求图片大小和地图视窗范围一致，2 表示请求图片大小是地图视窗范围的2倍，以此类推。
  * @extends {ol.source.Image}
  * @usage
  */

src/openlayers/mapping/ImageTileSuperMapRest.js

@@ -15,14 +15,14 @@ import { Util as CommonUtil } from '@supermap/iclient-common/commontypes/Util';
  * @param {Object} options - 参数。
  * @param {string} options.url - 服务地址。例如: http://{ip}:{port}/iserver/{imageservice-imageserviceName}/restjsr/
  * @param {string} options.collectionId - 影像集合（Collection）的ID，在一个影像服务中唯一标识影像集合。
- * @param {string} [options.sqlFilter] 显示影像的过滤条件。相当于sql查询中的where子句。支持st_geometry空间函数过滤。11.0版本暂不支持通过ECQL进行过滤。
+ * @param {string} [options.sqlFilter] 显示影像的过滤条件。相当于SQL查询中的where子句。支持st_geometry空间函数过滤。11.0版本暂不支持通过ECQL进行过滤。
  * @param {ImageRenderingRule} [options.renderingRule] 指定影像显示的风格，包含拉伸显示方式、颜色表、波段组合以及应用栅格函数进行快速处理等。不指定时，使用发布服务时所配置的风格。
- * @param {Array.<number>} [options.ids] 返回影像集合中指定ID的影像，该id为系统维护的一个自增id，为SuperMap SDX引擎的SmID字段内容。
+ * @param {Array.<number>} [options.ids] 返回影像集合中指定ID的影像，该ID为系统维护的一个自增ID，为SuperMap SDX引擎的SmID字段内容。
  * @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 {string} [options.tileProxy] -  代理地址
+ * @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}
  * @usage

src/openlayers/mapping/Tianditu.js

@@ -96,7 +96,7 @@ export class Tianditu extends WMTS {
    * @function Tianditu.getTileGrid
    * @description 获取瓦片网格。
    * @param {string} projection - 投影参考对象。
-   * @returns {ol.tilegrid.WMTS} 返回瓦片网格对象
+   * @returns {ol.tilegrid.WMTS} 返回瓦片网格对象。
    */
   static getTileGrid(projection) {
     if (projection === "EPSG:4326" || projection === "EPSG:4490") {

src/openlayers/mapping/TileSuperMapRest.js

@@ -24,15 +24,15 @@ import TileGrid from 'ol/tilegrid/TileGrid';
  * @param {boolean} [options.redirect = false] - 是否重定向。
  * @param {boolean} [options.transparent = true] - 瓦片是否透明。
  * @param {boolean} [options.cacheEnabled = true] - 是否使用服务端的缓存。
- * @param {Object} [options.prjCoordSys] - 请求的地图的坐标参考系统。当此参数设置的坐标系统不同于地图的原有坐标系统时， 系统会进行动态投影，并返回动态投影后的地图瓦片。例如：{"epsgCode":3857}。
+ * @param {Object} [options.prjCoordSys] - 请求的地图的坐标参考系统。当此参数设置的坐标系统不同于地图的原有坐标系统时，系统会进行动态投影，并返回动态投影后的地图瓦片。例如：{"epsgCode":3857}。
  * @param {string} [options.layersID] - 获取进行切片的地图图层 ID，即指定进行地图切片的图层，可以是临时图层集，也可以是当前地图中图层的组合。
  * @param {boolean} [options.clipRegionEnabled = false] - 是否只地图只显示该区域覆盖的部分。true 表示地图只显示该区域覆盖的部分。
  * @param {ol.geom.Geometry} [options.clipRegion] - 地图显示裁剪的区域。是一个面对象，当 clipRegionEnabled = true 时有效，即地图只显示该区域覆盖的部分。
  * @param {boolean} [options.overlapDisplayed = false] - 地图对象在同一范围内时，是否重叠显示。如果为 true，则同一范围内的对象会直接压盖；如果为 false 则通过 overlapDisplayedOptions 控制对象不压盖显示。
  * @param {OverlapDisplayedOptions} [options.overlapDisplayedOptions] - 避免地图对象压盖显示的过滤选项，当 overlapDisplayed 为 false 时有效，用来增强对地图对象压盖时的处理。
  * @param {string} [options.tileversion] - 切片版本名称，_cache 为 true 时有效。
  * @param {string} [options.tileProxy] - 服务代理地址。
- * @param {string} [options.format = 'png'] - 瓦片表述类型，支持 "png" 、"webp"、"bmp" 、"jpg"、 "gif" 等图片类型。
+ * @param {string} [options.format = 'png'] - 瓦片表述类型，支持 "png" 、"webp"、"bmp" 、"jpg"、"gif" 等图片类型。
  * @param {(NDVIParameter|HillshadeParameter)} [options.rasterfunction] - 栅格分析参数。
  * @extends {ol.source.TileImage}
  * @usage

src/openlayers/overlay/DataFlow.js

@@ -15,7 +15,7 @@ import GeoJSON from 'ol/format/GeoJSON';
  * @param {string} [opt_options.idField = 'id'] - 要素属性中表示唯一标识的字段。
  * @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({

src/openlayers/overlay/Graph.js

@@ -342,7 +342,7 @@ export class Graph extends Theme {
 
     /**
      * @function Graph.prototype.isPointInPoly
-     * @description  判断一个点是否在多边形里面。（射线法）。
+     * @description  判断一个点是否在多边形里面（射线法）。
      * @param {Object} pt - 需要判定的点对象，该对象含有属性 x（横坐标），属性 y（纵坐标）。
      * @param {Array.<Object>} poly - 多边形节点数组。
      */
@@ -396,7 +396,7 @@ export class Graph extends Theme {
 
     /**
      * @function Graph.prototype.removeAllFeatures
-     * @description  移除所有的要素
+     * @description  移除所有的要素。
      */
     removeAllFeatures() {
         this.clearCache();
@@ -405,7 +405,7 @@ export class Graph extends Theme {
 
     /**
      * @function Graph.prototype.redraw
-     * @description  重绘该图层
+     * @description  重绘该图层。
      */
     redraw() {
         this.clearCache();
@@ -418,7 +418,7 @@ export class Graph extends Theme {
 
     /**
      * @function Graph.prototype.clear
-     * @description  清除的内容包括数据（features） 、专题要素、缓存。
+     * @description  清除的内容包括数据（features）、专题要素、缓存。
      */
     clear() {
         if (this.renderer) {

src/openlayers/overlay/Graphic.js

@@ -44,7 +44,7 @@ const Renderer = ['canvas', 'webgl'];
  * @param {ol.style.Style} [options.highLightStyle=defaultHighLightStyle] - 高亮风格。
  * @param {Array.<number>} [options.color=[0, 0, 0, 255]] - 要素颜色。当 {@link OverlayGraphic} 的 style 参数传入设置了 fill 的 {@link HitCloverShape} 或 {@link CloverShape}，此参数无效。
  * @param {Array.<number>} [options.highlightColor] - webgl 渲染时要素高亮颜色。
- * @param {number} [options.opacity=0.8] - 要素透明度,。当 {@link OverlayGraphic} 的 style 参数传入设置了 fillOpacity 或 strokeOpacity 的 {@link HitCloverShape} 或 {@link CloverShape}，此参数无效。
+ * @param {number} [options.opacity=0.8] - 要素透明度。当 {@link OverlayGraphic} 的 style 参数传入设置了 fillOpacity 或 strokeOpacity 的 {@link HitCloverShape} 或 {@link CloverShape}，此参数无效。
  * @param {number} [options.radius=10] - 要素半径，单位像素。当 {@link OverlayGraphic} 的 style 参数传入设置了 radius 的 {@link HitCloverShape} 或 {@link CloverShape}，此参数无效。
  * @param {number} [options.radiusScale=1] - webgl 渲染时的要素放大倍数。
  * @param {number} [options.radiusMinPixels=0] - webgl 渲染时的要素半径最小值（像素）。
@@ -308,8 +308,8 @@ export class Graphic extends ImageCanvasSource {
 
     /**
      * @function Graphic.prototype.getGraphicById
-     * @description 通过给定一个 id，返回对应的矢量要素。
-     * @param {string} graphicId - 矢量要素的属性 id
+     * @description 通过给定一个 ID，返回对应的矢量要素。
+     * @param {string} graphicId - 矢量要素的属性 ID。
      * @returns {OverlayGraphic} 一个匹配的 graphic。
      */
     getGraphicById(graphicId) {

src/openlayers/overlay/HeatMap.js

@@ -18,7 +18,7 @@ import Point from 'ol/geom/Point';
  * @browsernamespace ol.source
  * @classdesc 热力图层类。
  * @category Visualization HeatMap
- * @param {string} name - 图层名称
+ * @param {string} name - 图层名称。
  * @param {Object} options - 参数。
  * @param {ol.Map} options.map - openlayers 的 map 对象。
  * @param {string} [options.id] - 专题图层 ID，默认使用 CommonUtil.createUniqueID("HeatMapSource_") 创建专题图层 ID。
@@ -357,7 +357,7 @@ export class HeatMap extends ImageCanvasSource {
      * @param {Object} pixelP - 像素点。
      * @param {Object} center - 中心点。
      * @param {number} scaleRatio - 缩放倍数。
-     * @returns {Array.<number>} 返回数组形比例
+     * @returns {Array.<number>} 返回数组型比例。
      */
     scale(pixelP, center, scaleRatio) {
         var x = (pixelP[0] - center[0]) * scaleRatio + center[0];
@@ -411,7 +411,7 @@ export class HeatMap extends ImageCanvasSource {
      * @function HeatMap.prototype.toiClientFeature
      * @description 转为 iClient 要素。
      * @param {GeoJSONObject|Array.<ol.Feature>} features - 待添加的要素数组。
-     * @returns {FeatureVector} 转换后的 iClient 要素
+     * @returns {FeatureVector} 转换后的 iClient 要素。
      */
     toiClientFeature(features) {
         if (!Util.isArray(features)) {

src/openlayers/overlay/Mapv.js

@@ -20,7 +20,7 @@ import ImageCanvasSource from 'ol/source/ImageCanvas';
  * @param {Object} opt_options.mapvOptions - MapV 的配置对象。
  * @param {string} [opt_options.logo] - Logo（openLayers 5.0.0 及更高版本不再支持此参数）。
  * @param {ol.proj.Projection} [opt_options.projection] - 投影信息。
- * @param {number} [opt_options.ratio=1.5] - 视图比，1 表示画布是地图视口的大小，2 表示地图视口的宽度和高度的两倍，依此类推。 必须是 1 或更高。
+ * @param {number} [opt_options.ratio=1.5] - 视图比，1 表示画布是地图视口的大小，2 表示地图视口的宽度和高度的两倍，依此类推。必须是 1 或更高。
  * @param {Array} [opt_options.resolutions] - 分辨率数组。
  * @param {ol.source.State} [opt_options.state] - 资源状态。
  * @param {(string|Object)} [opt_options.attributions='© 2018 百度 MapV with <span>© <a href='https://iclient.supermap.io' target='_blank'>SuperMap iClient</a></span>'] - 版权信息。