uicc.usim.geolocation
Interface GeoLocation


public interface GeoLocation

This interface defines services allowing an application to get information on the ME current geographical location. Depending on card and terminal capabilities, different means may be used to compute geographical location.

see 3GPP TS 23.032 [14] Universal Geographical Area Description (GAD)


Field Summary
static byte GAD_SHAPES_ELLIPSOID_ARC
          GAD shape: Ellipsoid arc
static byte GAD_SHAPES_ELLIPSOID_POINT
          GAD shape: Ellipsoid point
static byte GAD_SHAPES_ELLIPSOID_POINT_WITH_ALTITUDE
          GAD shape: Ellipsoid point with altitude
static byte GAD_SHAPES_ELLIPSOID_POINT_WITH_ALTITUDE_AND_UNCERTAINTY_ELLIPSOID
          GAD shape: Ellipsoid point with altitude and uncertainty ellipsoid
static byte GAD_SHAPES_ELLIPSOID_POINT_WITH_UNCERTAINTY_CIRCLE
          GAD shape: Ellipsoid point with uncertainty circle
static byte GAD_SHAPES_ELLIPSOID_POINT_WITH_UNCERTAINTY_ELLIPSE
          GAD shape: Ellipsoid point with uncertainty ellipse
static byte GAD_SHAPES_POLYGON
          GAD shape: Polygon
static byte HORIZONTAL_ACCURACY_BEST_EFFORT
          Horizontal accuracy: best effort
static byte HORIZONTAL_VELOCITY_REQUESTED
          Horizontal velocity requested
static byte UNCERTAINTY_OF_HORIZONTAL_VELOCITY_REQUESTED
          Uncertainty of horizontal velocity requested in addition to horizontal velocity
static byte UNCERTAINTY_OF_VERTICAL_VELOCITY_REQUESTED
          Uncertainty of vertical velocity requested in addition to horizontal and vertical velocity
static byte VERTICAL_COORDINATE_NOT_REQUESTED
          Vertical coordinate: not requested
static byte VERTICAL_COORDINATE_REQUESTED_BEST_EFFORT
          Vertical coordinate: best effort
static byte VERTICAL_VELOCITY_REQUESTED
          Vertical velocity requested in addition to horizontal velocity
 
Method Summary
 GeoLocationInfo performGeoLocationRequest(uicc.toolkit.ProactiveHandler proHandler)
          Request a geographical location operation, using parameters defined in the object.
 void setAcceptedGADShapes(byte acceptedGADShapes)
          Set accepted GAD shapes parameter for this object as defined in 3GPP TS 31.111 [7].
 void setHorizontalAccuracy(byte horizontalAccuracy)
          Set horizontal accuracy parameter for this object as defined in 3GPP TS 31.111 [7].
 void setVelocity(byte velocity)
          Set velocity parameter for this object as defined in 3GPP TS 31.111 [7].
 void setVerticalCoordinate(byte verticalCoordinate)
          Set vertical coordinate parameter for this object as defined in 3GPP TS 31.111 [7].
 

Field Detail

HORIZONTAL_ACCURACY_BEST_EFFORT

static final byte HORIZONTAL_ACCURACY_BEST_EFFORT
Horizontal accuracy: best effort

See Also:
Constant Field Values

VERTICAL_COORDINATE_NOT_REQUESTED

static final byte VERTICAL_COORDINATE_NOT_REQUESTED
Vertical coordinate: not requested

See Also:
Constant Field Values

VERTICAL_COORDINATE_REQUESTED_BEST_EFFORT

static final byte VERTICAL_COORDINATE_REQUESTED_BEST_EFFORT
Vertical coordinate: best effort

See Also:
Constant Field Values

HORIZONTAL_VELOCITY_REQUESTED

static final byte HORIZONTAL_VELOCITY_REQUESTED
Horizontal velocity requested

See Also:
Constant Field Values

VERTICAL_VELOCITY_REQUESTED

static final byte VERTICAL_VELOCITY_REQUESTED
Vertical velocity requested in addition to horizontal velocity

See Also:
Constant Field Values

UNCERTAINTY_OF_HORIZONTAL_VELOCITY_REQUESTED

static final byte UNCERTAINTY_OF_HORIZONTAL_VELOCITY_REQUESTED
Uncertainty of horizontal velocity requested in addition to horizontal velocity

See Also:
Constant Field Values

UNCERTAINTY_OF_VERTICAL_VELOCITY_REQUESTED

static final byte UNCERTAINTY_OF_VERTICAL_VELOCITY_REQUESTED
Uncertainty of vertical velocity requested in addition to horizontal and vertical velocity

See Also:
Constant Field Values

GAD_SHAPES_ELLIPSOID_POINT

static final byte GAD_SHAPES_ELLIPSOID_POINT
GAD shape: Ellipsoid point

See Also:
Constant Field Values

GAD_SHAPES_ELLIPSOID_POINT_WITH_UNCERTAINTY_CIRCLE

static final byte GAD_SHAPES_ELLIPSOID_POINT_WITH_UNCERTAINTY_CIRCLE
GAD shape: Ellipsoid point with uncertainty circle

See Also:
Constant Field Values

GAD_SHAPES_ELLIPSOID_POINT_WITH_UNCERTAINTY_ELLIPSE

static final byte GAD_SHAPES_ELLIPSOID_POINT_WITH_UNCERTAINTY_ELLIPSE
GAD shape: Ellipsoid point with uncertainty ellipse

See Also:
Constant Field Values

GAD_SHAPES_ELLIPSOID_POINT_WITH_ALTITUDE

static final byte GAD_SHAPES_ELLIPSOID_POINT_WITH_ALTITUDE
GAD shape: Ellipsoid point with altitude

See Also:
Constant Field Values

GAD_SHAPES_POLYGON

static final byte GAD_SHAPES_POLYGON
GAD shape: Polygon

See Also:
Constant Field Values

GAD_SHAPES_ELLIPSOID_POINT_WITH_ALTITUDE_AND_UNCERTAINTY_ELLIPSOID

static final byte GAD_SHAPES_ELLIPSOID_POINT_WITH_ALTITUDE_AND_UNCERTAINTY_ELLIPSOID
GAD shape: Ellipsoid point with altitude and uncertainty ellipsoid

See Also:
Constant Field Values

GAD_SHAPES_ELLIPSOID_ARC

static final byte GAD_SHAPES_ELLIPSOID_ARC
GAD shape: Ellipsoid arc

See Also:
Constant Field Values
Method Detail

setHorizontalAccuracy

void setHorizontalAccuracy(byte horizontalAccuracy)
Set horizontal accuracy parameter for this object as defined in 3GPP TS 31.111 [7].


setVerticalCoordinate

void setVerticalCoordinate(byte verticalCoordinate)
Set vertical coordinate parameter for this object as defined in 3GPP TS 31.111 [7].


setVelocity

void setVelocity(byte velocity)
Set velocity parameter for this object as defined in 3GPP TS 31.111 [7].


setAcceptedGADShapes

void setAcceptedGADShapes(byte acceptedGADShapes)
Set accepted GAD shapes parameter for this object as defined in 3GPP TS 31.111 [7].


performGeoLocationRequest

GeoLocationInfo performGeoLocationRequest(uicc.toolkit.ProactiveHandler proHandler)
                                          throws java.lang.NullPointerException,
                                                 GeoLocationException
Request a geographical location operation, using parameters defined in the object. If the ME has indicated in its Terminal Profile that it supports "class n" ("Geographical Location Request" see TS 31.111[7] for more details) the system will first send out a "Geographical Location Request" proactive command.