es.situm.sdk.model.location

Class Location

java.lang.Object

es.situm.sdk.model.location.Location

All Implemented Interfaces:

BuildingResource, FloorResource

public class Location
extends java.lang.Object
implements FloorResource

A location. It can be indoor or outdoor, check isIndoor() and isOutdoor(). A valid indoor location has floorIdentifier and cartesianCoordinate.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Location.Builder
static class	Location.Quality The quality of the location/bearing.

Field Summary

Fields

Modifier and Type	Field and Description
static <any>	CREATOR

Method Summary

Modifier and Type	Method and Description
int	describeContents()
boolean	equals(java.lang.Object o)
float	getAccuracy() Return the accuracy radius (in meters)
Angle	getBearing() Return the bearing (in degrees) with respect to the Earth North.
Location.Quality	getBearingQuality() Return the quality of the cartesian bearing.
java.lang.String	getBuildingIdentifier() Only used in indoor.
Angle	getCartesianBearing() Only used in indoor.
CartesianCoordinate	getCartesianCoordinate() Only used in indoor.
Coordinate	getCoordinate() Return the coordinate of the location
java.lang.String	getDeviceId() Returns the device identifier that has generated the location
java.lang.String	getFloorIdentifier() Only used in indoor.
Point	getPosition() Return the position of the location.
java.lang.String	getProvider()
Location.Quality	getQuality() Only used in indoor.
long	getTime() Return the timestamp of the location.
boolean	hasBearing() Return true if the location has bearing and the bearing quality is Location.Quality.HIGH, false otherwise.
boolean	hasCartesianBearing() Only used in indoor.
int	hashCode()
boolean	isIndoor() Return true if the location is indoor
boolean	isOutdoor() Return true if the location is outdoor
java.lang.String	toString()
void	writeToParcel(Parcel dest, int flags)

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

CREATOR

public static final <any> CREATOR

Method Detail

getPosition

public Point getPosition()

Return the position of the location. Only needed if you neede access to the internal Point object. It's better to use directly getCoordinate(), getCartesianCoordinate(), etc. on the Location object

isIndoor

public boolean isIndoor()

Return true if the location is indoor

See Also:

isOutdoor()

getDeviceId

public java.lang.String getDeviceId()

Returns the device identifier that has generated the location

isOutdoor

public boolean isOutdoor()

Return true if the location is outdoor

See Also:

isIndoor()

getCoordinate

public Coordinate getCoordinate()

Return the coordinate of the location

getCartesianCoordinate

public CartesianCoordinate getCartesianCoordinate()

Only used in indoor. Return the cartesian coordinate in the corresponding floor of the building image.

getBuildingIdentifier

public java.lang.String getBuildingIdentifier()

Only used in indoor. Return the building identifier.

Specified by:

getBuildingIdentifier in interface BuildingResource

getFloorIdentifier

public java.lang.String getFloorIdentifier()

Only used in indoor. Return the floor identifier.

Specified by:

getFloorIdentifier in interface FloorResource

getQuality

public Location.Quality getQuality()

Only used in indoor. Return an indicative of quality calculated with accuracy and building size.

getTime

public long getTime()

Return the timestamp of the location.

getAccuracy

public float getAccuracy()

Return the accuracy radius (in meters)

hasCartesianBearing

public boolean hasCartesianBearing()

Only used in indoor. Return true if the location has cartesian bearing and the bearing quality is Location.Quality.HIGH, false otherwise.

See Also:

getCartesianBearing(), getBearingQuality()

getCartesianBearing

public Angle getCartesianBearing()

Only used in indoor. Return the bearing with respect to the building, being 0 the west-east axis. If hasCartesianBearing() is false the bearing returned couldn't be reliable. You can get the bearing quality with getBearingQuality()

hasBearing

public boolean hasBearing()

Return true if the location has bearing and the bearing quality is Location.Quality.HIGH, false otherwise.

See Also:

getBearing(), getBearingQuality()

getBearing

public Angle getBearing()

Return the bearing (in degrees) with respect to the Earth North. If hasBearing() is false it will return a default Angle

getProvider

public java.lang.String getProvider()

getBearingQuality

public Location.Quality getBearingQuality()

Return the quality of the cartesian bearing. It's recommended to use the value of the bearing only if the quality is Location.Quality.HIGH. If the quality is Location.Quality.LOW the bearing is not reliable. If the location is outdoor and the bearing is set the quality will be Location.Quality.HIGH

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

describeContents

public int describeContents()

writeToParcel

public void writeToParcel(Parcel dest,
                          int flags)

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object