public abstract class

TiledLayer

extends Layer
implements PopupLayer
java.lang.Object
   ↳ com.esri.android.map.Layer
     ↳ com.esri.android.map.TiledLayer
Known Direct Subclasses
Known Indirect Subclasses

Class Overview

TiledLayer is the base class for all tiled layers that can be added to a map. You would typically work with one of the sub-classes of this abstract class, for example, ArcGISTiledMapServiceLayer.

You only need to use this class for adding support for new cached map services.

Summary

Fields
protected float bufferExpansionFactor
[Expand]
Inherited Fields
From class com.esri.android.map.Layer
Public Constructors
TiledLayer(String url, boolean initLayer)
Constructs a tiled layer.
TiledLayer(boolean initLayer)
Constructs a tiled layer.
Public Methods
void clearTiles()
Cancels all current tile request.
float getBrightness()
Gets the brightness of the TiledLayer.
float getBufferExpansionFactor()
Returns current buffer expansion factor.
float getContrast()
Gets the contrast of the TiledLayer.
int getCurrentLevel()
Returns the current the level of detail(LOD).
float getGamma()
Gets the gamma of the TiledLayer.
boolean isBufferEnabled()
Returns if the buffer is enabled for the tiled service.
boolean isPopupAllowGeometryUpdate(Feature feature)
Returns true if the popup allow the geometry to be updated, potentially based on some information carried by the Feature provided.
boolean isPopupDeletable(Feature feature)
Returns true if the popup created is deletable, potentially based on some information carried by the Feature provided.
boolean isPopupEditable(Feature feature)
Returns true if the popup created is editable, potentially based on some information carried by the Feature provided.
void setBrightness(float brightness)
Sets the brightness of the TiledLayer.
void setBufferEnabled(boolean bufferEnabled)
Enabling the buffer will result in an extra band of tiles being fetched outside the current map view.
void setBufferExpansionFactor(float factor)
Sets the buffer expansion factor.
void setContrast(float contrast)
Sets the contrast of the TiledLayer.
void setGamma(float gamma)
Sets the gamma of the TiledLayer.
void setRenderNativeResolution(boolean renderNativeResolution)
Sets to true to render the tiled layer in native resolution.
[Expand]
Inherited Methods
From class com.esri.android.map.Layer
From class java.lang.Object
From interface com.esri.android.map.popup.PopupLayer

Fields

protected float bufferExpansionFactor

Public Constructors

public TiledLayer (String url, boolean initLayer)

Constructs a tiled layer.

Parameters
url String: a valid URL string to create the layer
initLayer boolean: layer will be initialized if it is true

public TiledLayer (boolean initLayer)

Constructs a tiled layer.

Parameters
initLayer boolean: layer will be initialized if it is true

Public Methods

public void clearTiles ()

Cancels all current tile request. This method will cause the tiled layer to fetch new tiles in current extent and redraw.

public float getBrightness ()

Gets the brightness of the TiledLayer.

Returns
float Returns the brightness.

public float getBufferExpansionFactor ()

Returns current buffer expansion factor.

Returns
float the current buffer expansion factor

public float getContrast ()

Gets the contrast of the TiledLayer.

Returns
float Returns the contrast.

public int getCurrentLevel ()

Returns the current the level of detail(LOD). An negative number will be returned if the layer is not available anymore or the zoom level beyond the tile schema.

Returns
int an integer

public float getGamma ()

Gets the gamma of the TiledLayer.

Returns
float Returns the gamma.

public boolean isBufferEnabled ()

Returns if the buffer is enabled for the tiled service. See also setBufferEnabled(boolean)

Returns
boolean boolean

public boolean isPopupAllowGeometryUpdate (Feature feature)

Returns true if the popup allow the geometry to be updated, potentially based on some information carried by the Feature provided.

Returns
boolean

public boolean isPopupDeletable (Feature feature)

Returns true if the popup created is deletable, potentially based on some information carried by the Feature provided.

Returns
boolean

public boolean isPopupEditable (Feature feature)

Returns true if the popup created is editable, potentially based on some information carried by the Feature provided.

Returns
boolean

public void setBrightness (float brightness)

Sets the brightness of the TiledLayer.

Parameters
brightness float: The brightness to set.

public void setBufferEnabled (boolean bufferEnabled)

Enabling the buffer will result in an extra band of tiles being fetched outside the current map view. This makes panning operations cleaner as tiles will already be available. This is the default for all tiled services.

In some cases though when using multiple tiled services this may result in slower rendering times, so it may be desirable to turn off the buffer.

If the buffer is disabled, then the buffer expansion factor will not have any effect (see setBufferExpansionFactor(float))

Parameters
bufferEnabled boolean

public void setBufferExpansionFactor (float factor)

Sets the buffer expansion factor. The factor will affect the number of tiles to be fetched by setting the queried extent to a percentage of the visible extent. Tiles will be fetched for this expanded extent.

A value of 1.0f will only fetch tiles for the visible extent. A value of 2.0f will pull tiles for an extent that is twice the size of the visible extent, and so on.

If the buffer is disabled, then the buffer expansion factor will not have any effect (see setBufferEnabled(boolean))

Parameters
factor float: a float, the default value is 1.0f, the maximum number is 2.0f.

public void setContrast (float contrast)

Sets the contrast of the TiledLayer.

Parameters
contrast float: The contrast to set.

public void setGamma (float gamma)

Sets the gamma of the TiledLayer.

Parameters
gamma float: The gamma to set.

public void setRenderNativeResolution (boolean renderNativeResolution)

Sets to true to render the tiled layer in native resolution. This property does not have any effect on low-resolution devices. You can take advantage of high-resolution display to show more tile images on the screen by enabling this property. Enabling this property will use more memory and network bandwidth.

Parameters
renderNativeResolution boolean: true to enable rendering at native resolution.