pt.lsts.neptus.util.coord

Class MapTileUtil

java.lang.Object

pt.lsts.neptus.util.coord.MapTileUtil

public class MapTileUtil
extends java.lang.Object

See http://msdn.microsoft.com/en-us/library/bb259689.aspx Copyright (c) 2006-2009 Microsoft Corporation. All rights reserved.

Field Summary

Fields

Modifier and Type	Field and Description
static double	EARTH_RADIUS
static int	LEVEL_MAX
static int	LEVEL_MIN
static int	LEVEL_OFFSET
static double	MAX_LATITUDE
static double	MAX_LONGITUDE
static double	MIN_LATITUDE
static double	MIN_LONGITUDE
static boolean	USE_CLIPPING

Constructor Summary

Constructors

Constructor and Description
MapTileUtil()

Method Summary

Modifier and Type	Method and Description
static java.awt.geom.Point2D	degreesToXY(double latitude, double longitude, int levelOfDetail) Converts a point from latitude/longitude WGS-84 coordinates (in degrees) into pixel XY coordinates at a specified level of detail.
static double[]	getOffsetFrom(double latitudeRef, double longitudeRef, double latitude, double longitude) This will return an north and east offsets using Mercator projection at levelOfDetail=22.
static double[]	getOffsetFrom(double latitudeRef, double longitudeRef, double latitude, double longitude, int levelOfDetail) This will return an north and east offsets using Mercator projection in an specific levelOfDetail.
static double[]	getOffsetInPixels(LocationType start, LocationType end) Gets offset in pixels with default level for creating shape only !!!!
static double[]	getOffsetInPixels(LocationType start, LocationType end, int level) Gets offset in pixels with given level
static double	groundResolution(double latitude, int levelOfDetail) Determines the ground resolution (in meters per pixel) at a specified latitude and level of detail.
static void	main(java.lang.String[] args)
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 int[]	pixelXYToTileXY(int pixelX, int pixelY) Converts pixel XY coordinates into tile XY coordinates of the tile containing the specified pixel.
static int[]	quadKeyToTileXY(java.lang.String quadKey) Converts a QuadKey into tile XY coordinates.
static int[]	tileXYToPixelXY(int tileX, int tileY) Converts tile XY coordinates into pixel XY coordinates of the upper-left pixel of the specified tile.
static java.lang.String	tileXYToQuadKey(int tileX, int tileY, int levelOfDetail) Converts tile XY coordinates into a QuadKey at a specified level of detail.
static double[]	xyToDegrees(double pixelX, double pixelY, int levelOfDetail) Converts a pixel from pixel XY coordinates at a specified level of detail into latitude/longitude WGS-84 coordinates (in degrees).

Methods inherited from class java.lang.Object

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

Field Detail

LEVEL_OFFSET

public static final int LEVEL_OFFSET

See Also:

Constant Field Values

LEVEL_MIN

public static final int LEVEL_MIN

See Also:

Constant Field Values

LEVEL_MAX

public static final int LEVEL_MAX

See Also:

Constant Field Values

EARTH_RADIUS

public static final double EARTH_RADIUS

See Also:

Constant Field Values

MIN_LATITUDE

public static final double MIN_LATITUDE

See Also:

Constant Field Values

MAX_LATITUDE

public static final double MAX_LATITUDE

See Also:

Constant Field Values

MIN_LONGITUDE

public static final double MIN_LONGITUDE

See Also:

Constant Field Values

MAX_LONGITUDE

public static final double MAX_LONGITUDE

See Also:

Constant Field Values

USE_CLIPPING

public static final boolean USE_CLIPPING

See Also:

Constant Field Values

Constructor Detail

MapTileUtil

public MapTileUtil()

Method Detail

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 22 (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.

degreesToXY

public static java.awt.geom.Point2D degreesToXY(double latitude,
                                                double longitude,
                                                int levelOfDetail)

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).

Returns:

XY coordinates.

xyToDegrees

public static double[] xyToDegrees(double pixelX,
                                   double pixelY,
                                   int levelOfDetail)

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 coordinates of the point, in pixels.

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

Returns:

Lat Lon in degrees.

pixelXYToTileXY

public static int[] pixelXYToTileXY(int pixelX,
                                    int pixelY)

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

Parameters:

pixelX - Pixel X coordinate.

pixelY - Pixel Y coordinate.

Returns:

tileX: Output parameter receiving the tile X coordinate. tileY: Output parameter receiving the tile Y coordinate.

tileXYToPixelXY

public static int[] tileXYToPixelXY(int tileX,
                                    int tileY)

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

Parameters:

tileX - Tile X coordinate.

tileY - Tile Y coordinate.

Returns:

pixelX: Output parameter receiving the pixel X coordinate. pixelY: Output parameter receiving the pixel Y coordinate.

tileXYToQuadKey

public static java.lang.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 int[] quadKeyToTileXY(java.lang.String quadKey)
                             throws java.lang.Exception

Converts a QuadKey into tile XY coordinates.

Parameters:

quadKey - QuadKey of the tile.

Returns:

tileX: Output parameter receiving the tile X coordinate. tileY: Output parameter receiving the tile Y coordinate. levelOfDetail: Output parameter receiving the level of detail.

Throws:

java.lang.Exception

getOffsetFrom

public static double[] getOffsetFrom(double latitudeRef,
                                     double longitudeRef,
                                     double latitude,
                                     double longitude)

This will return an north and east offsets using Mercator projection at levelOfDetail=22. Calls getOffsetFrom(double, double, double, double, int).

Parameters:

latitudeRef -

longitudeRef -

latitude -

longitude -

Returns:

getOffsetFrom

public static double[] getOffsetFrom(double latitudeRef,
                                     double longitudeRef,
                                     double latitude,
                                     double longitude,
                                     int levelOfDetail)

This will return an north and east offsets using Mercator projection in an specific levelOfDetail.

Parameters:

latitudeRef -

longitudeRef -

latitude -

longitude -

levelOfDetail -

Returns:

getOffsetInPixels

public static double[] getOffsetInPixels(LocationType start,
                                         LocationType end,
                                         int level)

Gets offset in pixels with given level

Parameters:

start -

end -

level -

Returns:

getOffsetInPixels

public static double[] getOffsetInPixels(LocationType start,
                                         LocationType end)

Gets offset in pixels with default level for creating shape only !!!!

Parameters:

start -

end -

Returns:

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Throws:

java.lang.Exception