com.hypertrack.sdk.views.dao

Class Location

java.lang.Object

com.hypertrack.sdk.views.dao.Location

public class Location
extends Object

Represents device location data at certain moment in time. Check out getters for accessible fields list.

Field Summary

Fields

Modifier and Type	Field and Description
static int	ALTITUDE_INDEX
static int	LATITUDE_INDEX
static int	LONGITUDE_INDEX

Constructor Summary

Constructors

Constructor and Description
Location(double latitude, double longitude, Double speed, Double bearing, Double altitude, Double accuracy, String recordedAt)
Location(List<Double> coordinates, String recordedAt)

Method Summary

Modifier and Type	Method and Description
Double	getAccuracy()
Double	getAltitude()
Double	getBearing()
double	getLatitude()
double	getLongitude()
Date	getRecordDate()
String	getRecordedAt()
Double	getSpeed()
boolean	isObsolete()
String	toString()
Location	updateBearing(Location lastKnownLocation)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

ALTITUDE_INDEX

public static final int ALTITUDE_INDEX

See Also:

Constant Field Values

LATITUDE_INDEX

public static final int LATITUDE_INDEX

See Also:

Constant Field Values

LONGITUDE_INDEX

public static final int LONGITUDE_INDEX

See Also:

Constant Field Values

Constructor Detail

Location

public Location(double latitude,
                double longitude,
                Double speed,
                Double bearing,
                Double altitude,
                Double accuracy,
                String recordedAt)

Location

public Location(List<Double> coordinates,
                String recordedAt)
         throws IllegalArgumentException

Throws:

IllegalArgumentException

Method Detail

updateBearing

public Location updateBearing(Location lastKnownLocation)

getLatitude

public double getLatitude()

Returns:

is guaranteed to be from -90.0 to 90.0 (negative values are for south hemisphere).

getLongitude

public double getLongitude()

Returns:

is guaranteed to be in [-180.0 to 180.0 ] (negative values are for western hemisphere).

getRecordedAt

public String getRecordedAt()

Returns:

RFC 3339 compliant value for time, when this location was recorded on.

See Also:

getRecordDate()

getRecordDate

public Date getRecordDate()

Returns:

time, when this location was recorded on.

See Also:

getRecordedAt()

getAltitude

public Double getAltitude()

Returns:

Altitude of current device location, in meters or null, if no location data available. Values are expected to be from -500.00 up to 15000.00.

getSpeed

public Double getSpeed()

Returns:

null if speed is unavailable or it's value in meters per second.

getBearing

public Double getBearing()

Returns:

null, if bearing is unavailable (e.g. for stationary device) or north heading value in degrees. Value is expected to be in range from 0 exclusive to 360 inclusive.

getAccuracy

public Double getAccuracy()

Returns:

null, if accuracy data is unavailable or radius of circle, that contains true location with 70% probability (2 sigma range). Applicable to horizontal values only, since {getAltitude()} usually have less precise accuracy.

isObsolete

public boolean isObsolete()

Returns:

true if location is historic (the one that was captured during previous sections) as opposed to real location update.

toString

public String toString()

Overrides:

toString in class Object