UrlTileProvider

AI-generated Key Takeaways

• UrlTileProvider is a partial implementation of TileProvider that uses a URL pointing to an image for tiles.

• All images used with UrlTileProvider must have the same dimensions.

• The getTileUrl method is abstract and must be implemented to return the URL for a specific tile.

• The getTile method returns a Tile object for a given coordinate and zoom level, loading the image from the URL provided by getTileUrl.

• NO_TILE is a stub tile indicating that no tile exists for a specific coordinate.

public abstract class UrlTileProvider extends Object
implements TileProvider

A partial implementation of TileProvider that only requires a URL that points to an image to be provided.

Note that this class requires that all the images have the same dimensions.

Inherited Field Summary

From interface com.google.android.gms.maps.model.TileProvider

public static final Tile

NO_TILE

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

Public Constructor Summary

UrlTileProvider(int width, int height) Constructs a UrlTileProvider.

Public Method Summary

final Tile	getTile(int x, int y, int zoom) Returns the Tile to be used for this tile coordinate.
abstract URL	getTileUrl(int x, int y, int zoom) Returns a URL that points to the image to be used for this tile.

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

From interface com.google.android.gms.maps.model.TileProvider

abstract Tile

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

Public Constructors

public UrlTileProvider (int width, int height)

Constructs a UrlTileProvider.

Parameters

width	width of the images used for tiles
height	height of the images used for tiles

Public Methods

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

Returns the Tile to be used for this tile coordinate. The image tile loaded through getTileUrl(int, int, int).

Parameters

x	The x coordinate of the tile. This will be in the range [0, 2^zoom - 1] inclusive.
y	The y coordinate of the tile. This will be in the range [0, 2^zoom - 1] inclusive.
zoom	The zoom level of the tile. This will be in the range [ GoogleMap.getMinZoomLevel, GoogleMap.getMaxZoomLevel] inclusive.

Returns

• The image tile loaded through getTileUrl(int, int, int). TileProvider.NO_TILE if getTileUrl(int, int, int) is null; null if failed to load the tile.

public abstract URL getTileUrl (int x, int y, int zoom)

Returns a URL that points to the image to be used for this tile. If no image is found on the initial request, further requests will be made with an exponential backoff. If you do not wish to provide an image for this tile coordinate, return null.

Parameters

x	The x coordinate of the tile. This will be in the range [0, 2^zoom - 1] inclusive.
y	The y coordinate of the tile. This will be in the range [0, 2^zoom - 1] inclusive.
zoom	The zoom level of the tile. This will be in the range [ GoogleMap.getMinZoomLevel, GoogleMap.getMaxZoomLevel] inclusive.

Returns

• URL a URL that points to the image to be used for this tile. If you do not wish to provide an image for this tile coordinate, return null.