fix 几何分析 api

xilanhuaweidapao · xilanhuaweidapao · commit a55234b91e89 · 2024-06-28T16:13:28.000+08:00
diff --git a/examples/leaflet/ugc_buffer.html b/examples/leaflet/ugc_buffer.html
@@ -40,8 +40,8 @@ <h5 class="panel-title text-center">缓冲区分析</h5>
       <div class="panel-body content">
         <div class="panel">
           <div class="input-group">
-            <span class="input-group-addon">缓冲区半径(米)</span>
-            <input class="form-control" id="radius" type="number" value="300000" />
+            <span class="input-group-addon">缓冲区半径(度)</span>
+            <input class="form-control" id="radius" type="number" value="2" />
           </div>
         </div>
         <input type="button" class="btn btn-default" value="分析" onclick="createUGCBuffer()" />&nbsp;
@@ -81,7 +81,7 @@ <h5 class="panel-title text-center">缓冲区分析</h5>
         clearLayer();
         var radius = parseFloat(document.getElementById('radius').value);
         var geometryAnalysis = new L.supermap.GeometryAnalysis();
-        var res = geometryAnalysis.buffer(pointGeometryData, radius / 100000);
+        var res = geometryAnalysis.buffer(pointGeometryData, radius);
         bufferLayer = L.geoJSON(res);
         bufferLayer.addTo(map);
       }
diff --git a/examples/leaflet/ugc_computeParallel.html b/examples/leaflet/ugc_computeParallel.html
@@ -40,7 +40,7 @@ <h5 class="panel-title text-center">根据设置距离获取直线平行线</h5>
       <div class="panel-body content">
         <div class="panel">
           <div class="input-group">
-            <span class="input-group-addon">线距(米)</span>
+            <span class="input-group-addon">线距(度)</span>
             <input class="form-control" id="distance" type="number" value="5" />
           </div>
         </div>
diff --git a/examples/mapboxgl/ugc_buffer.html b/examples/mapboxgl/ugc_buffer.html
@@ -40,8 +40,8 @@ <h5 class="panel-title text-center">缓冲区分析</h5>
       <div class="panel-body content">
         <div class="panel">
           <div class="input-group">
-            <span class="input-group-addon">缓冲区半径(米)</span>
-            <input class="form-control" id="radius" type="number" value="30000" />
+            <span class="input-group-addon">缓冲区半径(度)</span>
+            <input class="form-control" id="radius" type="number" value="2" />
           </div>
         </div>
         <input type="button" class="btn btn-default" value="分析" onclick="createBuffer()" />&nbsp;
@@ -102,7 +102,7 @@ <h5 class="panel-title text-center">缓冲区分析</h5>
         clearLayer();
         var radius = parseFloat(document.getElementById('radius').value);
         var geometryAnalysis = new mapboxgl.supermap.GeometryAnalysis();
-        var res = geometryAnalysis.buffer(pointGeometryData, radius / 100000);
+        var res = geometryAnalysis.buffer(pointGeometryData, radius);
         var bufferSource = {
           type: 'geojson',
           data: res
diff --git a/examples/mapboxgl/ugc_computeParallel.html b/examples/mapboxgl/ugc_computeParallel.html
@@ -40,7 +40,7 @@ <h5 class="panel-title text-center">根据设置距离获取直线平行线</h5>
       <div class="panel-body content">
         <div class="panel">
           <div class="input-group">
-            <span class="input-group-addon">线距(米)</span>
+            <span class="input-group-addon">线距(度)</span>
             <input class="form-control" id="distance" type="number" value="5" />
           </div>
         </div>
diff --git a/examples/maplibregl/ugc_buffer.html b/examples/maplibregl/ugc_buffer.html
@@ -40,8 +40,8 @@ <h5 class="panel-title text-center">缓冲区分析</h5>
       <div class="panel-body content">
         <div class="panel">
           <div class="input-group">
-            <span class="input-group-addon">缓冲区半径(米)</span>
-            <input class="form-control" id="radius" type="number" value="30000" />
+            <span class="input-group-addon">缓冲区半径(度)</span>
+            <input class="form-control" id="radius" type="number" value="2" />
           </div>
         </div>
         <input type="button" class="btn btn-default" value="分析" onclick="createBuffer()" />&nbsp;
@@ -102,7 +102,7 @@ <h5 class="panel-title text-center">缓冲区分析</h5>
         clearLayer();
         var radius = parseFloat(document.getElementById('radius').value);
         var geometryAnalysis = new maplibregl.supermap.GeometryAnalysis();
-        var res = geometryAnalysis.buffer(pointGeometryData, radius / 100000);
+        var res = geometryAnalysis.buffer(pointGeometryData, radius);
         var bufferSource = {
           type: 'geojson',
           data: res
diff --git a/examples/maplibregl/ugc_computeParallel.html b/examples/maplibregl/ugc_computeParallel.html
@@ -40,7 +40,7 @@ <h5 class="panel-title text-center">根据设置距离获取直线平行线</h5>
       <div class="panel-body content">
         <div class="panel">
           <div class="input-group">
-            <span class="input-group-addon">线距(米)</span>
+            <span class="input-group-addon">线距(度)</span>
             <input class="form-control" id="distance" type="number" value="5" />
           </div>
         </div>
diff --git a/examples/openlayers/ugc_buffer.html b/examples/openlayers/ugc_buffer.html
@@ -40,8 +40,8 @@ <h5 class="panel-title text-center">缓冲区分析</h5>
       <div class="panel-body content">
         <div class="panel">
           <div class="input-group">
-            <span class="input-group-addon">缓冲区半径(米)</span>
-            <input class="form-control" id="radius" type="number" value="300000" />
+            <span class="input-group-addon">缓冲区半径(度)</span>
+            <input class="form-control" id="radius" type="number" value="2" />
           </div>
         </div>
         <input type="button" class="btn btn-default" value="分析" onclick="createBuffer()" />&nbsp;
@@ -98,7 +98,7 @@ <h5 class="panel-title text-center">缓冲区分析</h5>
               type: 'Point'
             }
           },
