public class ASTLatLon
extends java.lang.Object
In the validation routines, lat/lon can usually be entered in either decimal (e.g., 95.63W) or DMS format (e.g., 9d 15m 33sN).
Copyright (c) 2018
Modifier and Type | Class and Description |
---|---|
static class |
ASTLatLon.TimeZoneType
The numeric value of the time zone type is the time zone adjustment.
|
Constructor and Description |
---|
ASTLatLon()
Class constructor.
|
Modifier and Type | Method and Description |
---|---|
double |
getLat()
Gets the latitude value
|
ASTAngle |
getLatAngle()
Gets the latitude value as an angle object
|
double |
getLon()
Gets the longitude value
|
ASTAngle |
getLonAngle()
Gets the longitude value as an angle object
|
boolean |
isEastLon()
Returns whether the object is a West longitude
|
boolean |
isLatValid()
Returns whether the object has a valid latitude
|
boolean |
isLonValid()
Returns whether the object has a valid longitude
|
boolean |
isNorthLat()
Returns whether the object is a North latitude
|
static ASTLatLon |
isValidLat(java.lang.String inputStr)
Checks a string to see if it contains a valid latitude value.
|
static ASTLatLon |
isValidLat(java.lang.String inputStr,
boolean flag)
Checks a string to see if it contains a valid latitude value.
|
static ASTLatLon |
isValidLon(java.lang.String inputStr)
Checks a string to see if it contains a valid longitude value.
|
static ASTLatLon |
isValidLon(java.lang.String inputStr,
boolean flag)
Checks a string to see if it contains a valid longitude value.
|
static java.lang.String |
lat_lonToStr(ASTLatLon latlonObj,
boolean formatFlag)
Convert a lat/lon object to a string
|
static java.lang.String |
latToStr(ASTLatLon latlonObj,
boolean formatFlag)
Converts latitude to a printable string as determined by
formatFlag.
|
static java.lang.String |
latToStr(boolean pos,
int d,
int m,
double s,
boolean formatFlag)
Converts latitude to a printable string as determined by
formatFlag.
|
static java.lang.String |
lonToStr(ASTLatLon latlonObj,
boolean formatFlag)
Converts longitude to a printable string as determined by
formatFlag.
|
static java.lang.String |
lonToStr(boolean pos,
int d,
int m,
double s,
boolean formatFlag)
Converts longitude to a printable string as determined by
formatFlag.
|
void |
setLat(double lat)
Sets the latitude value.
|
void |
setLon(double lon)
Sets the longitude value.
|
static ASTLatLon.TimeZoneType |
strToTimeZone(java.lang.String tzStr)
Convert a string to a time zone type
|
static double |
timeZoneAdjustment(ASTLatLon.TimeZoneType tZone,
double lon)
Calculate a time zone adjustment
|
public ASTLatLon()
Since much of the usage of this class involves validating that a string has a valid lat and/or lon, assume a new object is invalid until it is proven otherwise.
public boolean isLatValid()
public boolean isNorthLat()
public ASTAngle getLatAngle()
public double getLat()
public boolean isLonValid()
public boolean isEastLon()
public ASTAngle getLonAngle()
public double getLon()
public void setLat(double lat)
lat
- latitude as a real numberpublic void setLon(double lon)
lon
- longitude as a real numberpublic static java.lang.String lat_lonToStr(ASTLatLon latlonObj, boolean formatFlag)
latlonObj
- object to convert to a stringformatFlag
- flag for how to format the
result (DMSFORMAT or DECFORMAT)public static ASTLatLon.TimeZoneType strToTimeZone(java.lang.String tzStr)
tzStr
- string to convertpublic static double timeZoneAdjustment(ASTLatLon.TimeZoneType tZone, double lon)
tZone
- time zonelon
- longitudepublic static ASTLatLon isValidLat(java.lang.String inputStr, boolean flag)
inputStr
- string to be checked for a valid latitudeflag
- whether to display error messagespublic static ASTLatLon isValidLat(java.lang.String inputStr)
inputStr
- string to be checked for a valid latitudepublic static java.lang.String latToStr(ASTLatLon latlonObj, boolean formatFlag)
latlonObj
- object to be converted to a stringformatFlag
- what format is desired (DMSFORMAT or DECFORMAT)public static java.lang.String latToStr(boolean pos, int d, int m, double s, boolean formatFlag)
pos
- true if the latitude is positived
- latitude degreesm
- latitude minutess
- latitude secondsformatFlag
- what format is desired (DMSFORMAT or DECFORMAT)public static ASTLatLon isValidLon(java.lang.String inputStr, boolean flag)
inputStr
- string to be checked for a valid longitudeflag
- whether to display error messagespublic static ASTLatLon isValidLon(java.lang.String inputStr)
inputStr
- string to be checked for a valid longitudepublic static java.lang.String lonToStr(ASTLatLon latlonObj, boolean formatFlag)
latlonObj
- object to be converted to a stringformatFlag
- what format is desired (DMSFORMAT or DECFORMAT)public static java.lang.String lonToStr(boolean pos, int d, int m, double s, boolean formatFlag)
pos
- true if the longitude is positived
- longitude degreesm
- longitude minutess
- longitude secondsformatFlag
- what format is desired (DMSFORMAT or DECFORMAT)