org.oscim.core

Class MercatorProjection

java.lang.Object

org.oscim.core.MercatorProjection

public final class MercatorProjection
extends java.lang.Object

An implementation of the spherical Mercator projection.

Field Summary

Fields

Modifier and Type	Field and Description
static double	EARTH_CIRCUMFERENCE The circumference of the earth at the equator in meters.
static double	LATITUDE_MAX Maximum possible latitude coordinate of the map.
static double	LATITUDE_MIN Minimum possible latitude coordinate of the map.
static double	LONGITUDE_MAX Maximum possible longitude coordinate of the map.
static double	LONGITUDE_MIN Minimum possible longitude coordinate of the map.

Method Summary

Modifier and Type	Method and Description
static double	groundResolution(double latitude, double scale) Calculates the distance on the ground that is represented by a single pixel on the map.
static float	groundResolution(MapPosition pos)
static double	latitudeToY(double latitude) Projects a latitude coordinate (in degrees) to the range [0.0,1.0]
static double	limitLatitude(double latitude)
static double	limitLongitude(double longitude)
static double	longitudeToX(double longitude) Projects a longitude coordinate (in degrees) to the range [0.0,1.0]
static void	project(double latitude, double longitude, double[] out, int pos)
static void	project(GeoPoint p, double[] out, int pos)
static Point	project(GeoPoint p, Point reuse)
static double	toLatitude(double y)
static double	toLongitude(double x)
static double	wrapLongitude(double longitude)

Methods inherited from class java.lang.Object

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

Field Detail

EARTH_CIRCUMFERENCE

public static final double EARTH_CIRCUMFERENCE

The circumference of the earth at the equator in meters.

See Also:

Constant Field Values

LATITUDE_MAX

public static final double LATITUDE_MAX

Maximum possible latitude coordinate of the map.

See Also:

Constant Field Values

LATITUDE_MIN

public static final double LATITUDE_MIN

Minimum possible latitude coordinate of the map.

See Also:

Constant Field Values

LONGITUDE_MAX

public static final double LONGITUDE_MAX

Maximum possible longitude coordinate of the map.

See Also:

Constant Field Values

LONGITUDE_MIN

public static final double LONGITUDE_MIN

Minimum possible longitude coordinate of the map.

See Also:

Constant Field Values

Method Detail

groundResolution

public static double groundResolution(double latitude,
                                      double scale)

Calculates the distance on the ground that is represented by a single pixel on the map.

Parameters:

latitude - the latitude coordinate at which the resolution should be calculated.

scale - the map scale at which the resolution should be calculated.

Returns:

the ground resolution at the given latitude and zoom level.

groundResolution

public static float groundResolution(MapPosition pos)

latitudeToY

public static double latitudeToY(double latitude)

Projects a latitude coordinate (in degrees) to the range [0.0,1.0]

Parameters:

latitude - the latitude coordinate that should be converted.

Returns:

the position.

toLatitude

public static double toLatitude(double y)

longitudeToX

public static double longitudeToX(double longitude)

Projects a longitude coordinate (in degrees) to the range [0.0,1.0]

Parameters:

longitude - the longitude coordinate that should be converted.

Returns:

the position.

toLongitude

public static double toLongitude(double x)

project

public static Point project(GeoPoint p,
                            Point reuse)

project

public static void project(GeoPoint p,
                           double[] out,
                           int pos)

project

public static void project(double latitude,
                           double longitude,
                           double[] out,
                           int pos)

limitLatitude

public static double limitLatitude(double latitude)

Parameters:

latitude - the latitude value which should be checked.

Returns:

the given latitude value, limited to the possible latitude range.

limitLongitude

public static double limitLongitude(double longitude)

Parameters:

longitude - the longitude value which should be checked.

Returns:

the given longitude value, limited to the possible longitude range.

wrapLongitude

public static double wrapLongitude(double longitude)