TileProvider

  • TileProvider is an interface for classes that provide tile images for a TileOverlay on a map.

  • Implementations of this interface must be thread-safe as calls may come from multiple threads.

  • The core functionality is providing a Tile for a given tile coordinate (x, y, zoom) via the getTile method.

  • NO_TILE is a constant used to indicate that no tile exists for a specific coordinate.

  • UrlTileProvider is a convenient subclass for providing tiles from a URL.
public interface TileProvider
Known Indirect Subclasses

An interface for a class that provides the tile images for a TileOverlay. For information about the tile coordinate system, see TileOverlay.

Calls to methods in this interface might be made from multiple threads so implementations of this interface must be threadsafe.

Field Summary

public static final Tile NO_TILE Stub tile that is used to indicate that no tile exists for a specific tile coordinate.

Public Method Summary

abstract Tile
getTile(int x, int y, int zoom)
Returns the tile to be used for this tile coordinate.

Fields

public static final Tile NO_TILE

Stub tile that is used to indicate that no tile exists for a specific tile coordinate.

Public Methods

public abstract Tile getTile (int x, int y, int zoom)

Returns the tile to be used for this tile coordinate.

Parameters
x The x coordinate of the tile. This will be in the range [0, 2zoom - 1] inclusive.
y The y coordinate of the tile. This will be in the range [0, 2zoom - 1] inclusive.
zoom The zoom level of the tile. This will be in the range [ GoogleMap.getMinZoomLevel, GoogleMap.getMaxZoomLevel] inclusive.
Returns
  • the Tile to be used for this tile coordinate. If you do not wish to provide a tile for this tile coordinate, return NO_TILE. If the tile could not be found at this point in time, return null and further requests might be made with an exponential backoff.