@supermapgis/iclient-maplibregl/services/ChartService.js

@supermapgis/iclient-maplibregl 是一套基于 Maplibre GL 的云 GIS 网络客户端开发平台， 支持访问 SuperMap iServer / iEdge / iPortal / iManager / Online 的地图、服务和资源，为用户提供了完整专业的 GIS 能力， 同时提供了优秀的可视化功能。

/* Copyright© 2000 - 2026 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 {Util} from '../core/Util';
import { DataFormat } from '@supermapgis/iclient-common/REST';
import { ChartService as CommonChartService } from '@supermapgis/iclient-common/iServer/ChartService';

/**
 * @class ChartService
 * @category  iServer Map Chart
 * @classdesc 海图服务类。海图是一种以海洋水域及沿岸地物为主要绘制对象的地图，为航海的安全性提供必备的数据基础。<br>
  * 此类提供方法：获取海图物标信息、查询海图服务。海图物标信息指的是描述各产品规范的物标的基本信息，包括物标的名称、类型及与该物标相关的属性等。
 * @version 11.1.0
 * @modulecategory Services
 * @extends {ServiceBase}
 * @example
 * new ChartService(url,{
 *    fieldNameFormatter: function(fieldName){
 *      return fieldName + 'test'
 *    }
 * }).queryChart(param,function(result){
 *     //doSomething
 * })
 * @param {string} url - 服务地址。
 * @param {string} [dataUrl] - 数据服务地址。
 * @param {Object} options - 参数。
 * @param {string} [options.proxy] - 服务代理地址。
 * @param {boolean} [options.withCredentials] - 请求是否携带凭据。默认情况下，仅同源请求包含凭据。
 * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
 * @param {Object} [options.headers] - 请求头。
 * @param {function} [options.fieldNameFormatter] - 对查询返回结果的字段名进行自定义。
 * @usage
 */
export class ChartService extends ServiceBase {
    constructor(url, dataUrl, options) {
        super(url, dataUrl, options);
        this._chartService = new CommonChartService(url, dataUrl, options);
    }

    /**
     * @function ChartService.prototype.queryChart
     * @description 查询海图服务。
     * @param {ChartQueryParameters} params - 海图查询参数类。
     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
     * @param {DataFormat} [resultFormat=DataFormat.GEOJSON] - 返回结果类型。
     * @returns {Promise} Promise 对象。
     */
    queryChart(params, callback, resultFormat) {
      params = this._processParams(params);
      return this._chartService.queryChart(params, callback, resultFormat);
    }

    /**
     * @function ChartService.prototype.getChartFeatureInfo
     * @description 获取海图物标信息服务。
     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
     * @returns {Promise} Promise 对象。
     */
    getChartFeatureInfo(callback) {
      return this._chartService.getChartFeatureInfo(callback);
    }

    /**
     * @function ChartService.prototype.getChartAcronymClassify
     * @version 11.2.0
     * @description 获取海图产品规范物标分组信息服务。
     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的promise 获取结果。
     * @returns {Promise} Promise 对象。
     */
    getChartAcronymClassify(callback) {
      return this._chartService.getChartAcronymClassify(callback);
    }

    /**
    * @function ChartService.prototype.getChartWaterDepth
    * @version 12.1.0
    * @description 获取海图水深信息。
    * @param {ChartWaterDepthParameter} params - 海图水深查询所需参数类。
    * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
    * @returns {Promise} Promise 对象。
    */
    getChartWaterDepth(params, callback) {
      return this._chartService.getChartWaterDepth(params, callback);
    }

    /**
     * @function ChartService.prototype.getWaterLevel
     * @version 12.1.0
     * @description 获取S104海图水位和时间信息。
     * @param {ChartWaterLevelParameter} params - S104海图水位和时间查询所需参数类。
     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
     * @returns {Promise} Promise 对象。
     */
    getWaterLevel(params, callback) {
      params = this._processParams(params);
      return this._chartService.getWaterLevel(params, callback);
    }
  
    /**
     * @function ChartService.prototype.getWLTimeRange
     * @version 12.1.0
     * @description 获取S104海图时间范围。
     * @param {ChartWLTimeRangeParameter} params - S104海图时间范围查询所需参数类。
     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
     * @returns {Promise} Promise 对象。
     */
    getWLTimeRange(params, callback) {
      params = this._processParams(params);
      return this._chartService.getWLTimeRange(params, callback);
    }

    /**
     * @function ChartService.prototype.getChartMaritimePcInfo
     * @description 展示海图S100图示目录支持的版本和其参数信息。
     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
     * @returns {Promise} Promise 对象。
     */
    getChartMaritimePcInfo(callback) {
      return this._chartService.getChartMaritimePcInfo(callback);
    }

    _processParams(params) {
      if (!params) {
          return {};
      }
      params.returnContent = (params.returnContent == null) ? true : params.returnContent;
      if (params.chartQueryFilterParameters && !Util.isArray(params.chartQueryFilterParameters)) {
          params.chartQueryFilterParameters = [params.chartQueryFilterParameters];
      }

      if (params.bounds) {
          params.bounds = Util.toSuperMapBounds(params.bounds);
      }
      return params;
    }

    _processFormat(resultFormat) {
        return resultFormat ? resultFormat : DataFormat.GEOJSON;
    }
}