@ciniki/iclient-maplibregl/services/MapService.js

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

/* Copyright© 2000 - 2025 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 '@ciniki/iclient-common/commontypes/Util';
import { MapService as CommonMapService } from '@ciniki/iclient-common/iServer/MapService';
import { TilesetsService } from '@ciniki/iclient-common/iServer/TilesetsService';

/**
 * @class MapService
 * @category  iServer Map
 * @classdesc 地图信息服务类。通过该类可以获得地图的基本信息、投影信息、切片列表信息等等。
 * @version 11.1.0
 * @modulecategory Services
 * @extends {ServiceBase}
 * @param {string} url - 服务地址。
 * @param {Object} options - 参数。
 * @param {string} [options.proxy] - 服务代理地址。
 * @param {boolean} [options.withCredentials=false] - 请求是否携带 cookie。
 * @param {boolean} [options.crossOrigin] - 是否允许跨域请求。
 * @param {Object} [options.headers] - 请求头。
 * @example
 * new MapService(url)
 *  .getMapInfo(function(result){
 *     //doSomething
 * })
 * @usage
 */
export class MapService extends ServiceBase {

    constructor(url, options) {
        super(url, options);
    }

    /**
     * @function MapService.prototype.getMapInfo
     * @description 地图信息查询服务。
     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
     * @returns {Promise} Promise 对象。
     */
    getMapInfo(callback) {
        var me = this;
        var getMapStatusService = new CommonMapService(me.url, {
            proxy: me.options.proxy,
            withCredentials: me.options.withCredentials,
            crossOrigin: me.options.crossOrigin,
            headers: me.options.headers,
            projection: me.options.projection
        });
        return getMapStatusService.processAsync(callback);
    }

    /**
     * @function MapService.prototype.getWKT
     * @description 获取WKT。
     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
     * @returns {Promise} Promise 对象。
     */
    getWKT(callback) {
      var me = this;
      var getMapStatusService = new CommonMapService(Util.urlPathAppend(me.url,'prjCoordSys.wkt'), {
          proxy: me.options.proxy,
          withCredentials: me.options.withCredentials,
          withoutFormatSuffix: true,
          crossOrigin: me.options.crossOrigin,
          headers: me.options.headers,
          projection: me.options.projection
      });
      return getMapStatusService.processAsync(callback);
    }

    /**
     * @function MapService.prototype.getTilesets
     * @description 切片列表信息查询服务。
     * @param {RequestCallback} [callback] 回调函数，该参数未传时可通过返回的 promise 获取结果。
     * @returns {Promise} Promise 对象。
     */
    getTilesets(callback) {
        var me = this;
        var tilesetsService = new TilesetsService(me.url, {
            proxy: me.options.proxy,
            withCredentials: me.options.withCredentials,
            crossOrigin: me.options.crossOrigin,
            headers: me.options.headers
        });
        return tilesetsService.processAsync(callback);
    }
}