Package com.drew.lang

Class GeoLocation

java.lang.Object

com.drew.lang.GeoLocation

public final class GeoLocation
extends java.lang.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

Constructors

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

Method Summary

Modifier and Type	Method	Description
static double[]	decimalToDegreesMinutesSeconds(double decimal)	Converts a decimal degree angle into its corresponding DMS (degrees-minutes-seconds) component values, as a double array.
static java.lang.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 java.lang.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(java.lang.Object o)
double	getLatitude()
double	getLongitude()
int	hashCode()
boolean	isZero()
java.lang.String	toDMSString()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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 java.lang.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 java.lang.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(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

Returns:

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

toDMSString

public java.lang.String toDMSString()

Returns:

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