com.supermap.services.components.spi.ogc

接口 WMS

  • 所有已知实现类:
    DefaultWMS, WMSClient


    public interface WMS
    

    WMS 服务接口。

    WMS(Web Map Service,网络地图服务)是 OGC(Open GIS Consortium,开放地理信息系统协会)标准之一,该标准主要定义了用于创建和显示地图图像的三大操作,包括:

    1. GetCapabilities,该操作用于获取服务级元数据。该操作是必需的。
    2. GetMap,核心操作,该操作用于获取地理空间参数和大小已明确定义的地图图像。该操作是必需的。
    3. GetFeatureInfo,该操作用于获取显示在地图上的某些特殊要素(feature)的信息。该操作可选择。
    • 方法详细资料

      • getCapabilities

        WMSCapabilities getCapabilities(java.lang.String version)
                                        throws OGCException
        

        获取 WMS 服务级元数据。

        该方法用于获取服务元数据,元数据用于描述服务器信息内容和可接受的请求参数值,是一种机器可读(并适合人阅读)的描述。

        参数:
        version - WMS 服务版本号。
        返回:
        WMSCapabilities 对象。
        抛出:
        OGCException - OGC 异常信息。
      • getFeatureInfo

        WMSFeatureInfo[] getFeatureInfo(java.lang.String version,
                                      WMSQueryParameter wmsQueryParam)
                                        throws OGCException
        

        获取地物要素信息。

        该方法用于获取地图上要素的信息,地图是通过 GetMap 操作返回的,因此,要访问 GetFeatureInfo 操作应该先访问 GetMap 操作获取地图,用户在获取的地图上选取一个点(point(i, j))来查询更加丰富的信息。用户可以指定要查询的像素、查询的图层以及返回信息的格式等。

        该操作对于 queryable 属性为“1”的图层有效,对于其他图层客户端不能发送 GetFeatureInfo 操作请求。当 WMS 服务接收到不支持的 GetFeatureInfo 操作请求时,会返回服务异常信息。

        参数:
        version - WMS 服务版本号。
        wmsQueryParam - WMS 查询参数。
        返回:
        WMSFeatureInfo 数组。
        抛出:
        OGCException - OGC 异常信息。
      • getMap

        byte[] getMap(java.lang.String version,
                    WMSMapParameter wmsMapParam)
                      throws OGCException
        

        获取地图图片的二进制流。

        参数:
        version - WMS 服务版本号。
        wmsMapParam - WMS 地图参数。
        返回:
        地图图片的二进制流。
        抛出:
        OGCException - OGC 异常信息。
      • getLegendGraphic

        byte[] getLegendGraphic(java.lang.String version,
                              WMSMapParameter wmsMapParam)
                                throws MapException
        

        获取图例图片的二进制流。

        参数:
        version - WMS 服务版本号。
        wmsMapParam - WMS 地图参数。
        返回:
        图例图片的二进制流。
        抛出:
        MapException - 异常信息。