@supermapgis/iclient-ol 11.2.0

package/overlay/Turf.js

@@ -0,0 +1,299 @@
+/* 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 * as turf from '@turf/turf';
+import VectorSource from 'ol/source/Vector';
+import GeoJSON from 'ol/format/GeoJSON';
+import { Util } from '../core/Util';
+
+/**
+ * @class Turf
+ * @browsernamespace ol.source
+ * @category  Visualization Turf
+ * @classdesc Turf.js 图层源。Turf.js 是一个用于空间分析的 JavaScript 库。它包括传统的空间操作，用于创建 GeoJSON数据的帮助函数，
+ * 以及数据分类和统计工具。此类提供了执行 Turf.js 中相关空间分析方法的功能。
+ * @modulecategory Overlay
+ * @param {Object} opt_options - 参数。
+ * @extends {ol.source.Vector}
+ * @usage
+ */
+export class Turf extends VectorSource {
+
+    constructor(opt_options) {
+        var options = opt_options ? opt_options : {};
+
+        super({
+            attributions: options.attributions || "<span>© turfjs</span> with <span>© SuperMap iClient</span>",
+            features: options.features,
+            format: options.format,
+            extent: options.extent,
+            logo: Util.getOlVersion() === '4' ? options.logo : null,
+            projection: options.projection,
+            wrapX: options.wrapX
+        });
+        this.turfMap = {
+            "Measurement.along": ["line", "distance", "units"],
+            "Measurement.area": ["geojson"],
+            "Measurement.bbox": ["geojson"],
+            "Measurement.bboxPolygon": ["bbox"],
+            "Measurement.bearing": ["start", "end", "final"],
+            "Measurement.center": ["geojson", "properties"],
+            "Measurement.centerOfMass": ["geojson", "properties"],
+            "Measurement.centroid": ["geojson", "properties"],
+            "Measurement.destination": ["origin", "distance", "bearing", "units"],
+            "Measurement.distance": ["from", "to", "units"],
+            "Measurement.envelope": ["geojson"],
+            "Measurement.length": ["geojson", "units"],
+            "Measurement.midpoint": ["point1", "point2"],
+            "Measurement.pointOnFeature": ["geojson"],
+            "Measurement.polygonTangents": ["point", "polygon"],
+            "Measurement.rhumbBearing": ["start", "end", "final"],
+            "Measurement.rhumbDestination": ["origin", "distance", "bearing", "units"],
+            "Measurement.rhumbDistance": ["from", "to", "units"],
+            "Measurement.square": ["bbox"],
+            "Measurement.greatCircle": ["start", "end", "properties", "npoints", "offset"],
+            "CoordinateMutation.cleanCoords":["geojson","mutate"],
+            "CoordinateMutation.flip": ["geojson", "mutate"],
+            "CoordinateMutation.rewind": ["geojson", "reverse", "mutate"],
+            "CoordinateMutation.round": ["num", "precision"],
+            "CoordinateMutation.truncate": ["geojson", "precision", "coordinates", "mutate"],
+            "Transformation.bboxClip": ["feature", "bbox"],
+            "Transformation.bezierSpline": ["line", "resolution", "sharpness"],
+            "Transformation.buffer": ["geojson", "radius", "units", "steps"],
+            "Transformation.circle": ["center", "radius", "steps", "units", "properties"],
+            "Transformation.clone": ["geojson"],
+            "Transformation.concave": ["points", "maxEdge", "units"],
+            "Transformation.convex": ["geojson","concavity"],
+            "Transformation.difference": ["polygon1", "polygon2"],
+            "Transformation.dissolve": ["featureCollection", "propertyName"],
+            "Transformation.intersect": ["poly1", "poly2"],
+            "Transformation.lineOffset": ["geojson", "distance", "units"],
+            "Transformation.simplify": ["feature", "tolerance", "highQuality"],
+            "Transformation.tesselate": ["poly"],
+            "Transformation.transformRotate": ["geojson", "angle", "pivot", "mutate"],
+            "Transformation.transformTranslate": ["geojson", "distance", "direction", "units", "zTranslation", "mutate"],
+            "Transformation.transformScale": ["geojson", "factor", "origin", "mutate"],
+            "Transformation.union": ["A"],
+            "Transformation.voronoi": ["points","bbox"],
+            "featureConversion.combine": ["fc"],
+            "featureConversion.explode": ["geojson"],
+            "featureConversion.flatten": ["geojson"],
+            "featureConversion.lineStringToPolygon": ["lines", "properties", "autoComplete", "orderCoords"],
+            "featureConversion.polygonize": ["geojson"],
+            "featureConversion.polygonToLineString": ["polygon", "properties"],
+            "Misc.kinks": ["featureIn"],
+            "Misc.lineArc": ["center", "radius", "bearing1", "bearing2", "steps", "units"],
+            "Misc.lineChunk": ["geojson", "segmentLength", "units", "reverse"],
+            "Misc.lineIntersect": ["line1", "line2"],
+            "Misc.lineOverlap": ["line1", "line2"],
+            "Misc.lineSegment": ["geojson"],
+            "Misc.lineSlice": ["startPt", "stopPt", "line"],
+            "Misc.lineSliceAlong": ["line", "startDist", "stopDist", "units"],
+            "Misc.lineSplit": ["line", "splitter"],
+            "Misc.mask": ["polygon", "mask"],
+            "Misc.pointOnLine": ["lines", "pt", "units"],
+            "Misc.sector": ["center", "radius", "bearing1", "bearing2", "steps", "units"],
+            "Misc.shortestPath": ["start", "end", "obstacles", "units","resolution"],
+            "Misc.unkinkPolygon": ["geojson"],
+            "Helper.featureCollection": ["features","bbox","id"],
+            "Helper.feature": ["geometry", "properties","bbox","id"],
+            "Helper.geometryCollection": ["geometries", "properties","bbox","id"],
+            "Helper.lineString": ["coordinates", "properties","bbox","id"],
+            "Helper.multiLineString": ["coordinates", "properties","bbox","id"],
+            "Helper.multiPoint": ["coordinates", "properties","bbox","id"],
+            "Helper.multiPolygon": ["coordinates", "properties","bbox","id"],
+            "Helper.point": ["coordinates", "properties","bbox","id"],
+            "Helper.polygon": ["coordinates", "properties","bbox","id"],
+            "Data.sample": ["featurecollection", "num"],
+            "Interpolation.interpolate": ["points", "cellSize", "gridType", "property", "units", "weight"],
+            "Interpolation.isobands": ["pointGrid", "breaks", "zProperty", "commonProperties","breaksProperties"],
+            "Interpolation.isolines": ["pointGrid", "breaks", "zProperty", "commonProperties", "breaksProperties"],
+            "Interpolation.planepoint": ["point", "triangle"],
+            "Interpolation.tin": ["points", "z"],
+            "Joins.pointsWithinPolygon": ["points", "polygons"],
+            "Joins.tag": ["points", "polygons", "field", "outField","mask","properties"],
+            "Grids.hexGrid": ["bbox", "cellSide", "units", "triangles"],
+            "Grids.pointGrid": ["bbox", "cellSide", "units", "mask","properties"],
+            "Grids.squareGrid": ["bbox", "cellSide", "units", "mask","properties"],
+            "Grids.triangleGrid": ["bbox", "cellSide", "units", "mask","properties"],
+            "Classification.nearestPoint": ["targetPoint", "points"],
+            "Aggregation.collect": ["polygons", "points", "inProperty", "outProperty"],
+            "Aggregation.clustersDbscan": ["points", "maxDistance", "units", "minPoints","mutate"],
+            "Aggregation.clustersKmeans": ["points", "numberOfClusters", "mutate"],
+            "Meta.coordAll": ["geojson"],
+            "Meta.coordEach": ["geojson", "callback", "excludeWrapCoord"],
+            "Meta.coordReduce": ["geojson", "callback", "initialValue", "excludeWrapCoord"],
+            "Meta.featureEach": ["geojson", "callback"],
+            "Meta.featureReduce": ["geojson", "callback", "initialValue"],
+            "Meta.flattenEach": ["geojson", "callback"],
+            "Meta.flattenReduce": ["geojson", "callback", "initialValue"],
+            "Meta.getCoord": ["coord"],
+            "Meta.getCoords": ["coords"],
+            "Meta.getGeom": ["geojson"],
+            "Meta.getGeomType": ["geojson","name"],
+            "Meta.geomEach": ["geojson", "callback"],
+            "Meta.geomReduce": ["geojson", "callback", "initialValue"],
+            "Meta.propEach": ["geojson", "callback"],
+            "Meta.propReduce": ["geojson", "callback", "initialValue"],
+            "Meta.segmentEach": ["geojson", "callback"],
+            "Meta.segmentReduce": ["geojson", "callback", "initialValue"],
+            "Meta.getCluster": ["geojson", "filter"],
+            "Meta.clusterEach": ["geojson", "property", "callback"],
+            "Meta.clusterReduce": ["geojson", "property", "callback", "initialValue"],
+            "Assertions.collectionOf": ["featureCollection", "type", "name"],
+            "Assertions.containsNumber": ["coordinates"],
+            "Assertions.geojsonType": ["value", "type", "name"],
+            "Assertions.featureOf": ["feature", "type", "name"],
+            "Booleans.booleanClockwise": ["line"],
+            "Booleans.booleanContains": ["feature1", "feature2"],
+            "Booleans.booleanCrosses": ["feature1", "feature2"],
+            "Booleans.booleanDisjoint": ["feature1", "feature2"],
+            "Booleans.booleanEqual": ["feature1", "feature2"],
+            "Booleans.booleanOverlap": ["feature1", "feature2"],
+            "Booleans.booleanParallel": ["feature1", "feature2"],
+            "Booleans.booleanPointInPolygon": ["point", "polygon", "ignoreBoundary"],
+            "Booleans.booleanPointOnLine": ["point", "linestring", "ignoreEndVertices"],
+            "UnitConversion.bearingToAngle": ["bearing"],
+            "UnitConversion.convertArea": ["area", "originalUnit", "finalUnit"],
+            "UnitConversion.convertLength": ["length", "originalUnit", "finalUnit"],
+            "UnitConversion.degreesToradians": ["degrees"],
+            "UnitConversion.lengthToRadians": ["distance", "units"],
+            "UnitConversion.lengthToDegrees": ["distance", "units"],
+            "UnitConversion.radiansToLength": ["radians", "units"],
+            "UnitConversion.radiansToDegrees": ["radians"],
+            "UnitConversion.toMercator": ["geojson","mutate"],
+            "UnitConversion.toWgs84": ["geojson","mutate"]
+        };
+
+        // 5.0.0 及以上版本参数配置
+        this.turfOptionMap={
+            "Measurement.along": ["line", "distance", {units:""}],
+            "Measurement.bboxPolygon": ["bbox",{properties:"",id:""}],
+            "Measurement.bearing": ["start", "end", {final:""}],
+            "Measurement.center": ["geojson", {properties:""}],
+            "Measurement.destination": ["origin", "distance", "bearing", {units:"",properties:""}],
+            "Measurement.distance": ["from", "to", {units:""}],
+            "Measurement.length": ["geojson", {units:""}],
+            "Measurement.rhumbBearing": ["start", "end", {final:""}],
+            "Measurement.rhumbDestination": ["origin", "distance", "bearing", {units:"",properties:""}],
+            "Measurement.rhumbDistance": ["from", "to", {units:""}],
+            "Measurement.greatCircle": ["start", "end", {properties:"", npoints:"", offset:""}],
+            "CoordinateMutation.cleanCoords":["geojson",{mutate:""}],
+            "CoordinateMutation.flip": ["geojson", {mutate:""}],
+            "CoordinateMutation.rewind": ["geojson",{mutate:"",reverse:""}],
+            "CoordinateMutation.truncate": ["geojson", {precision:"", coordinates:"", mutate:""}],
+            "Transformation.bezierSpline": ["line", {resolution:"", sharpness:""}],
+            "Transformation.buffer": ["geojson", "radius", {units:"", steps:""}],
+            "Transformation.circle": ["center", "radius",  {units:"", steps:"",properties:""}],
+            "Transformation.concave": ["points", {maxEdge:"", units:""}],
+            "Transformation.convex": ["geojson",{concavity:""}],
+            "Transformation.dissolve": ["featureCollection", {propertyName:""}],
+            "Transformation.lineOffset": ["geojson", "distance", {units:""}],
+            "Transformation.simplify": ["geojson", {tolerance:"", highQuality:""}],
+            "Transformation.transformRotate": ["geojson", "angle", {pivot:"", mutate:""}],
+            "Transformation.transformTranslate": ["geojson", "distance", "direction", {units:"", zTranslation:"", mutate:""}],
+            "Transformation.transformScale": ["geojson", "factor", {origin:"", mutate:""}],
+            "Transformation.voronoi": ["points",{bbox:""}],
+            "featureConversion.lineStringToPolygon": ["lines",{properties:"", autoComplete:"", orderCoords:""}],
+            "featureConversion.polygonToLineString": ["polygon", {properties:""}],
+            "Misc.lineArc": ["center", "radius", "bearing1", "bearing2", {steps:"", units:""}],
+            "Misc.lineChunk": ["geojson", "segmentLength", {units:"", reverse:""}],
+            "Misc.lineOverlap": ["line1", "line2",{tolerance:""}],
+            "Misc.lineSliceAlong": ["line", "startDist", "stopDist", {units:""}],
+            "Misc.pointOnLine": ["lines", "pt",  {units:""}],
+            "Misc.sector": ["center", "radius", "bearing1", "bearing2", {units:"",steps:"",properties:""}],
+            "Misc.shortestPath": ["start", "end", {obstacles:"", units:"",resolution:""}],
+            "Helper.feature": ["geometry", "properties",{bbox:"",id:""}],
+            "Helper.geometryCollection": ["geometries", "properties",{bbox:"",id:""}],
+            "Helper.lineString": ["coordinates", "properties",{bbox:"",id:""}],
+            "Helper.multiLineString": ["coordinates", "properties",{bbox:"",id:""}],
+            "Helper.multiPoint": ["coordinates", "properties",{bbox:"",id:""}],
+            "Helper.multiPolygon": ["coordinates", "properties",{bbox:"",id:""}],
+            "Helper.point": ["coordinates", "properties",{bbox:"",id:""}],
+            "Helper.polygon": ["coordinates", "properties",{bbox:"",id:""}],
+            "Interpolation.interpolate": ["points", "cellSize", {gridType:"", property:"", units:"", weight:""}],
+            "Interpolation.isobands": ["pointGrid", "breaks", {zProperty:"", commonProperties:"",breaksProperties:""}],
+            "Interpolation.isolines": ["pointGrid", "breaks", {zProperty:"", commonProperties:"", breaksProperties:""}],
+            "Grids.hexGrid": ["bbox", "cellSide", {units:"", triangles:"",properties:"",mask:""}],
+            "Grids.pointGrid": ["bbox", "cellSide", {units:"", mask:"",properties:""}],
+            "Grids.squareGrid": ["bbox", "cellSide", {units:"", mask:"",properties:""}],
+            "Grids.triangleGrid": ["bbox", "cellSide", {units:"", mask:"",properties:""}],
+            "Aggregation.clustersDbscan": ["points", "maxDistance", {units:"", minPoints:"",mutate:""}],
+            "Aggregation.clustersKmeans": ["points", {numberOfClusters:"", mutate:""}],
+            "Booleans.booleanPointInPolygon": ["point", "polygon", {ignoreBoundary:""}],
+            "Booleans.booleanPointOnLine": ["point", "linestring", {ignoreEndVertices:""}],
+            "UnitConversion.toMercator": ["geojson",{mutate:""}],
+            "UnitConversion.toWgs84": ["geojson",{mutate:""}]
+        }
+
+    }
+
+    /**
+     * @function Turf.prototype.process
+     * @description 执行 Turf.js 提供的相关空间分析方法。
+     * @param {string} type - Turf.js 提供的空间分析方法名。
+     * @param {Object} args - Turf.js 提供的空间分析方法对应的参数对象。
+     * @param {function} callback - 空间分析完成执行的回调函数，返回执行的结果。
+     * @param {boolean} addFeaturesToMap - 是否添加要素到地图。
+     */
+    process(type, args, callback, addFeaturesToMap) {
+        var result;
+        // 兼容版本4到5
+        try{
+            result = turf[type.split('.')[1]].apply(this, this.parse(type, args));
+        }catch(e){
+            result = turf[type.split('.')[1]].apply(this, this.parseOption(type, args));
+        }
+        
+        var features = null;
+        try {
+            features = (new GeoJSON()).readFeatures(result);
+        } catch (e) {
+            if (callback) {
+                callback(result);
+            }
+            return;
+        }
+        addFeaturesToMap = addFeaturesToMap == null ? true : addFeaturesToMap;
+        if (addFeaturesToMap) {
+            this.addFeatures(features);
+        }
+        if (callback) {
+            callback(result);
+        }
+    }
+
+    parse(type, args) {
+        if (type === 'Transformation.union') {
+            return args['A'];
+        }
+        var result = [];
+        var tempArgs = this.turfMap[type];
+        if (tempArgs) {
+            tempArgs.map(function (key) {
+                result.push(args[key]);
+                return args[key];
+            });
+        }
+        return result;
+    }
+
+    parseOption(type,args){
+        var result = [];
+        var tempArgs = this.turfOptionMap[type];
+        tempArgs.map(function(key){
+            if(key instanceof Object){
+                var options = key;
+                Object.keys(options).forEach(function(k){
+                    options[k]=args[k]
+                })
+                result.push(options);
+            }else{
+                result.push(args[key])
+            }
+            return args;
+        })
+        return result;
+    }
+
+}

