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）的信息。该操作可选择。

方法概要

方法

限定符和类型	方法和说明
WMSCapabilities	getCapabilities(java.lang.String version) 获取 WMS 服务级元数据。
WMSFeatureInfo[]	getFeatureInfo(java.lang.String version, WMSQueryParameter wmsQueryParam) 获取地物要素信息。
byte[]	getLegendGraphic(java.lang.String version, WMSMapParameter wmsMapParam) 获取图例图片的二进制流。
byte[]	getMap(java.lang.String version, WMSMapParameter wmsMapParam) 获取地图图片的二进制流。

方法详细资料

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 - 异常信息。