javax.microedition.location
Class QualifiedCoordinates

java.lang.Object
  javax.microedition.location.Coordinates
      javax.microedition.location.QualifiedCoordinates

public class QualifiedCoordinates
extends Coordinates

The QualifiedCoordinates class represents coordinates as latitude-longitude-altitude values that are associated with an accuracy value.

Since:

BlackBerry API 4.0.2

Field Summary

Fields inherited from class javax.microedition.location.Coordinates

DD_MM, DD_MM_SS

Constructor Summary

QualifiedCoordinates(double latitude, double longitude, float altitude, float horizontalAccuracy, float verticalAccuracy)
Constructs a new QualifiedCoordinates object with the values specified.

Method Summary
float	getHorizontalAccuracy() Returns the horizontal accuracy of the location in meters (1-sigma standard deviation).
float	getVerticalAccuracy() Returns the accuracy of the location in meters in vertical direction (orthogonal to ellipsoid surface, 1-sigma standard deviation).
void	setHorizontalAccuracy(float horizontalAccuracy) Sets the horizontal accuracy of the location in meters (1-sigma standard deviation).
void	setVerticalAccuracy(float verticalAccuracy) Sets the accuracy of the location in meters in vertical direction (orthogonal to ellipsoid surface, 1-sigma standard deviation).

Methods inherited from class javax.microedition.location.Coordinates

azimuthTo, convert, convert, distance, getAltitude, getLatitude, getLongitude, setAltitude, setLatitude, setLongitude

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

QualifiedCoordinates

public QualifiedCoordinates(double latitude,
                            double longitude,
                            float altitude,
                            float horizontalAccuracy,
                            float verticalAccuracy)

Constructs a new QualifiedCoordinates object with the values specified. The latitude and longitude parameters are expressed in degrees using floating point values. The degrees are in decimal values (rather than minutes/seconds).

The coordinate values always apply to the WGS84 datum.

The Float.NaN value can be used for altitude to indicate that altitude is not known.

Parameters:

latitude - the latitude of the location. Valid range: [-90.0, 90.0]

longitude - the longitude of the location. Valid range: [-180.0, 180.0)

altitude - the altitude of the location in meters, defined as height above WGS84 ellipsoid. Float.NaN can be used to indicate that altitude is not known.

horizontalAccuracy - the horizontal accuracy of this location result in meters. Float.NaN can be used to indicate that the accuracy is not known. Must be greater or equal to 0.

verticalAccuracy - the vertical accuracy of this location result in meters. Float.NaN can be used to indicate that the accuracy is not known. Must be greater or equal to 0.

Throws:

IllegalArgumentException - if an input parameter is out of the valid range

Since:

BlackBerry API 4.0.2

Method Detail

getHorizontalAccuracy

public float getHorizontalAccuracy()

Returns the horizontal accuracy of the location in meters (1-sigma standard deviation). A value of Float.NaN means the horizontal accuracy could not be determined.

The horizontal accuracy is the RMS (root mean square) of east accuracy (latitudinal error in meters, 1-sigma standard deviation), north accuracy (longitudinal error in meters, 1-sigma).

Returns:

the horizontal accuracy in meters. Float.NaN if this is not known

Since:

BlackBerry API 4.0.2

getVerticalAccuracy

public float getVerticalAccuracy()

Returns the accuracy of the location in meters in vertical direction (orthogonal to ellipsoid surface, 1-sigma standard deviation). A value of Float.NaN means the vertical accuracy could not be determined.

Returns:

the vertical accuracy in meters. Float.NaN if this is not known.

Since:

BlackBerry API 4.0.2

setHorizontalAccuracy

public void setHorizontalAccuracy(float horizontalAccuracy)

Sets the horizontal accuracy of the location in meters (1-sigma standard deviation). A value of Float.NaN means the horizontal accuracy could be determined.

The horizontal accuracy is the RMS (root mean square) of east accuracy (latitudinal error in meters, 1-sigma standard deviation), north accuracy (longitudinal error in meters, 1-sigma).

Parameters:

horizontalAccuracy - the horizontal accuracy of this location result in meters. Float.NaN means the horizontal accuracy could not be determined. Must be greater or equal to 0.

Since:

BlackBerry API 4.0.2

setVerticalAccuracy

public void setVerticalAccuracy(float verticalAccuracy)

Sets the accuracy of the location in meters in vertical direction (orthogonal to ellipsoid surface, 1-sigma standard deviation). A value of Float.NaN means the vertical accuracy could be determined.

Parameters:

verticalAccuracy - the vertical accuracy of this location result in meters. Float.NaN means the horizontal accuracy could not be determined. Must be greater or equal to 0.

Since:

BlackBerry API 4.0.2