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:
JDE 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:
JDE 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:
JDE 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:
JDE 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:
JDE 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:
JDE 4.0.2



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.