org.oscim.core

Class Tile

java.lang.Object

org.oscim.core.Tile

Direct Known Subclasses:

MapTile

public class Tile
extends java.lang.Object

A tile represents a rectangular part of the world map. All tiles can be identified by their X and Y number together with their zoom level. The actual area that a tile covers on a map depends on the underlying map projection.

Field Summary

Fields

Modifier and Type	Field and Description
long	mapSize the map size implied by zoom level and tileSize, to avoid multiple computations.
static int	SIZE Width and height of a map tile in pixels.
static int	TILE_SIZE_MULTIPLE Tile size multiple in pixels.
int	tileX The X number of this tile.
int	tileY The Y number of this tile.
byte	zoomLevel The Zoom level of this tile.

Constructor Summary

Constructors

Constructor and Description
Tile(int tileX, int tileY, byte zoomLevel)

Method Summary

Modifier and Type	Method and Description
static int	calculateTileSize() Calculate tile size (256px) with a scale factor.
boolean	equals(java.lang.Object obj)
BoundingBox	getBoundingBox() Gets the geographic extend of this Tile as a BoundingBox.
static BoundingBox	getBoundingBox(Tile upperLeft, Tile lowerRight) Return the BoundingBox of a rectangle of tiles defined by upper left and lower right tile.
static int	getMaxTileNumber(byte zoomLevel)
Point	getOrigin() Returns the top-left point of this tile in absolute coordinates.
int	hashCode()
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

SIZE

public static int SIZE

Width and height of a map tile in pixels.

TILE_SIZE_MULTIPLE

public static int TILE_SIZE_MULTIPLE

Tile size multiple in pixels.

mapSize

public final long mapSize

the map size implied by zoom level and tileSize, to avoid multiple computations.

tileX

public final int tileX

The X number of this tile.

tileY

public final int tileY

The Y number of this tile.

zoomLevel

public final byte zoomLevel

The Zoom level of this tile.

Constructor Detail

Tile

public Tile(int tileX,
            int tileY,
            byte zoomLevel)

Parameters:

tileX - the X number of the tile.

tileY - the Y number of the tile.

zoomLevel - the zoom level of the tile.

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

calculateTileSize

public static int calculateTileSize()

Calculate tile size (256px) with a scale factor. Clamp tile size to a preset multiple, e.g. 64px.

getBoundingBox

public BoundingBox getBoundingBox()

Gets the geographic extend of this Tile as a BoundingBox.

Returns:

boundaries of this tile.

getBoundingBox

public static BoundingBox getBoundingBox(Tile upperLeft,
                                         Tile lowerRight)

Return the BoundingBox of a rectangle of tiles defined by upper left and lower right tile.

Parameters:

upperLeft - tile in upper left corner.

lowerRight - tile in lower right corner.

Returns:

BoundingBox defined by the area around upperLeft and lowerRight Tile.

getMaxTileNumber

public static int getMaxTileNumber(byte zoomLevel)

Returns:

the maximum valid tile number for the given zoom level, 2^zoomLevel -1.

getOrigin

public Point getOrigin()

Returns the top-left point of this tile in absolute coordinates.

Returns:

the top-left point