package/overlay/Unique.js

@@ -0,0 +1,124 @@
+/* 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 as CommonUtil} from '@supermapgis/iclient-common/commontypes/Util';
+import { ShapeFactory } from '@supermapgis/iclient-common/overlay/feature/ShapeFactory';
+import { ThemeVector } from '@supermapgis/iclient-common/overlay/ThemeVector';
+import {GeoFeature} from './theme/GeoFeature';
+
+/**
+ * @class Unique
+ * @browsernamespace ol.source
+ * @category  Visualization Theme
+ * @classdesc 单值专题图图层源。单值专题图是利用不同的颜色或符号（线型、填充）表示图层中某一属性信息的不同属性值，属性值相同的要素具有相同的渲染风格。
+ * 比如土壤类型分布图、土地利用图、行政区划图等。单值专题图着重表示现象质的差别，一般不表示数量的特征。
+ * @modulecategory Overlay
+ * @param {string} name - 图层名称。
+ * @param {Object} opt_options - 参数。
+ * @param {ol.Map} opt_options.map - 当前 OpenLayers 地图对象。
+ * @param {string} [opt_options.id] - 专题图层 ID。默认使用 CommonUtil.createUniqueID("themeLayer_") 创建专题图层ID。
+ * @param {number} [opt_options.opacity=1] - 图层不透明度。
+ * @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 {Array} [opt_options.resolutions] - 分辨率数组。
+ * @param {ol.source.State} [opt_options.state] - 资源状态。
+ * @param {string} [opt_options.themeField] - 指定创建专题图字段。
+ * @param {Object} [opt_options.style] - 专题图样式。
+ * @param {Object} [opt_options.styleGroups] - 各专题类型样式组。
+ * @param {boolean} [opt_options.isHoverAble=false] - 是否开启 hover 事件。
+ * @param {Object} [opt_options.highlightStyle] - 开启 hover 事件后，触发的样式风格。
+ * @param {(string|Object)} [opt_options.attributions='Map Data <span>© <a href='http://support.supermap.com.cn/product/iServer.aspx' target='_blank'>SuperMap iServer</a></span> with <span>© <a href='https://iclient.supermap.io' target='_blank'>SuperMap iClient</a></span>'] - 版权描述信息。
+ * @extends {GeoFeature}
+ * @usage
+ */
+export class Unique extends GeoFeature {
+
+    constructor(name, opt_options) {
+        super(name, opt_options);
+        this.themeField = opt_options.themeField;
+        this.style = opt_options.style;
+        this.styleGroups = opt_options.styleGroups;
+        this.isHoverAble = opt_options.isHoverAble;
+        this.highlightStyle = opt_options.highlightStyle;
+    }
+
+    /**
+     * @function Unique.prototype.destroy
+     * @description 释放资源，将引用资源的属性置空。
+     */
+    destroy() {
+        this.style = null;
+        this.themeField = null;
+        this.styleGroups = null;
+        GeoFeature.prototype.destroy.apply(this, arguments);
+    }
+
+    /**
+     * @private
+     * @function Unique.prototype.createThematicFeature
+     * @description 创建专题要素。
+     * @param {Object} feature - 要素。
+     */
+    createThematicFeature(feature) {
+        var style = this.getStyleByData(feature);
+        //创建专题要素时的可选参数
+        var options = {};
+        options.nodesClipPixel = this.nodesClipPixel;
+        options.isHoverAble = this.isHoverAble;
+        options.isMultiHover = this.isMultiHover;
+        options.isClickAble = this.isClickAble;
+        options.highlightStyle = ShapeFactory.transformStyle(this.highlightStyle);
+        //将数据转为专题要素（ThemeVector）
+        var thematicFeature = new ThemeVector(feature, this, ShapeFactory.transformStyle(style), options);
+        //直接添加图形到渲染器
+        for (var m = 0; m < thematicFeature.shapes.length; m++) {
+            this.renderer.addShape(thematicFeature.shapes[m]);
+        }
+        return thematicFeature;
+    }
+
+    /**
+     * @private
+     * @function Unique.prototype.getStyleByData
+     * @description 根据用户数据（feature）设置专题要素的风格。
+     * @param {Object} fea - 用户要素数据。
+     */
+    getStyleByData(fea) {
+        var style = {};
+        var feature = fea;
+        style = CommonUtil.copyAttributesWithClip(style, this.style);
+        if (this.themeField && this.styleGroups && this.styleGroups.length > 0 && feature.attributes) {
+            var tf = this.themeField;
+            var Attrs = feature.attributes;
+            var Gro = this.styleGroups;
+            var isSfInAttrs = false; //指定的 themeField 是否是 feature 的属性字段之一
+            var attr = null; //属性值
+            for (var property in Attrs) {
+                if (tf === property) {
+                    isSfInAttrs = true;
+                    attr = Attrs[property];
+                    break;
+                }
+            }
+            //判断属性值是否属于styleGroups的某一个范围，以便对获取分组 style
+            if (isSfInAttrs) {
+                for (var i = 0, len = Gro.length; i < len; i++) {
+                    if ((attr).toString() === ( Gro[i].value).toString()) {
+                        //feature.style = CommonUtil.copyAttributes(feature.style, this.defaultStyle);
+                        var sty1 = Gro[i].style;
+                        style = CommonUtil.copyAttributesWithClip(style, sty1);
+                    }
+                }
+            }
+        }
+        if (feature.style && this.isAllowFeatureStyle === true) {
+            style = CommonUtil.copyAttributesWithClip(feature.style);
+        }
+        return style;
+    }
+
+    canvasFunctionInternal_(extent, resolution, pixelRatio, size, projection) { // eslint-disable-line no-unused-vars
+        return GeoFeature.prototype.canvasFunctionInternal_.apply(this, arguments);
+    }
+}