org.netxms.base

Class GeoLocation

java.lang.Object

org.netxms.base.GeoLocation

public class GeoLocation
extends Object

Geolocation encoding

Field Summary

Fields

Modifier and Type	Field and Description
static int	GPS
static int	MANUAL
static int	NETWORK
static int	UNSET

Constructor Summary

Constructors

Constructor and Description
GeoLocation(boolean isGPS) Create geolocation object of type UNSET or GPS
GeoLocation(double lat, double lon) Create geolocation object of type MANUAL
GeoLocation(double lat, double lon, int type, int accuracy, Date timestamp) Create geolocation object of given type, accuracy, and timestamp
GeoLocation(long base, NXCPMessage msg) Create geolocation object from NXCP message
GeoLocation(NXCPMessage msg) Create geolocation object from NXCP message

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object obj)
int	getAccuracy()
Date	getEndTimestamp()
double	getLatitude()
String	getLatitudeAsString()
double	getLongitude()
String	getLongitudeAsString()
Date	getTimestamp() Get location's time stamp.
int	getType()
int	hashCode()
static String	latitudeToString(double lat) Convert latitude from floating point to text representation
static String	longitudeToString(double lon) Convert longitude from floating point to text representation
static GeoLocation	parseGeoLocation(String lat, String lon) Parse geolocation string.
void	setEndTimestamp(Date endTimestamp)
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

UNSET

public static final int UNSET

See Also:

Constant Field Values

MANUAL

public static final int MANUAL

See Also:

Constant Field Values

GPS

public static final int GPS

See Also:

Constant Field Values

NETWORK

public static final int NETWORK

See Also:

Constant Field Values

Constructor Detail

GeoLocation

public GeoLocation(NXCPMessage msg)

Create geolocation object from NXCP message

Parameters:

msg - NXCP message

GeoLocation

public GeoLocation(long base,
           NXCPMessage msg)

Create geolocation object from NXCP message

Parameters:

msg - NXCP message

GeoLocation

public GeoLocation(boolean isGPS)

Create geolocation object of type UNSET or GPS

GeoLocation

public GeoLocation(double lat,
           double lon)

Create geolocation object of type MANUAL

Parameters:

lat - Latitude

lon - Longitude

GeoLocation

public GeoLocation(double lat,
           double lon,
           int type,
           int accuracy,
           Date timestamp)

Create geolocation object of given type, accuracy, and timestamp

Parameters:

lat - Latitude

lon - Longitude

Method Detail

getType

public int getType()

Returns:

the type

getLatitude

public double getLatitude()

Returns:

the latitude

getLongitude

public double getLongitude()

Returns:

the longitude

getAccuracy

public int getAccuracy()

Returns:

getTimestamp

public final Date getTimestamp()

Get location's time stamp. May be null if not known.

Returns:

the timestamp

toString

public String toString()

Overrides:

toString in class Object

latitudeToString

public static String latitudeToString(double lat)

Convert latitude from floating point to text representation

Parameters:

lat - latitude

Returns:

text representation of given latitude

longitudeToString

public static String longitudeToString(double lon)

Convert longitude from floating point to text representation

Parameters:

lon - longitude

Returns:

text representation of given longitude

getLatitudeAsString

public String getLatitudeAsString()

Returns:

latitude as DMS string

getLongitudeAsString

public String getLongitudeAsString()

Returns:

longitude as DMS string

parseGeoLocation

public static GeoLocation parseGeoLocation(String lat,
                           String lon)
                                    throws GeoLocationFormatException

Parse geolocation string. Latitude and longitude must be given either as numeric values or in DMS form.

Parameters:

lat - latitude string

lon - longitude string

Returns:

geolocation object

Throws:

GeoLocationFormatException - if the strings does not contain a parsable geolocation

getEndTimestamp

public Date getEndTimestamp()

Returns:

the end_timestamp

setEndTimestamp

public void setEndTimestamp(Date endTimestamp)

Parameters:

end_timestamp - the end_timestamp to set

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object