com.motorola.iden.position
Interface Position2D

All Known Subinterfaces:

AggregatePosition

public interface Position2D

Provides the location information on Fix (Serving cell Latitude, Longitude, Latitude, Longitude, Uncertainty, Fix Time, Assistance Used).

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.

Field Summary

static int	DEG_MIN A constant to set the output format of getLongitude() or getLatitude() as "Direction DD MM.MMMM".
static int	DEG_MIN_SEC A constant to set the output format of getLongitude() or getLatitude() as "Direction DD MM SS.SS".
static int	DEGREES A constant to set the output format of getLongitude() or getLatitude() as "Direction DD.DDDDDD".
static int	UNAVAILABLE A constant that indicates position information that is not available.

Method Summary

boolean	getAssistanceUsed() Returns a boolean value indicating whether assistance was used.
int	getLatitude() Returns the latitude of the position in 1/100,000 minutes.
java.lang.String	getLatitude(int Format) Returns the latitude of a the position as a String (degrees and minutes notation)
int	getLatLonAccuracy() Returns the latitude and longitude accuracy in millimeter.
int	getLongitude() Returns the longitude of the position in 1/100,000 minutes.
java.lang.String	getLongitude(int Format) Returns the longitude of the position as a String (degrees and minutes notation)
int	getServingCellLatitude() Returns the serving cell latitude in 1/100,000 minutes.
java.lang.String	getServingCellLatitude(int Format) Returns the serving cell latitude as a String.
int	getServingCellLongitude() Returns the serving cell longitude in 1/100,000 minutes.
java.lang.String	getServingCellLongitude(int Format) Returns the serving cell longitude of the position as a String.
long	getTimeStamp() Returns the time stamp in milliseconds taken during the position fix.
boolean	hasAssistanceUsed() Indicates if the assistance was used.
boolean	hasLatLon() Indicates if the latitude and longitude is available.
boolean	hasLatLonAccuracy() Indicates if the latitude and longitude accuracy is available.
boolean	hasServingCellLatLon() Indicates if the latitude and longitude of the serving cell is available.
boolean	hasTimeStamp() Indicate if the time stamp is available.

Field Detail

UNAVAILABLE

public static final int UNAVAILABLE

A constant that indicates position information that is not available.

DEGREES

public static final int DEGREES

A constant to set the output format of getLongitude() or getLatitude() as "Direction DD.DDDDDD". For example, North 26.146131 Degrees is printed as "N 26.146131".

DEG_MIN

public static final int DEG_MIN

A constant to set the output format of getLongitude() or getLatitude() as "Direction DD MM.MMMM". For example, North 26 Degrees 8.767840 Minutes is printed as "N 26 8.767840".

DEG_MIN_SEC

public static final int DEG_MIN_SEC

A constant to set the output format of getLongitude() or getLatitude() as "Direction DD MM SS.SS". For example, North 26 Degrees 8 Minutes 46.070400 Seconds is printed as "N 26 8 46.070400".

Method Detail

getLatitude

public int getLatitude()

Returns the latitude of the position in 1/100,000 minutes. For example, the "North 26 Degrees 8.767840 Minutes" is represented as (26 * 60 * 100000 + 8.767840 * 100000) = 156876784. So, the Latitude Degrees part = getLatitude()/6000000; and the Latitude Minutes part = getLatitude() - (getLatitude()/6000000) * 60 * 100000.

Returns:

the latitude of the position. The return value ranges from -540000000 to 540000000, with negative being south, and positive being north. UNAVAILABLE is returned if latitude is not available.

getLongitude

public int getLongitude()

Returns the longitude of the position in 1/100,000 minutes. For example, the "WEST 80 Degrees 15.222400 Minutes" is represented as - (80 * 60 * 100000 + 15.222400 * 100000) = - 481522240. So, the Longitude Degrees part = getLongitude()/6000000; and the Longitude Minutes part = getLongitude() - (getLongitude()/6000000) * 60 * 100000.

Returns:

the longitude of the position. The return value ranges from -1080000000 to 1080000000, with negative being west, and positive being east. UNAVAILABLE is returned if longitude is not available.

getLatitude

public java.lang.String getLatitude(int Format)

Returns the latitude of a the position as a String (degrees and minutes notation)

Returns:

