NASA World Wind

gov.nasa.worldwind.geom.coords
Class UTMCoord

java.lang.Object
  extended by gov.nasa.worldwind.geom.coords.UTMCoord

public class UTMCoord
extends java.lang.Object

This immutable class holds a set of UTM coordinates along with it's corresponding latitude and longitude.


Constructor Summary
UTMCoord(Angle latitude, Angle longitude, int zone, char hemisphere, double easting, double northing)
          Create an arbitrary set of UTM coordinates with the given values.
 
Method Summary
static UTMCoord fromLatLon(Angle latitude, Angle longitude)
          Create a set of UTM coordinates from a pair of latitude and longitude for a WGS84 globe.
static UTMCoord fromLatLon(Angle latitude, Angle longitude, Globe globe)
          Create a set of UTM coordinates from a pair of latitude and longitude for the given Globe.
static UTMCoord fromUTM(int zone, char hemisphere, double easting, double northing)
          Create a set of UTM coordinates for a WGS84 globe.
static UTMCoord fromUTM(int zone, char hemisphere, double easting, double northing, Globe globe)
          Create a set of UTM coordinates for the given Globe.
 double getEasting()
           
 char getHemisphere()
           
 Angle getLatitude()
           
 Angle getLongitude()
           
 double getNorthing()
           
 int getZone()
           
 java.lang.String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

UTMCoord

public UTMCoord(Angle latitude,
                Angle longitude,
                int zone,
                char hemisphere,
                double easting,
                double northing)
Create an arbitrary set of UTM coordinates with the given values.

Parameters:
latitude - the latitude Angle.
longitude - the longitude Angle.
zone - the UTM zone - 1 to 60.
hemisphere - the hemisphere 'N' or 'S'.
easting - the easting distance in meters
northing - the northing distance in meters.
Throws:
java.lang.IllegalArgumentException - if latitude or longitude is null.
Method Detail

fromLatLon

public static UTMCoord fromLatLon(Angle latitude,
                                  Angle longitude)
Create a set of UTM coordinates from a pair of latitude and longitude for a WGS84 globe.

Parameters:
latitude - the latitude Angle.
longitude - the longitude Angle.
Returns:
the corresponding UTMCoord.
Throws:
java.lang.IllegalArgumentException - if latitude or longitude is null, or the conversion to UTM coordinates fails.

fromLatLon

public static UTMCoord fromLatLon(Angle latitude,
                                  Angle longitude,
                                  Globe globe)
Create a set of UTM coordinates from a pair of latitude and longitude for the given Globe.

Parameters:
latitude - the latitude Angle.
longitude - the longitude Angle.
globe - the Globe - can be null (will use WGS84).
Returns:
the corresponding UTMCoord.
Throws:
java.lang.IllegalArgumentException - if latitude or longitude is null, or the conversion to UTM coordinates fails.

fromUTM

public static UTMCoord fromUTM(int zone,
                               char hemisphere,
                               double easting,
                               double northing)
Create a set of UTM coordinates for a WGS84 globe.

Parameters:
zone - the UTM zone - 1 to 60.
hemisphere - the hemisphere 'N' or 'S'.
easting - the easting distance in meters
northing - the northing distance in meters.
Returns:
the corresponding UTMCoord.
Throws:
java.lang.IllegalArgumentException - if the conversion to UTM coordinates fails.

fromUTM

public static UTMCoord fromUTM(int zone,
                               char hemisphere,
                               double easting,
                               double northing,
                               Globe globe)
Create a set of UTM coordinates for the given Globe.

Parameters:
zone - the UTM zone - 1 to 60.
hemisphere - the hemisphere 'N' or 'S'.
easting - the easting distance in meters
northing - the northing distance in meters.
globe - the Globe - can be null (will use WGS84).
Returns:
the corresponding UTMCoord.
Throws:
java.lang.IllegalArgumentException - if the conversion to UTM coordinates fails.

getEasting

public double getEasting()

getHemisphere

public char getHemisphere()

getLatitude

public Angle getLatitude()

getLongitude

public Angle getLongitude()

getNorthing

public double getNorthing()

getZone

public int getZone()

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object

NASA World Wind