com.motorola.iden.position
Interface AggregatePosition

All Superinterfaces:

Position2D

public interface AggregatePosition

extends Position2D

Provides the location information on Fix (Heading, Velocity, Speed Uncertainty, Number of Satellites in Solution, Altitude, Altitude Uncertainty) and Serving Cell Information (Serving Cell Latitude, Serving Cell Longitude).

MOTOROLA and the Stylized M Logo are registered trademarks of Motorola, Inc. Reg. U.S. Pat. & Tm. Off.
?Copyright 2002 Motorola, Inc. All Rights Reserved.

Fields inherited from interface com.motorola.iden.position.Position2D

DEG_MIN, DEG_MIN_SEC, DEGREES, UNAVAILABLE

Method Summary

int	getAltitude() Returns the altitude of a position in meters.
int	getAltitudeUncertainty() Returns the altitude uncertainty in millimeters as the measurement is taken.
int	getNumberOfSatsUsed() Returns the number of satellites used to get a fix.
int	getResponseCode() Returns the response code.
int	getSpeed() Returns the speed value in kilometers per hour.
int	getSpeedUncertainty() Returns the speed uncertainty in kilometers per hour.
int	getTravelDirection() Returns the heading, or direction of travel.
boolean	hasAltitude() Indicates if the altitude is available.
boolean	hasAltitudeUncertainty() Indicates if the altitude uncertainty is available.
boolean	hasNumberOfSatsUsed() Indicates if the number of satellites used to get a fix is available.
boolean	hasResponseCode() Indicates if the response code is available.
boolean	hasSpeed() Indicates if the speed is available.
boolean	hasSpeedUncertainty() Indicates if the speed uncertainty is available.
boolean	hasTravelDirection() Indicates if the travel direction is available.

Methods inherited from interface com.motorola.iden.position.Position2D

getAssistanceUsed, getLatitude, getLatitude, getLatLonAccuracy, getLongitude, getLongitude, getServingCellLatitude, getServingCellLatitude, getServingCellLongitude, getServingCellLongitude, getTimeStamp, hasAssistanceUsed, hasLatLon, hasLatLonAccuracy, hasServingCellLatLon, hasTimeStamp

Method Detail

getAltitude

public int getAltitude()

Returns the altitude of a position in meters.

Returns:

the altitude (above sea level) of the position in meters. The returned value is a signed integer, with negative being below sea level, and positive being above sea level. UNAVAILABLE is returned if the altitude data is not available.

getSpeed

public int getSpeed()

Returns the speed value in kilometers per hour.

Returns:

the speed value in kilometers per hour. UNAVAILABLE is returned if the speed data is not available.

getTravelDirection

public int getTravelDirection()

Returns the heading, or direction of travel.

Returns:

the heading, or direction of travel. This value is denoted in degree where 0 degrees are true north and east is 90 degrees. The return value ranges from 0 to 359. Be sure to use hasTravelDirection() to determine if the direction information is available before using this returned value. UNAVAILABLE is returned if the direction data is not available.

getSpeedUncertainty

public int getSpeedUncertainty()

Returns the speed uncertainty in kilometers per hour.

Returns:

the speed uncertainty of the fix. UNAVAILABLE is returned if the speed uncertainty is not available.

getNumberOfSatsUsed

public int getNumberOfSatsUsed()

Returns the number of satellites used to get a fix.

Returns:

the number of satellites used to get a fix.

getAltitudeUncertainty

public int getAltitudeUncertainty()

Returns the altitude uncertainty in millimeters as the measurement is taken.

Returns:

the altitude uncertainty of the fix.

getResponseCode

public int getResponseCode()

Returns the response code. Application can use this response code to validate the fix. The response code is defined in the PositionDevice class. Following are possible values:
POSITION_OK
FIX_NOT_ATTAINABLE
ACCURACY_NOT_ATTAINABLE
FIX_NOT_ATTAIN_ASSIST_DATA_UNAV
ACC_NOT_ATTAIN_ASSIST_DATA_UNAV
BATTERY_TOO_LOW
GPS_CHIPSET_MALFUNCTION
ALMANAC_OUT_OF_DATE
UNAVAILABLE

Returns:

an integer that indicates the response code of the position fix.

hasAltitude

public boolean hasAltitude()

Indicates if the altitude is available.

Returns:

true if altitude is available.

hasSpeed

public boolean hasSpeed()

Indicates if the speed is available.

Returns:

true if speed is available.

hasTravelDirection

public boolean hasTravelDirection()

Indicates if the travel direction is available.

Returns:

true if travel direction is available.

hasNumberOfSatsUsed

public boolean hasNumberOfSatsUsed()

Indicates if the number of satellites used to get a fix is available.

Returns:

true if the number of satellites used for the fix is available.

hasSpeedUncertainty

public boolean hasSpeedUncertainty()

Indicates if the speed uncertainty is available.

Returns:

true if speed uncertainty is available.

hasAltitudeUncertainty

public boolean hasAltitudeUncertainty()

Indicates if the altitude uncertainty is available.

Returns:

true if altitude uncertainty is available.

hasResponseCode

public boolean hasResponseCode()

Indicates if the response code is available.

Returns:

true if response code is available.