org.tinfour.demo.utils

Class TextCoordGeo

java.lang.Object

org.tinfour.demo.utils.TextCoordGeo

public class TextCoordGeo
extends Object

Provides a utility for parsing or formatting a pair of geographic coordinates. The parse attempts to accept a broad range of user inputs including decimal inputs, degrees minutes and seconds, and other forms. Valid quadrants are N, S, E, and W.

Constructor Summary

Constructors

Constructor and Description
TextCoordGeo()

Method Summary

Modifier and Type	Method and Description
String	format(double lat, double lon) Formats the geographic coordinates into a form that is suitable for presentation in a user interface.
double	getLatitude()
double	getLongitude()
double[]	parse(String text) Parses a latitude/longitude string.

Methods inherited from class java.lang.Object

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

Constructor Detail

TextCoordGeo

public TextCoordGeo()

Method Detail

parse

public double[] parse(String text)
               throws ParseException

Parses a latitude/longitude string. If the parse is successful, an application may access the results using the getLatitude() and getLongitude() methods.

Parameters:

text - a valid string

Returns:

if successful, an array of dimension two giving geographic coordinates in the order latitude, longitude.

Throws:

ParseException - in the event of invalid text

getLatitude

public double getLatitude()

getLongitude

public double getLongitude()

format

public String format(double lat,
                     double lon)

Formats the geographic coordinates into a form that is suitable for presentation in a user interface.

Parameters:

lat - a floating point value in the range -90 to 90

lon - a floating point value in the range -360 to 360 (values are folded into range -180 ≤ lon < 180).

Returns:

a formatted string