com.supermap.services.components.spi.ogc

Interface WMS

All Known Implementing Classes:

DefaultWMS, WMSClient

public interface WMS

WMS Service Interface.

WMS (Web Map Service) is one of the OGC (Open GIS Consortium) standards, which define three major operations for creating and displaying map images, including:

1. GetCapabilities, The operation is used to obtain service-level metadata. The operation is necessary.
2. GetMap, The core operation, the operation used to obtain the map image which the geospatial parameters and size has been clearly defined. The operation is necessary.
3. GetFeatureInfo, The operation is used to obtain information about some of the special features displayed on the map. This operation is optional.

Method Summary

Methods

Modifier and Type	Method and Description
WMSCapabilities	getCapabilities(java.lang.String version) Get WMS service meta data.
WMSFeatureInfo[]	getFeatureInfo(java.lang.String version, WMSQueryParameter wmsQueryParam) Get the feature information.
byte[]	getMap(java.lang.String version, WMSMapParameter wmsMapParam) Get the binary stream of the map tiles.

Method Detail

getCapabilities

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

Get WMS service meta data.

The method is used to obtain the service metadata, and the metadata is used to describe the server information content and the acceptable request parameter value, which is a machine readable (and suitable for people to read) description.

Parameters:

version - WMS service version.

Returns:

WMSCapabilities object.

Throws:

OGCException - OGC exception information.

getFeatureInfo

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

Get the feature information.

This method is used to get the map element information, and the map is returned by the GetMap operation, therefore, to access the GetFeatureInfo operation should first visit the GetMap operation to obtain the map, the user selects a point in the acquired map (point (i, j)) for more information. The user can specify the pixels to be searched, the layers of the query, and the format of the returned information.

The operation is valid for the layer whose queryable attribute is "1", for other layers the client can not send GetFeatureInfo operation request. When the WMS service receives an unsupported GetFeatureInfo

Parameters:

version - WMS service version.

wmsQueryParam - WMS query parameters.

Returns:

WMSFeatureInfo array.

Throws:

OGCException - OGC exception information.

getMap

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

Get the binary stream of the map tiles.

Parameters:

version - WMS service version.

wmsMapParam - WMS map parameters.

Returns:

The binary stream of the map tiles.

Throws:

OGCException - OGC exception information.