-          radius / 100000
+          radius
         );
         polygon = new ol.geom.Polygon(res.geometry.coordinates);
         var polygonSource = new ol.source.Vector({
diff --git a/examples/openlayers/ugc_computeParallel.html b/examples/openlayers/ugc_computeParallel.html
@@ -40,7 +40,7 @@ <h5 class="panel-title text-center">根据设置距离获取直线平行线</h5>
       <div class="panel-body content">
         <div class="panel">
           <div class="input-group">
-            <span class="input-group-addon">线距(米)</span>
+            <span class="input-group-addon">线距(度)</span>
             <input class="form-control" id="distance" type="number" value="5" />
           </div>
         </div>
diff --git a/src/common/util/GeometryAnalysis.js b/src/common/util/GeometryAnalysis.js
@@ -47,7 +47,7 @@ export class GeometryAnalysis extends Events {
    * @version 11.2.0
    * @description 缓冲区分析。
    * @param {GeoJSONFeature} feature - geojson 要素。
-   * @param {number} radius - 缓冲区距离。
+   * @param {number} radius - 缓冲区距离，单位与数据单位一致。
    * @returns {GeoJSONFeature} 结果要素。
    */
   buffer(feature, radius) {
@@ -347,7 +347,7 @@ export class GeometryAnalysis extends Events {
    * @version 11.2.0
    * @description 计算经纬度面积。
    * @param {GeoJSONFeature} feature - geojson 面要素。
-   * @returns {number} 经纬度面积。
+   * @returns {number} 经纬度面积，结果单位与参数单位一致。
    */
   computeGeodesicArea(feature) {
     const ugFeature = geojson2UGGeometry(feature);
@@ -376,9 +376,9 @@ export class GeometryAnalysis extends Events {
    * @description 计算测地线长度。
    * @param {Array} xArray - x 坐标数组。
    * @param {Array} yArray - y 坐标数组。
-   * @param {number} majorAxis - 测地线所在椭球体的长轴。
+   * @param {number} majorAxis - 测地线所在椭球体的长轴，单位为米。
    * @param {number} flatten - 测地线所在椭球体的扁率。
-   * @returns {number} 测地线的长度。
+   * @returns {number} 测地线的长度，结果单位为米。
    */
   computeGeodesicDistance(xArray, yArray, majorAxis, flatten) {
     let pXArray = geojsonCoords2UGDoubleArray(xArray);
@@ -390,7 +390,7 @@ export class GeometryAnalysis extends Events {
    * @version 11.2.0
    * @description 根据距离获取线要素的平行线。
    * @param {GeoJSONFeature} feature - geojson 要素。
-   * @param {number} distance - 平行线距离。
+   * @param {number} distance - 平行线距离，单位与数据单位一致。
    * @returns {GeoJSONFeature} 结果要素。
    */
   computeParallel(feature, distance) {
