microsoft.mappoint

Class TileSystem

java.lang.Object

microsoft.mappoint.TileSystem

public final class TileSystem
extends Object

This class provides methods to handle the Mercator projection that is used for the osmdroid tile system.

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	mTileSize

Constructor Summary

Constructors

Constructor and Description
TileSystem()

Method Summary

Modifier and Type	Method and Description
static int	getMaximumZoomLevel()
static int	getTileSize()
static double	GroundResolution(double latitude, int levelOfDetail) Determines the ground resolution (in meters per pixel) at a specified latitude and level of detail.
static Point	LatLongToPixelXY(double latitude, double longitude, int levelOfDetail, Point reuse) Converts a point from latitude/longitude WGS-84 coordinates (in degrees) into pixel XY coordinates at a specified level of detail.
static double	MapScale(double latitude, int levelOfDetail, int screenDpi) Determines the map scale at a specified latitude, level of detail, and screen resolution.
static int	MapSize(int levelOfDetail) Determines the map width and height (in pixels) at a specified level of detail.
static GeoPoint	PixelXYToLatLong(int pixelX, int pixelY, int levelOfDetail, GeoPoint reuse) Converts a pixel from pixel XY coordinates at a specified level of detail into latitude/longitude WGS-84 coordinates (in degrees).
static Point	PixelXYToTileXY(int pixelX, int pixelY, Point reuse) Converts pixel XY coordinates into tile XY coordinates of the tile containing the specified pixel.
static Point	QuadKeyToTileXY(String quadKey, Point reuse) Converts a QuadKey into tile XY coordinates.
static void	setTileSize(int tileSize)
static Point	TileXYToPixelXY(int tileX, int tileY, Point reuse) Converts tile XY coordinates into pixel XY coordinates of the upper-left pixel of the specified tile.
static String	TileXYToQuadKey(int tileX, int tileY, int levelOfDetail) Converts tile XY coordinates into a QuadKey at a specified level of detail.

Methods inherited from class java.lang.Object

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

Field Detail

mTileSize

protected static int mTileSize

Constructor Detail

TileSystem

public TileSystem()

Method Detail

setTileSize

public static void setTileSize(int tileSize)

getTileSize

public static int getTileSize()

getMaximumZoomLevel

public static int getMaximumZoomLevel()

MapSize

public static int MapSize(int levelOfDetail)

Determines the map width and height (in pixels) at a specified level of detail.

Parameters:

levelOfDetail - Level of detail, from 1 (lowest detail) to 23 (highest detail)

Returns:

The map width and height in pixels

GroundResolution

public static double GroundResolution(double latitude,
                                      int levelOfDetail)

Determines the ground resolution (in meters per pixel) at a specified latitude and level of detail.

Parameters:

latitude - Latitude (in degrees) at which to measure the ground resolution

levelOfDetail - Level of detail, from 1 (lowest detail) to 23 (highest detail)

Returns:

The ground resolution, in meters per pixel

MapScale

public static double MapScale(double latitude,
                              int levelOfDetail,
                              int screenDpi)

Determines the map scale at a specified latitude, level of detail, and screen resolution.

Parameters:

latitude - Latitude (in degrees) at which to measure the map scale

levelOfDetail - Level of detail, from 1 (lowest detail) to 23 (highest detail)

screenDpi - Resolution of the screen, in dots per inch

Returns:

The map scale, expressed as the denominator N of the ratio 1 : N

LatLongToPixelXY

public static Point LatLongToPixelXY(double latitude,
                                     double longitude,
                                     int levelOfDetail,
                                     Point reuse)

Converts a point from latitude/longitude WGS-84 coordinates (in degrees) into pixel XY coordinates at a specified level of detail.

Parameters:

latitude - Latitude of the point, in degrees

longitude - Longitude of the point, in degrees

levelOfDetail - Level of detail, from 1 (lowest detail) to 23 (highest detail)

reuse - An optional Point to be recycled, or null to create a new one automatically

Returns:

Output parameter receiving the X and Y coordinates in pixels

PixelXYToLatLong

public static GeoPoint PixelXYToLatLong(int pixelX,
                                        int pixelY,
                                        int levelOfDetail,
                                        GeoPoint reuse)

Converts a pixel from pixel XY coordinates at a specified level of detail into latitude/longitude WGS-84 coordinates (in degrees).

Parameters:

pixelX - X coordinate of the point, in pixels

pixelY - Y coordinate of the point, in pixels

levelOfDetail - Level of detail, from 1 (lowest detail) to 23 (highest detail)

reuse - An optional GeoPoint to be recycled, or null to create a new one automatically

Returns:

Output parameter receiving the latitude and longitude in degrees.

PixelXYToTileXY

public static Point PixelXYToTileXY(int pixelX,
                                    int pixelY,
                                    Point reuse)

Converts pixel XY coordinates into tile XY coordinates of the tile containing the specified pixel.

Parameters:

pixelX - Pixel X coordinate

pixelY - Pixel Y coordinate

reuse - An optional Point to be recycled, or null to create a new one automatically

Returns:

Output parameter receiving the tile X and Y coordinates

TileXYToPixelXY

public static Point TileXYToPixelXY(int tileX,
                                    int tileY,
                                    Point reuse)

Converts tile XY coordinates into pixel XY coordinates of the upper-left pixel of the specified tile.

Parameters:

tileX - Tile X coordinate

tileY - Tile X coordinate

reuse - An optional Point to be recycled, or null to create a new one automatically

Returns:

Output parameter receiving the pixel X and Y coordinates

TileXYToQuadKey

public static String TileXYToQuadKey(int tileX,
                                     int tileY,
                                     int levelOfDetail)

Converts tile XY coordinates into a QuadKey at a specified level of detail.

Parameters:

tileX - Tile X coordinate

tileY - Tile Y coordinate

levelOfDetail - Level of detail, from 1 (lowest detail) to 23 (highest detail)

Returns:

A string containing the QuadKey

QuadKeyToTileXY

public static Point QuadKeyToTileXY(String quadKey,
                                    Point reuse)

Converts a QuadKey into tile XY coordinates.

Parameters:

quadKey - QuadKey of the tile

reuse - An optional Point to be recycled, or null to create a new one automatically

Returns:

Output parameter receiving the tile X and y coordinates