Package nl.bebr.mapviewer.data

Class GeoPosition

java.lang.Object

nl.bebr.mapviewer.data.GeoPosition

public class GeoPosition
extends Object

An immutable coordinate in the real (geographic) world, composed of a latitude and a longitude.

Author:

rbair

Constructor Summary

Constructors

Constructor	Description
GeoPosition(double[] coords)	Creates a new instance of GeoPosition from the specified latitude and longitude as an array of two doubles, with the latitude first.
GeoPosition(double latitude, double longitude)	Creates a new instance of GeoPosition from the specified latitude and longitude.
GeoPosition(double latDegrees, double latMinutes, double latSeconds, double lonDegrees, double lonMinutes, double lonSeconds)	Creates a new instance of GeoPosition from the specified latitude and longitude.

Method Summary

Modifier and Type	Method	Description
float	distanceTo(double latitudeTo, double longitudeTo)
float	distanceTo(GeoPosition geoPosition)
boolean	equals(Object obj)	Returns true the specified GeoPosition and this GeoPosition represent the exact same latitude and longitude coordinates.
double	getLatitude()	Get the latitude as decimal degrees
double	getLongitude()	Get the longitude as decimal degrees
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoPosition

public GeoPosition(double latitude,
                   double longitude)

Creates a new instance of GeoPosition from the specified latitude and longitude. These are double values in decimal degrees, not degrees, minutes, and seconds. Use the other constructor for those.

Parameters:

latitude - a latitude value in decmial degrees

longitude - a longitude value in decimal degrees

GeoPosition

public GeoPosition(double[] coords)

Creates a new instance of GeoPosition from the specified latitude and longitude as an array of two doubles, with the latitude first. These are double values in decimal degrees, not degrees, minutes, and seconds. Use the other constructor for those.

Parameters:

coords - latitude and longitude as a double array of length two

GeoPosition

public GeoPosition(double latDegrees,
                   double latMinutes,
                   double latSeconds,
                   double lonDegrees,
                   double lonMinutes,
                   double lonSeconds)

Creates a new instance of GeoPosition from the specified latitude and longitude. Each are specified as degrees, minutes, and seconds; not as decimal degrees. Use the other constructor for those.

Parameters:

latDegrees - the degrees part of the current latitude

latMinutes - the minutes part of the current latitude

latSeconds - the seconds part of the current latitude

lonDegrees - the degrees part of the current longitude

lonMinutes - the minutes part of the current longitude

lonSeconds - the seconds part of the current longitude

Method Detail

getLatitude

public double getLatitude()

Get the latitude as decimal degrees

Returns:

the latitude as decimal degrees

getLongitude

public double getLongitude()

Get the longitude as decimal degrees

Returns:

the longitude as decimal degrees

equals

public boolean equals(Object obj)

Returns true the specified GeoPosition and this GeoPosition represent the exact same latitude and longitude coordinates.

Overrides:

equals in class Object

Parameters:

obj - a GeoPosition to compare this GeoPosition to

Returns:

returns true if the specified GeoPosition is equal to this one

toString

public String toString()

Overrides:

toString in class Object

Returns:

distanceTo

public float distanceTo(GeoPosition geoPosition)

distanceTo

public float distanceTo(double latitudeTo,
                        double longitudeTo)