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 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.