(1) The latitude in "Direction DD.DDDDDD" (Degrees format) if Format = DEGREES. (2) The latitude in "Direction DD MM.MMMM" (Degrees and Minutes format) if Format = DEG_MIN. (3) The latitude in "Direction DD MM SS.SS" (Degrees, Minutes and Seconds format) if Format = DEG_MIN_SEC. Here, Direction = N or S.

getLongitude

public java.lang.String getLongitude(int Format)

Returns the longitude of the position as a String (degrees and minutes notation)

Returns:

(1) The longitude in "Direction DDD.DDDDDD" (Degrees format) if Format = DEGREES. (2) The longitude in "Direction DDD MM.MMMM" (Degrees and Minutes format) if Format = DEG_MIN. (3) The longitude in "Direction DDD MM SS.SS" (Degrees, Minutes and Seconds format) if Format = DEG_MIN_SEC. Here, Direction = E or W

getLatLonAccuracy

public int getLatLonAccuracy()

Returns the latitude and longitude accuracy in millimeter.

Returns:

latitude and longitude accuracy in millimeters.

getServingCellLatitude

public int getServingCellLatitude()

Returns the serving cell latitude in 1/100,000 minutes. For example, the "North 26 Degrees 8.767840 Minutes" is represented as (26 * 60 * 100000 + 8.767840 * 100000) = 156876784. So, the Latitude Degrees part = getLatitude()/6000000; and the Latitude Minutes part = getLatitude() - (getLatitude()/6000000) * 60 * 100000.

Returns:

the latitude of the serving cell's position. The return value ranges from -540000000 to 540000000, with negative being south, and positive being north. Zero is returned if serving cell latitude is not available.

getServingCellLatitude

public java.lang.String getServingCellLatitude(int Format)

Returns the serving cell latitude as a String.

Returns:

(1) The latitude in "Direction DD.DDDDDD" (Degrees format) if Format = DEGREES. (2) The latitude in "Direction DD MM.MMMM" (Degrees and Minutes format) if Format = DEG_MIN. (3) The latitude in "Direction DD MM SS.SS" (Degrees, Minutes and Seconds format) if Format = DEG_MIN_SEC. Here, Direction = N or S.

getServingCellLongitude

public int getServingCellLongitude()

Returns the serving cell longitude in 1/100,000 minutes. For example, the "WEST 80 Degrees 15.222400 Minutes" is represented as - (80 * 60 * 100000 + 15.222400 * 100000) = - 481522240. So, the Longitude Degrees part = getLongitude()/6000000; and the Longitude Minutes part = getLongitude() - (getLongitude()/6000000) * 60 * 100000.

Returns:

the longitude of the serving cell's position. The return value ranges from -1080000000 to 1080000000, with negative being west, and positive being east. UNAVAILABLE is returned if longitude is not available.

getServingCellLongitude

public java.lang.String getServingCellLongitude(int Format)

Returns the serving cell longitude of the position as a String.

Returns:

(1) The longitude in "Direction DDD.DDDDDD" (Degrees format) if Format = DEGREES. (2) The longitude in "Direction DDD MM.MMMM" (Degrees and Minutes format) if Format = DEG_MIN. (3) The longitude in "Direction DDD MM SS.SS" (Degrees, Minutes and Seconds format) if Format = DEG_MIN_SEC. Here, Direction = E or W

getTimeStamp

public long getTimeStamp()

Returns the time stamp in milliseconds taken during the position fix.

Returns:

the time of the measurement or UNAVAILABLE if the time is invalid.

getAssistanceUsed

public boolean getAssistanceUsed()

Returns a boolean value indicating whether assistance was used.

Returns:

true if the assistance data is used in this position.

hasLatLon

public boolean hasLatLon()

Indicates if the latitude and longitude is available.

Returns:

true if latitude and longitude is available.

hasServingCellLatLon

public boolean hasServingCellLatLon()

Indicates if the latitude and longitude of the serving cell is available.

Returns:

true if latitude and longitude of serving cell is available.

hasLatLonAccuracy

public boolean hasLatLonAccuracy()

Indicates if the latitude and longitude accuracy is available.

Returns:

true if latitude and longitude accuracy is available.

hasTimeStamp

public boolean hasTimeStamp()

Indicate if the time stamp is available.

Returns:

true if timestamp is available.

hasAssistanceUsed

public boolean hasAssistanceUsed()

Indicates if the assistance was used.

Returns:

true if the assistance was used.