es.situm.sdk.model.directions

Class Indication

java.lang.Object

es.situm.sdk.model.directions.Indication

public class Indication
extends java.lang.Object

Represents the instruction that a user should follow when on a RouteStep to continue the route

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Indication.Action Defines the main action of the indication
static class	Indication.Builder
static class	Indication.Orientation Defines the change in orientation associated the the indication

Field Summary

Fields

Modifier and Type	Field and Description
static <any>	CREATOR
static Indication	EMPTY
static Indication	END

Constructor Summary

Constructors

Constructor and Description
Indication(int stepIndex, double orientationChange, double distance, int floorDistance) Constructs Indication calculating its GuidanceActionType and GuidanceOrientationType

Method Summary

Modifier and Type	Method and Description
Indication	chunk(Indication indication2) Constructs a new Indication form the current one and the provided indication2.
int	describeContents()
boolean	equals(java.lang.Object o)
double	getDistance() Retrieve the distance between the origin and destination
int	getDistanceToNextLevel() Retrieve the number of levels between the origin and destination
Indication.Action	getIndicationType() Retrieve the Indication.Action of the instruction
double	getOrientation() Retrieve the angle a user should change his direction in order to go from the origin to the destination.
Indication.Orientation	getOrientationType() Retrieve the Indication.Orientation of the instruction
int	getStepIdxDestination() Retrieve the index of the indication's step of destination.
int	getStepIdxOrigin() Retrieve the index of the indication's step of origin
int	hashCode()
boolean	isChunckableWith(Indication indication2) Checks if this Indication can be combined with another one
boolean	isNeededLevelChange() Check if the user should change the level in order to arrive to destination
boolean	isValid() Check if a particular guidance make sense
void	setDistance(double distance)
java.lang.String	toString()
java.lang.String	toText(Context context) Get a natural language string describing the instruction in the language of the Locale of the device (if translation available).
java.lang.String	toText(Context context, java.util.Locale locale) Get a natural language string describing the instruction.
void	writeToParcel(Parcel dest, int flags)

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

EMPTY

public static final Indication EMPTY

END

public static final Indication END

CREATOR

public static final <any> CREATOR

Constructor Detail

Indication

public Indication(int stepIndex,
                  double orientationChange,
                  double distance,
                  int floorDistance)

Constructs Indication calculating its GuidanceActionType and GuidanceOrientationType

Parameters:

stepIndex - index of the RouteStep whose indication is being calculated

orientationChange - angle in radians of change in orientation to follow the route (-pi,pi)

distance - distance of the RouteStep from RouteStep.getDistance()

floorDistance: - Distance between floors of points origin and destination of the RouteStep

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getOrientation

public double getOrientation()

Retrieve the angle a user should change his direction in order to go from the origin to the destination.

Returns:

double value (radians)

getIndicationType

public Indication.Action getIndicationType()

Retrieve the Indication.Action of the instruction

Returns:

Indication.Action

getOrientationType

public Indication.Orientation getOrientationType()

Retrieve the Indication.Orientation of the instruction

Returns:

Indication.Orientation

getDistance

public double getDistance()

Retrieve the distance between the origin and destination

Returns:

double value (in meters)

isNeededLevelChange

public boolean isNeededLevelChange()

Check if the user should change the level in order to arrive to destination

Returns:

boolean value

getDistanceToNextLevel

public int getDistanceToNextLevel()

Retrieve the number of levels between the origin and destination

Returns:

integer value representing the number of level to go upstairs (positive values) or downstairs (negative values)

setDistance

public void setDistance(double distance)

getStepIdxOrigin

public int getStepIdxOrigin()

Retrieve the index of the indication's step of origin

Returns:

integer value representing the index of the step of origin

getStepIdxDestination

public int getStepIdxDestination()

Retrieve the index of the indication's step of destination. If the indication belongs to only one step, it is the same as the step index of origin.

Returns:

integer value representing the index of the step of destination

isValid

public boolean isValid()

Check if a particular guidance make sense

Returns:

bolean value determine if the guidance is valid (true) or invalid (false)

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

isChunckableWith

public boolean isChunckableWith(Indication indication2)

Checks if this Indication can be combined with another one

Returns:

boolean

chunk

public Indication chunk(Indication indication2)

Constructs a new Indication form the current one and the provided indication2. It should be check before if they are chunkable with the function isChunckableWith(Indication)

Returns:

Indication with parameters combined

toText

public java.lang.String toText(Context context)

Get a natural language string describing the instruction in the language of the Locale of the device (if translation available). The default language is english.

Parameters:

context -

Returns:

String

toText

public java.lang.String toText(Context context,
                               java.util.Locale locale)

Get a natural language string describing the instruction. If locale available it will return a string in that language. Otherwise it will try the systems Locale. Finally, if neither of them is available, it will return in the default language (english)

Parameters:

context -

locale - Locale of the desired language

Returns:

String with the textual indication

describeContents

public int describeContents()

writeToParcel

public void writeToParcel(Parcel dest,
                          int flags)