org.jscience.geography.coordinates

Class LatLong

java.lang.Object

org.jscience.geography.coordinates.Coordinates<GeographicCRS<?>>

org.jscience.geography.coordinates.LatLong

All Implemented Interfaces:

j2me.io.Serializable, javolution.lang.Immutable, javolution.lang.Realtime, javolution.lang.ValueType, javolution.xml.XMLSerializable

public final class LatLong
extends Coordinates<GeographicCRS<?>>

This class represents the geographic latitude/longitude coordinates onto the WGS84 ellipsoid.

Version:

3.0, February 13, 2006

Author:

Jean-Marie Dautelle

Field Summary

Fields

Modifier and Type	Field and Description
static GeographicCRS<LatLong>	CRS Holds the coordinate reference system for all instances of this class.

Method Summary

Modifier and Type	Method and Description
LatLong	copy() Returns a copy of these coordinates allocated by the calling thread (possibly on the stack).
GeographicCRS<LatLong>	getCoordinateReferenceSystem() Returns the reference system for this coordinates.
int	getDimension() OpenGIS® - The length of coordinate sequence (the number of entries).
double	getOrdinate(int dimension) OpenGIS® - Returns the ordinate at the specified dimension.
double	latitudeValue(Unit<Angle> unit) Returns the latitude value as double
double	longitudeValue(Unit<Angle> unit) Returns the longitude value as double
static LatLong	valueOf(double latitude, double longitude, Unit<Angle> unit) Returns the surface position corresponding to the specified coordinates.

Methods inherited from class org.jscience.geography.coordinates.Coordinates

clone, getCoordinates, getPosition, setOrdinate, toString, toText

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

CRS

public static final GeographicCRS<LatLong> CRS

Holds the coordinate reference system for all instances of this class.

Method Detail

valueOf

public static LatLong valueOf(double latitude,
                              double longitude,
                              Unit<Angle> unit)

Returns the surface position corresponding to the specified coordinates.

Parameters:

latitude - the latitude value stated in the specified unit.

longitude - the longitude value stated in the specified unit.

unit - the angle unit in which the coordinates are stated (Degree typically).

Returns:

the corresponding surface position.

latitudeValue

public final double latitudeValue(Unit<Angle> unit)

Returns the latitude value as double

Parameters:

unit - the angle unit of the latitude to return.

Returns:

the latitude stated in the specified unit.

longitudeValue

public final double longitudeValue(Unit<Angle> unit)

Returns the longitude value as double

Parameters:

unit - the angle unit of the longitude to return.

Returns:

the longitude stated in the specified unit.

getCoordinateReferenceSystem

public GeographicCRS<LatLong> getCoordinateReferenceSystem()

Description copied from class: Coordinates

Returns the reference system for this coordinates.

Specified by:

getCoordinateReferenceSystem in class Coordinates<GeographicCRS<?>>

Returns:

the associated coordinate reference system.

getDimension

public int getDimension()

Description copied from class: Coordinates

OpenGIS® - The length of coordinate sequence (the number of entries). This is determined by the coordinate reference system.

Specified by:

getDimension in class Coordinates<GeographicCRS<?>>

Returns:

the dimensionality of this position.

getOrdinate

public double getOrdinate(int dimension)
                   throws java.lang.IndexOutOfBoundsException

Description copied from class: Coordinates

OpenGIS® - Returns the ordinate at the specified dimension.

Specified by:

getOrdinate in class Coordinates<GeographicCRS<?>>

Parameters:

dimension - The dimension in the range 0 to dimension-1.

Returns:

The coordinate at the specified dimension.

Throws:

java.lang.IndexOutOfBoundsException - if the specified dimension is out of bounds.

copy

public LatLong copy()

Description copied from class: Coordinates

Returns a copy of these coordinates allocated by the calling thread (possibly on the stack).

Specified by:

copy in interface javolution.lang.ValueType

Specified by:

copy in class Coordinates<GeographicCRS<?>>

Returns:

an identical and independant copy of these coordinates .