com.drew.lang
Class GeoLocation

java.lang.Object
  com.drew.lang.GeoLocation

public final class GeoLocation
extends Object

Represents a latitude and longitude pair, giving a position on earth in spherical coordinates. Values of latitude and longitude are given in degrees. This type is immutable.

Constructor Summary

GeoLocation(double latitude, double longitude)
Instantiates a new instance of GeoLocation.

Method Summary

static double[]	decimalToDegreesMinutesSeconds(double decimal) Converts a decimal degree angle into its corresponding DMS (degrees-minutes-seconds) component values, as a double array.
static String	decimalToDegreesMinutesSecondsString(double decimal) Converts a decimal degree angle into its corresponding DMS (degrees-minutes-seconds) representation as a string, of format: -1° 23' 4.56"
static Double	degreesMinutesSecondsToDecimal(Rational degs, Rational mins, Rational secs, boolean isNegative) Converts DMS (degrees-minutes-seconds) rational values, as given in GpsDirectory, into a single value in degrees, as a double.
boolean	equals(Object o)
double	getLatitude()
double	getLongitude()
int	hashCode()
boolean	isZero()
String	toDMSString()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoLocation

public GeoLocation(double latitude,
                   double longitude)

Instantiates a new instance of GeoLocation.

Parameters:

latitude - the latitude, in degrees

longitude - the longitude, in degrees

Method Detail

getLatitude

public double getLatitude()

Returns:

the latitudinal angle of this location, in degrees.

getLongitude

public double getLongitude()

Returns:

the longitudinal angle of this location, in degrees.

isZero

public boolean isZero()

Returns:

true, if both latitude and longitude are equal to zero

decimalToDegreesMinutesSecondsString

public static String decimalToDegreesMinutesSecondsString(double decimal)

Converts a decimal degree angle into its corresponding DMS (degrees-minutes-seconds) representation as a string, of format: -1° 23' 4.56"

decimalToDegreesMinutesSeconds

public static double[] decimalToDegreesMinutesSeconds(double decimal)

Converts a decimal degree angle into its corresponding DMS (degrees-minutes-seconds) component values, as a double array.

degreesMinutesSecondsToDecimal

public static Double degreesMinutesSecondsToDecimal(Rational degs,
                                                    Rational mins,
                                                    Rational secs,
                                                    boolean isNegative)

Converts DMS (degrees-minutes-seconds) rational values, as given in GpsDirectory, into a single value in degrees, as a double.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

Returns:

a string representation of this location, of format: 1.23, 4.56

toDMSString

public String toDMSString()

Returns:

a string representation of this location, of format: -1° 23' 4.56", 54° 32' 1.92"