es.situm.sdk.location.util

Class CoordinateConverter

java.lang.Object

es.situm.sdk.location.util.CoordinateConverter

public class CoordinateConverter
extends java.lang.Object

Utility class to convert between cartesian coordinates and geographical coordinates.

Field Summary

Fields

Modifier and Type	Field and Description
static <any>	CREATOR

Constructor Summary

Constructors

Constructor and Description
CoordinateConverter(Dimensions dimensions, Coordinate center) Define how cartesian area is placed in geographical space, aligned with east-west and north-south axis.
CoordinateConverter(Dimensions dimensions, Coordinate center, Angle rotation) Define how the cartesian area is placed in geographical space, with a rotation with respect to east-west axis.

Method Summary

Modifier and Type	Method and Description
int	describeContents()
boolean	equals(java.lang.Object o)
int	hashCode()
Angle	toAngle(Angle yaw) Converts and angle from building system coordinate to Earth system coordinate.
CartesianCoordinate	toCartesianCoordinate(Coordinate coordinate) Transform geographical coordinates to cartesian coordinates (within the area defined in the constructor)
Coordinate	toCoordinate(CartesianCoordinate fromCartesianCoordinate) Transform cartesian coordinates (within the area defined in the constructor) into geographical coordinates
void	writeToParcel(Parcel dest, int flags)

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

CREATOR

public static final <any> CREATOR

Constructor Detail

CoordinateConverter

public CoordinateConverter(Dimensions dimensions,
                           Coordinate center)

Define how cartesian area is placed in geographical space, aligned with east-west and north-south axis.

Parameters:

dimensions - Not null. Dimensions of cartesian area, in meters. E.g. Building.getDimensions()

center - Not null. Geographical coordinates of middle point of cartesian area. E.g. Building.getCenter()

CoordinateConverter

public CoordinateConverter(Dimensions dimensions,
                           Coordinate center,
                           Angle rotation)

Define how the cartesian area is placed in geographical space, with a rotation with respect to east-west axis.

Parameters:

dimensions - Not null. Dimensions of cartesian area, in meters. E.g. Building.getDimensions()

center - Not null. Geographical coordinates of middle point of cartesian area. E.g. Building.getCenter()

rotation - Not null. Rotation angle of the cartesian area, around the center point. E.g. Building.getRotation()

Throws:

java.lang.IllegalArgumentException - if some provided parameter is null.

Method Detail

toAngle

public Angle toAngle(Angle yaw)

Converts and angle from building system coordinate to Earth system coordinate. The returned value is between 0 and 360 degrees.

Parameters:

yaw - the angle to convert

toCartesianCoordinate

public CartesianCoordinate toCartesianCoordinate(Coordinate coordinate)

Transform geographical coordinates to cartesian coordinates (within the area defined in the constructor)

Parameters:

coordinate - Not null.

Returns:

Not null.

toCoordinate

public Coordinate toCoordinate(CartesianCoordinate fromCartesianCoordinate)

Transform cartesian coordinates (within the area defined in the constructor) into geographical coordinates

Parameters:

fromCartesianCoordinate - Not null.

Returns:

Not null.

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