@supermapgis/iclient-ol 11.2.0

package/services/SpatialAnalystService.js

@@ -0,0 +1,466 @@
+/* Copyright© 2000 - 2024 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 {Util} from '../core/Util';
+import { DataFormat } from '@supermapgis/iclient-common/REST';
+import { Point as GeometryPoint } from '@supermapgis/iclient-common/commontypes/geometry/Point';
+import { SpatialAnalystService as CommonSpatialAnalystService } from '@supermapgis/iclient-common/iServer/SpatialAnalystService';
+import {ServiceBase} from './ServiceBase';
+import LineString from 'ol/geom/LineString';
+import GeoJSON from 'ol/format/GeoJSON';
+
+/**
+ * @class SpatialAnalystService
+ * @extends {ServiceBase}
+ * @category  iServer SpatialAnalyst
+ * @classdesc 空间分析服务类。提供方法：地区太阳辐射、缓冲区分析、点密度分析、动态分段分析、空间关系分析、
+ * 插值分析、栅格代数运算、叠加分析、路由定位、路由测量计算、表面分析、地形曲率计算、坡度计算、坡向计算、
+ * 泰森多边形分析、填挖方分析、凸包计算等。
+ * @modulecategory Services
+ * @example
+ *      new SpatialAnalystService(url).bufferAnalysis(params,function(result){
+ *          //doSomething
+ *      })
+ * @param {string} url - 服务地址。
+ * @param {Object} options - 参数。
+ * @param {string} [options.proxy] - 服务代理地址。
+ * @param {boolean} [options.withCredentials=false] - 请求是否携带 cookie。
+ * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
+ * @param {Object} [options.headers] - 请求头。
+ * @usage
+ */
+export class SpatialAnalystService extends ServiceBase {
+
+    constructor(url, options) {
+        super(url, options);
+        this._spatialAnalystService = new CommonSpatialAnalystService(url, options);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.getAreaSolarRadiationResult
+     * @description 地区太阳辐射。<br>
+     * 地区太阳辐射计算，指的是计算整个 DEM 范围内每个栅格的太阳辐射情况，计算可得到太阳辐射的总辐射量、直射辐射量、散射辐射量、直射持续时间。
+     * @param {AreaSolarRadiationParameters} params - 地区太阳辐射参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    getAreaSolarRadiationResult(params, callback, resultFormat) {
+        return this._spatialAnalystService.getAreaSolarRadiationResult(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.bufferAnalysis
+     * @description 缓冲区分析。<br>
+     * 缓冲区分析是围绕空间对象，使用与空间对象的距离值（称为缓冲半径）作为半径，生成该对象的缓冲区域的过程，
+     * 其中缓冲半径可以是固定数值也可以是空间对象各自的属性值。缓冲区也可以理解为空间对象的影响或服务范围。
+     * @param {DatasetBufferAnalystParameters|GeometryBufferAnalystParameters} params - 数据集缓冲区分析参数类 || 几何对象缓冲区分析参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    bufferAnalysis(params, callback, resultFormat) {
+      params = this._processParams(params);
+      return this._spatialAnalystService.bufferAnalysis(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.densityAnalysis
+     * @description 点密度分析。目前提供 1 种点密度分析方式：核密度分析。<br>
+     * 核密度分析用于计算点、线要素测量值在指定邻域范围内的单位密度，能直观地反映出离散测量值在连续区域内的分布情况。
+     * 其结果是中间值大周边值小的光滑曲面，栅格值即为单位密度，在邻域边界处降为 0。
+     * 核密度分析可用于计算人口密度、建筑密度、获取犯罪情况报告、旅游区人口密度监测、连锁店经营情况分析等等。
+     * @param {DensityKernelAnalystParameters} params - 核密度分析参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    densityAnalysis(params, callback, resultFormat) {
+        params = this._processParams(params);
+        return this._spatialAnalystService.densityAnalysis(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.generateSpatialData
+     * @description 动态分段分析。动态分段技术是在传统 GIS 数据模型的基础上，利用线性参考技术，根据属性数据的空间位置，实现属性数据在地图上动态地显示、分析及输出等。
+     * 线性参考是一种采用沿具有测量值的线性要素的相对位置来描述和存储地理位置的方法，即使用距离来定位沿线的事件。
+     * @param {GenerateSpatialDataParameters} params - 动态分段操作参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    generateSpatialData(params, callback, resultFormat) {
+      return this._spatialAnalystService.generateSpatialData(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.geoRelationAnalysis
+     * @description 空间关系分析。根据指定的空间关系，查询数据集中所有满足要求的对象。支持的空间关系判断类型：包含、被包含、相交。
+     * @param {GeoRelationAnalystParameters} params - 空间关系分析服务参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    geoRelationAnalysis(params, callback, resultFormat) {
+        params = this._processParams(params);
+        return this._spatialAnalystService.geoRelationAnalysis(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.interpolationAnalysis
+     * @description 插值分析。插值分析可以将有限的采样点数据，通过插值对采样点周围的数值情况进行预测，
+     * 从而掌握研究区域内数据的总体分布状况，使采样的离散点不仅仅反映其所在位置的数值情况，而且可以反映区域的数值分布。
+     * @param {InterpolationRBFAnalystParameters|InterpolationDensityAnalystParameters|InterpolationIDWAnalystParameters|InterpolationKrigingAnalystParameters} params - 插值分析参数类，包括：点密度插值分析参数类、反距离加权插值分析参数类、样条插值（径向基函数插值法）分析参数类、克吕金插值分析参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    interpolationAnalysis(params, callback, resultFormat) {
+        params = this._processParams(params);
+        return this._spatialAnalystService.interpolationAnalysis(params, callback, resultFormat);
+    }
+    /**
+     * @function SpatialAnalystService.prototype.mathExpressionAnalysis
+     * @description 栅格代数运算。栅格代数运算的思想是运用代数学的观点对地理特征和现象进行空间分析，实质上是对多个栅格数据集进行数学运算以及函数运算。
+     * 运算结果栅格的像元值是由输入的一个或多个栅格同一位置的像元的值通过代数规则运算得到的。
+     * @param {MathExpressionAnalysisParameters} params - 栅格代数运算参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    mathExpressionAnalysis(params, callback, resultFormat) {
+        params = this._processParams(params);
+        return this._spatialAnalystService.mathExpressionAnalysis(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.overlayAnalysis
+     * @description 叠加分析。叠加分析是指在统一空间参考系统下，通过对两个数据集进行的一系列集合运算，产生新数据集的过程。
+     * @param {DatasetOverlayAnalystParameters|GeometryOverlayAnalystParameters} params - 数据集叠加分析参数类 || 几何对象叠加分析参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    overlayAnalysis(params, callback, resultFormat) {
+      params = this._processParams(params);
+      return this._spatialAnalystService.overlayAnalysis(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.routeCalculateMeasure
+     * @description 路由测量计算。<br>
+     * 基于路由对象计算指定点 M 值。
+     * @param {RouteCalculateMeasureParameters} params - 基于路由对象计算指定点 M 值操作的参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    routeCalculateMeasure(params, callback, resultFormat) {
+      params = this._processParams(params);
+      return this._spatialAnalystService.routeCalculateMeasure(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.routeLocate
+     * @description 路由定位。<br>
+     * 路由定位有定位点和定位线两种类型。路由定点是根据指定路由上的 M 值来定位点，路由定线是根据指定线的范围来确定路由上对应的线对象。
+     * @param {RouteLocatorParameters} params - 路由对象定位空间对象的参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    routeLocate(params, callback, resultFormat) {
+        params = this._processParams(params);
+        return this._spatialAnalystService.routeLocate(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.surfaceAnalysis
+     * @description 表面分析。<br>
+     * 表面分析主要通过生成新数据集，获得更多反映原始数据集中所暗含的空间特征、空间格局等信息。
+     * 支持的表面分析提取操作：提取等值线和提取等值面。
+     * @param {SurfaceAnalystParameters} params - 表面分析提取操作参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    surfaceAnalysis(params, callback, resultFormat) {
+      params = this._processParams(params);
+      return this._spatialAnalystService.surfaceAnalysis(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.terrainCurvatureCalculate
+     * @description 地形曲率计算。地形曲率是表达地形曲面结构的主要参数之一。
+     * DEM 栅格数据每个像元的表面曲率，是通过将目标像元与八个相邻像元拟合为二次曲面，再对此拟合曲面求（0,0）位置处的曲率而得。
+     * 支持计算平均曲率数据集、剖面曲率（即沿最大斜率方向的曲率）数据集、平面曲率（即垂直于最大斜率方向的曲率）数据集。
+     * 输出的三种曲率数据集都是和原数据集等大且分辨率相同的数据集。
+     * @param {TerrainCurvatureCalculationParameters} params - 地形曲率计算参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    terrainCurvatureCalculate(params, callback, resultFormat) {
+        return this._spatialAnalystService.terrainCurvatureCalculate(params, callback, resultFormat);
+    }
+
+   /**
+     * @function SpatialAnalystService.prototype.terrainCutFillCalculate
+     * @description 填挖方计算。<br>
+     * 填挖方计算用于计算填挖操作过程中填方、挖方的面积和体积，包含四种类型：栅格填挖方、选面填挖方、斜面填挖方和三维面填挖方。
+     * @version 11.1.1
+     * @param {TerrainCutFillCalculationParameters} params - 填挖方计算参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    terrainCutFillCalculate(params, callback, resultFormat) {
+      params = this._processParams(params);
+      return this._spatialAnalystService.terrainCutFillCalculate(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.terrainAspectCalculate
+     * @description 地形坡向分析。<br>
+     * 地形坡向分析用于计算栅格数据集（通常使用 DEM 数据）中各个像元的坡度面的朝向。
+     * 坡向计算的范围是 0 到 360 度，以正北方 0 度为开始，按顺时针移动，回到正北方以 360 度结束。平坦的坡面没有方向，赋值为 -1。
+     * @version 11.1.1
+     * @param {TerrainAspectCalculationParameters} params - 地形坡向分析参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    terrainAspectCalculate(params, callback, resultFormat) {
+      params = this._processParams(params);
+      return this._spatialAnalystService.terrainAspectCalculate(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.terrainSlopeCalculate
+     * @description 地形坡度分析。<br>
+     * 地形坡度分析用于计算栅格数据集（通常使用 DEM 数据）中各个像元的坡度值。坡度值越大，地势越陡峭；坡度值越小，地势越平坦。
+     * DEM 数据中的像元值即该点的高程值，通过高程值计算该点的坡度。由于计算点的坡度没有实际意义，在 SuperMap 中，坡度计算的是各像元平面的平均值，
+     * 并且提供了三种坡度表现形式：度数、弧度、百分比。
+     * @version 11.1.1
+     * @param {TerrainSlopeCalculationParameters} params - 地形坡度分析参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     */
+    terrainSlopeCalculate(params, callback, resultFormat) {
+      params = this._processParams(params);
+      return this._spatialAnalystService.terrainSlopeCalculate(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.thiessenAnalysis
+     * @description 泰森多边形分析。泰森多边形又称为 Voronoi 图，是由一组连接两邻点直线的垂直平分线组成的连续多边形组成。
+     * 泰森多边形可用于定性分析、统计分析、邻近分析等，通过创建泰森多边形创建的多边形要素可对可用空间进行划分并将其分配给最近的点要素。
+     * 泰森多边形有时会用于替代插值操作，以便将一组样本测量值概化到最接近他们的区域。使用泰森多边形可将取自一组气候测量仪的测量值概化到周围区域，还可为一组店铺快速建立服务区模型等。例如：<br>
+     * 1.可用离散点的性质来描述泰森多边形区域的性质；<br>
+     * 2.可用离散点的数据来计算泰森多边形区域的数据；<br>
+     * 3.判断一个离散点与其它哪些离散点相邻时，可根据泰森多边形直接得出，且若泰森多边形是 n 边形，则就与 n 个离散点相邻；<br>
+     * 4.当某一数据点落入某一泰森多边形中时，它与相应的离散点最邻近，无需计算距离。
+     * @param {DatasetThiessenAnalystParameters|GeometryThiessenAnalystParameters} params - 数据集泰森多边形分析参数类 || 几何对象泰森多边形分析参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    thiessenAnalysis(params, callback, resultFormat) {
+        params = this._processParams(params);
+        return this._spatialAnalystService.thiessenAnalysis(params, callback, resultFormat);
+    } 
+
+    /**
+     * @function SpatialAnalystService.prototype.minDistanceAnalysis
+     * @description 最近距离计算。<br>
+     * 最近距离计算即在指定地图上，查找距离指定几何对象一定容限内最近的几何对象。
+     * @version 11.1.1
+     * @param {DatasetMinDistanceAnalystParameters|GeometryMinDistanceAnalystParameters} params - 数据集最近距离计算参数类 || 几何对象最近距离计算参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    minDistanceAnalysis(params, callback, resultFormat) {
+      params = this._processParams(params);
+      return this._spatialAnalystService.minDistanceAnalysis(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.convexHullAnalysis
+     * @description 凸包计算。<br>
+     * 三维模型对象可以看作三维空间中由无数个三维点构成的点集，该模型对象的凸包即是一个能够包含选中模型的所有三维点的最小闭合几何体。
+     * 基于模型对象进行凸包运算，可以得到该模型对象的凸包。
+     * @version 11.1.1
+     * @param {ConvexHullAnalystParameters} params - 凸包计算参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    convexHullAnalysis(params, callback, resultFormat) {
+      params = this._processParams(params);
+      return this._spatialAnalystService.convexHullAnalysis(params, callback, resultFormat);
+    }
+
+    /**
+     * @function SpatialAnalystService.prototype.geometrybatchAnalysis
+     * @description 批量空间分析。<br>
+     * 支持的批量空间分析方法包括：缓冲区分析、插值分析、叠加分析、表面分析等。
+     * @param {Array.<Object>} params - 批量分析参数对象数组。
+     * @param {Array.<Object>} params.analystName - 空间分析方法的名称。包括：</br>
+     *                                              "buffer"，"overlay"，"interpolationDensity"，"interpolationidw"，"interpolationRBF"，"interpolationKriging"，"isoregion"，"isoline"。
+     * @param {Object} params.param - 空间分析类型对应的请求参数，包括：</br>
+     *                                {@link GeometryBufferAnalystParameters} 缓冲区分析参数类。</br>
+     *                                {@link GeometryOverlayAnalystParameters} 叠加分析参数类。</br>
+     *                                {@link InterpolationAnalystParameters} 插值分析参数类。</br>
+     *                                {@link SurfaceAnalystParameters} 表面分析参数类。</br>
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回的结果类型。
+     * @returns {Promise} Promise 对象。
+     */
+    geometrybatchAnalysis(params, callback, resultFormat) {
+        for (var i = 0; i < params.length; i++) {
+          params[i].param = this._processParams(params[i].param)
+        }
+        return this._spatialAnalystService.geometrybatchAnalysis(params, callback, resultFormat);
+    }
+
+    _processParams(params) {
+        if (!params) {
+            return {};
+        }
+        if (params.bounds) {
+            params.bounds = Util.toSuperMapBounds(params.bounds);
+        }
+        if (params.inputPoints) {
+            for (let i = 0; i < params.inputPoints.length; i++) {
+                var inputPoint = params.inputPoints[i];
+                if (Util.isArray(inputPoint)) {
+                    params.inputPoints[i] = {x: inputPoint[0], y: inputPoint[1], tag: inputPoint[2]};
+                } else {
+                    params.inputPoints[i] = {
+                        x: inputPoint.getCoordinates()[0],
+                        y: inputPoint.getCoordinates()[1],
+                        tag: inputPoint.tag
+                    };
+                }
+
+            }
+        }
+        if (params.points) {
+            for (let i = 0; i < params.points.length; i++) {
+                let point = params.points[i];
+                if (Util.isArray(point)) {
+                    point.setCoordinates(point);
+                }
+                params.points[i] = new GeometryPoint(point.getCoordinates()[0], point.getCoordinates()[1]);
+            }
+        }
+        if (params.point) {
+            let point = params.point;
+            if (Util.isArray(point)) {
+                point.setCoordinates(point);
+            }
+            params.point = new GeometryPoint(point.getCoordinates()[0], point.getCoordinates()[1]);
+        }
+        if (params.extractRegion) {
+            params.extractRegion = this.convertGeometry(params.extractRegion);
+        }
+        if (params.extractParameter && params.extractParameter.clipRegion) {
+            params.extractParameter.clipRegion = this.convertGeometry(params.extractParameter.clipRegion);
+        }
+        if (params.clipParam && params.clipParam.clipRegion) {
+            params.clipParam.clipRegion = this.convertGeometry(params.clipParam.clipRegion);
+        }
+        if (params.clipRegion) {
+            params.clipRegion = this.convertGeometry(params.clipRegion);
+        }
+        //支持格式：Vector Layers; GeoJson
+        if (params.sourceGeometry) {
+            var SRID = null;
+            if (params.sourceGeometrySRID) {
+                SRID = params.sourceGeometrySRID;
+            }
+            params.sourceGeometry = this.convertGeometry(params.sourceGeometry);
+            if (SRID) {
+                params.sourceGeometry.SRID = SRID;
+            }
+            delete params.sourceGeometry.sourceGeometrySRID;
+        }
+        if (params.operateGeometry) {
+            params.operateGeometry = this.convertGeometry(params.operateGeometry);
+        }
+        //支持传入多个几何要素进行叠加分析：
+        if (params.sourceGeometries) {
+            var sourceGeometries = [];
+            for (var k = 0; k < params.sourceGeometries.length; k++) {
+                sourceGeometries.push(this.convertGeometry(params.sourceGeometries[k]));
+            }
+            params.sourceGeometries = sourceGeometries;
+        }
+        //支持传入多个几何要素进行叠加分析：
+        if (params.operateGeometries) {
+            var operateGeometries = [];
+            for (var j = 0; j < params.operateGeometries.length; j++) {
+                operateGeometries.push(this.convertGeometry(params.operateGeometries[j]));
+            }
+            params.operateGeometries = operateGeometries;
+        }
+
+        // 最近距离
+        if (params.inputGeometries) {
+          var inputGeometries = [];
+          for (var l = 0; l < params.inputGeometries.length; l++) {
+            inputGeometries.push(this.convertGeometry(params.inputGeometries[l]));
+          }
+          params.inputGeometries = inputGeometries;
+        }
+
+        if (params.sourceRoute) {
+            if (params.sourceRoute instanceof LineString && params.sourceRoute.getCoordinates()) {
+                var target = {};
+                target.type = "LINEM";
+                target.parts = [params.sourceRoute.getCoordinates()[0].length];
+                target.points = [];
+                for (let i = 0; i < params.sourceRoute.getCoordinates()[0].length; i++) {
+                    let point = params.sourceRoute.getCoordinates()[0][i];
+                    target.points = target.points.concat({x: point[0], y: point[1], measure: point[2]})
+                }
+                params.sourceRoute = target;
+            }
+
+        }
+        var me = this;
+        if (params.operateRegions && Util.isArray(params.operateRegions)) {
+            params.operateRegions.map(function (geometry, key) {
+                params.operateRegions[key] = me.convertGeometry(geometry);
+                return params.operateRegions[key];
+            });
+        }
+        if (params.sourceRoute && params.sourceRoute.components && Util.isArray(params.sourceRoute.components)) {
+            params.sourceRoute.components.map(function (geometry, key) {
+                params.sourceRoute.components[key] = me.convertGeometry(geometry);
+                return params.sourceRoute.components[key];
+            });
+        }
+        return params;
+    }
+
+    _processFormat(resultFormat) {
+        return (resultFormat) ? resultFormat : DataFormat.GEOJSON;
+    }
+
+    /**
+     * @private
+     * @function SpatialAnalystService.prototype.convertGeometry
+     * @description 转换几何对象。
+     * @param {Object} ol3Geometry - 待转换的几何对象。
+     */
+
+    convertGeometry(ol3Geometry) {
+        //判断是否传入的是geojson 并作相应处理
+        if(["FeatureCollection", "Feature", "Geometry"].indexOf(ol3Geometry.type) != -1){
+            return Util.toSuperMapGeometry(ol3Geometry);
+        }
+        return Util.toSuperMapGeometry(JSON.parse((new GeoJSON()).writeGeometry(ol3Geometry)));
+    }
+}

package/services/ThemeService.js

@@ -0,0 +1,50 @@
+/* Copyright© 2000 - 2024 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 {ServiceBase} from './ServiceBase';
+import { ThemeService as CommonThemeService } from '@supermapgis/iclient-common/iServer/ThemeService';
+
+/**
+ * @class ThemeService
+ * @category  iServer Map Theme
+ * @classdesc 专题图服务类。地图学中将突出而深入地表示一种或几种要素或现象，即集中表示一个主题内容的地图称为专题地图。在 SuperMap 中，专题图是地图图层的符号化显示，即用各种图形渲染风格（大小，颜色，线型，填充等）来图形化地表现专题要素的某方面特征。该类可用于获取专题图的信息。
+ * @modulecategory Services
+ * @extends {ServiceBase}
+ * @example
+ *      new ThemeService(url,{
+ *            projection:projection
+ *      }).getThemeInfo(params,function(result){
+ *           //doSomething
+ *      });
+ * @param {string} url - 服务地址。
+ * @param {Object} options - 参数。
+ * @param {string} [options.proxy] - 服务代理地址。
+ * @param {boolean} [options.withCredentials=false] - 请求是否携带 cookie。
+ * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
+ * @param {Object} [options.headers] - 请求头。
+ * @usage
+ */
+export class ThemeService extends ServiceBase {
+
+    constructor(url, options) {
+        super(url, options);
+        var me = this;
+        this._themeService = new CommonThemeService(me.url, {
+            proxy: me.options.proxy,
+            withCredentials: me.options.withCredentials,
+            crossOrigin: me.options.crossOrigin,
+            headers: me.options.headers
+        });
+    }
+
+    /**
+     * @function ThemeService.prototype.getThemeInfo
+     * @description 获取专题图信息。
+     * @param {ThemeParameters} params - 专题图参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    getThemeInfo(params, callback) {
+      return this._themeService.processAsync(params, callback);
+    }
+}

package/services/TrafficTransferAnalystService.js

@@ -0,0 +1,93 @@
+/* Copyright© 2000 - 2024 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 {Util} from '../core/Util';
+import {ServiceBase} from './ServiceBase';
+import { TrafficTransferAnalystService as CommonTrafficTransferAnalystService } from '@supermapgis/iclient-common/iServer/TrafficTransferAnalystService';
+import Point from 'ol/geom/Point';
+
+/**
+ * @class TrafficTransferAnalystService
+ * @extends {ServiceBase}
+ * @category  iServer TrafficTransferAnalyst
+ * @classdesc 交通换乘分析服务类。交通换乘分析支持按照指定的公交站点和公交换乘策略进行换乘分析，
+ * 返回相应的换乘方案，以及指定的某条换乘路线的详细信息。其中，支持的换乘策略包括时间最短、距离最短、最少换乘、少步行等。
+ * 此外，交通换乘分析还支持通过关键字查询站点信息，这样客户端可以先查询站点，再根据合适的站点进行换乘分析。
+ * @modulecategory Services
+ * @example
+ *      new TrafficTransferAnalystService(url).queryStop(params,function(result){
+ *           //doSomething
+ *      })
+ * @param {string} url - 服务地址。
+ * @param {Object} options - 参数。
+ * @param {string} [options.proxy] - 服务代理地址。
+ * @param {boolean} [options.withCredentials=false] - 请求是否携带 cookie。
+ * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
+ * @param {Object} [options.headers] - 请求头。
+ * @usage
+ */
+export class TrafficTransferAnalystService extends ServiceBase {
+
+    constructor(url, options) {
+        super(url, options);
+        this._commonTrafficTransferAnalystService = new CommonTrafficTransferAnalystService(url, options);
+    }
+
+    /**
+     * @function TrafficTransferAnalystService.prototype.queryStop
+     * @description 站点查询服务。<br>
+     * 根据传入的关键词进行公交站点查询，返回名称与关键词相关的公交站点。
+     * @param {StopQueryParameters} params - 站点查询参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    queryStop(params, callback) {
+      return this._commonTrafficTransferAnalystService.queryStop(params, callback);
+    }
+
+    /**
+     * @function TrafficTransferAnalystService.prototype.analysisTransferPath
+     * @description 交通换乘线路查询服务。<br>
+     * 根据换乘分段内可乘车的路线集合，查询得到某一条乘车路线的详细信息。
+     * @param {TransferPathParameters} params - 交通换乘线路查询参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    analysisTransferPath(params, callback) {
+      params = this._processParams(params);
+      return this._commonTrafficTransferAnalystService.analysisTransferPath(params, callback);
+    }
+
+    /**
+     * @function TrafficTransferAnalystService.prototype.analysisTransferSolution
+     * @description 交通换乘方案查询服务。<br>
+     * 根据换乘策略、乘车偏好、避让站点、出行时间等参数查询交通换乘方案，根据换乘方案中的介绍信息可以获取具体的乘车路线。
+     * @param {TransferSolutionParameters} params - 交通换乘方案查询参数类。
+     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
+     * @returns {Promise} Promise 对象。
+     */
+    analysisTransferSolution(params, callback) {
+      params = this._processParams(params);
+      return this._commonTrafficTransferAnalystService.analysisTransferSolution(params, callback);
+    }
+
+    _processParams(params) {
+        if (!params) {
+            return {};
+        }
+        if (params.transferLines && !Util.isArray(params.transferLines)) {
+            params.transferLines = [params.transferLines];
+        }
+        if (params.points && Util.isArray(params.points)) {
+            params.points.map(function (point, key) {
+                params.points[key] = (point instanceof Point) ? {
+                    x: point.getCoordinates()[0],
+                    y: point.getCoordinates()[1]
+                } : point;
+                return params.points[key];
+            });
+        }
+        return params;
+    }
+
+}