com.luciad.ogc.wmts.client

LuciadLightspeedClass TLcdWMTSClient

java.lang.Object

com.luciad.ogc.wmts.client.TLcdWMTSClient

public class TLcdWMTSClient
extends Object

Client that can be used to connect to OGC WMTS (Web Map Tile Service) servers. The supported WMTS version is 1.0.0 .

To create ILcdModels that can be used in LuciadLightspeed views, you can use TLcdWMTSModelDecoder.

This client connects to the WMTS once. If you need to refresh the capabilities, create a new client.

You can list the available WMTS layers.

Limitations on what WMTS layers are supported are described here.

Since:

2013.0

See Also:

TLcdWMTSModelDecoder

Constructor Summary

Constructors

Constructor and Description
TLcdWMTSClient(URI aUri) Create a client.
TLcdWMTSClient(URI aUri, ILcdOWSTransport aTransport) Create a client.
TLcdWMTSClient(URI aUri, ILcdTransport aTransport) Create a client.

Method Summary

Modifier and Type	Method and Description
TLcdOWSCapabilitiesBase	getCapabilities() Returns the capabilities of the WMTS.
TLcdOWSInputStream	getFeatureInfo(TLcdWMTSGetFeatureInfoContext aContext) Performs the 'GetFeatureInfo' request.
Collection<TLcdWMTSLayer>	getLayers() Returns the layers available on the WMTS server, as well as their exposed formats and styles.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TLcdWMTSClient

public TLcdWMTSClient(URI aUri)
               throws TLcdOWSDecodingException,
                      TLcdOWSTransportException,
                      TLcdOWSServerException,
                      TLcdOWSUnsupportedVersionException

Create a client. The client automatically connects to the server at the given URI.

Parameters:

aUri - The URI of the WMTS server

Throws:

TLcdOWSDecodingException

TLcdOWSTransportException

TLcdOWSServerException

TLcdOWSUnsupportedVersionException

TLcdWMTSClient

public TLcdWMTSClient(URI aUri,
                      ILcdTransport aTransport)
               throws TLcdOWSDecodingException,
                      TLcdOWSTransportException,
                      TLcdOWSServerException,
                      TLcdOWSUnsupportedVersionException

Create a client. The client automatically connects to the server at the given URI.

Parameters:

aUri - The URI of the WMTS server

aTransport - The transport used to do the connections to the server.

Throws:

TLcdOWSDecodingException

TLcdOWSTransportException

TLcdOWSServerException

TLcdOWSUnsupportedVersionException

See Also:

TLcdTransportFactory: create a default transport

TLcdWMTSClient

public TLcdWMTSClient(URI aUri,
                      ILcdOWSTransport aTransport)
               throws TLcdOWSDecodingException,
                      TLcdOWSTransportException,
                      TLcdOWSServerException,
                      TLcdOWSUnsupportedVersionException

Create a client. The client automatically connects to the server at the given URI.

Parameters:

aUri - The URI of the WMTS server

aTransport - The transport used to do the connections to the server.

Throws:

TLcdOWSDecodingException

TLcdOWSTransportException

TLcdOWSServerException

TLcdOWSUnsupportedVersionException

See Also:

TLcdOWSHTTPTransport: the default OWS transport

Method Detail

getCapabilities

public TLcdOWSCapabilitiesBase getCapabilities()

Returns the capabilities of the WMTS.

Subsequent calls will always return the same capabilities, it does not re-connect to the WMTS to refresh the capabilities.

If you need to refresh the capabilities, create a new client.

Returns:

The capabilities of the WMTS.

getFeatureInfo

public TLcdOWSInputStream getFeatureInfo(TLcdWMTSGetFeatureInfoContext aContext)
                                  throws TLcdOWSDecodingException,
                                         TLcdOWSTransportException,
                                         TLcdOWSServerException

Performs the 'GetFeatureInfo' request.

Parameters:

aContext - The context object containing the GetFeatureInfo parameters

Returns:

An input stream containing the data returned by the WMTS server

Throws:

TLcdOWSDecodingException - If an error occurred while decoding the 'GetFeatureInfo' response

TLcdOWSTransportException - If an error occurred in the transport while accessing the web service

TLcdOWSServerException - If the server returned a service exception

Since:

2021.0

getLayers

public Collection<TLcdWMTSLayer> getLayers()

Returns the layers available on the WMTS server, as well as their exposed formats and styles.

Use TLcdWMTSLayer.isTileStructureQuadTree() to check if a layer can be visualized at the full detail it exposes.

Returns:

The layers available on the WMTS server.