JScience v4.3

org.jscience.geography.coordinates
Class LatLong

java.lang.Object
  extended by org.jscience.geography.coordinates.Coordinates<GeographicCRS<?>>
      extended by org.jscience.geography.coordinates.LatLong
All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable, javolution.lang.Immutable, javolution.lang.Realtime, javolution.lang.ValueType, javolution.xml.XMLSerializable, org.opengis.spatialschema.geometry.DirectPosition, org.opengis.spatialschema.geometry.geometry.Position

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
See Also:
Serialized Form

Field Summary
static GeographicCRS<LatLong> CRS
          Holds the coordinate reference system for all instances of this class.
 
Method Summary
 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, finalize, 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 interface org.opengis.spatialschema.geometry.DirectPosition
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 interface org.opengis.spatialschema.geometry.DirectPosition
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 interface org.opengis.spatialschema.geometry.DirectPosition
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 .

JScience v4.3

Copyright © 2006 JScience.