ucar.unidata.view.geoloc

Class CoordinateFormat

java.lang.Object

ucar.unidata.view.geoloc.CoordinateFormat

public class CoordinateFormat
extends java.lang.Object

The CoordinateFormat class to format geo coordinates.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CoordinateFormat.Cardinality The Cardinality enum.
static class	CoordinateFormat.DecimalCoordFormat The DecimalCoordFormat.
static class	CoordinateFormat.DegMinSec The Degrees Minutes Seconds enum.
static class	CoordinateFormat.FloorCoordFormat The FloorCoordFormat class.
static interface	CoordinateFormat.Format The Format interface.

Field Summary

Fields

Modifier and Type	Field and Description
static CoordinateFormat.Format	EMPTY_FORMAT Empty format.

Constructor Summary

Constructors

Constructor and Description
CoordinateFormat()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	convert(double coord, CoordinateFormat.Format degF, CoordinateFormat.Format minF, CoordinateFormat.Format secF, CoordinateFormat.Cardinality card) Convert a decimal coordinate.
static java.lang.String	formatLatitude(double value, java.lang.String format) Format a longitude to the given format.
static java.lang.String	formatLongitude(double value, java.lang.String format, boolean use360) Format a latitude or longitude value to the given format.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_FORMAT

public static final CoordinateFormat.Format EMPTY_FORMAT

Empty format.

Constructor Detail

CoordinateFormat

public CoordinateFormat()

Method Detail

convert

public static java.lang.String convert(double coord,
                                       CoordinateFormat.Format degF,
                                       CoordinateFormat.Format minF,
                                       CoordinateFormat.Format secF,
                                       CoordinateFormat.Cardinality card)

Convert a decimal coordinate.

Parameters:

coord - the decimal coord

degF - the deg format

minF - the min format

secF - the sec format

card - the cardinality

Returns:

the formatted coordinate string

formatLatitude

public static java.lang.String formatLatitude(double value,
                                              java.lang.String format)

Format a longitude to the given format. formatLongitude(double, String, boolean)

Parameters:

value - the value to format

format - the format

Returns:

formatted latitude

formatLongitude

public static java.lang.String formatLongitude(double value,
                                               java.lang.String format,
                                               boolean use360)

Format a latitude or longitude value to the given format. Formats use DD for degrees, MM for minutes, SS for seconds and d, m, s for decimal fractions of degrees, minutes, seconds. H designates the hemisphere (N,S,E,W).

 Examples for value -34.496 degrees

     DD:MM:SS      ===>  -34:29:45
       (if longitude and use360 ===> 326:29:45)
     DDH           ===>   34W     (or 34S if longitude)
     DD.d          ===>  -34.5
     DD.dddH       ===>   34.496W (or 34.496S if longitude)
     DD MM'SS.s"   ===>  -34 29'45.6"

 

Parameters:

value - the value to format

format - the format

use360 - if true use 0-360 notation instead of -180 to 180 notation

Returns:

formatted longitude