public interface GeoLocation
see 3GPP TS 23.032 [14] Universal Geographical Area Description (GAD)
Modifier and Type | Field and Description |
---|---|
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 |
VERTICAL_AND_HORIZONTAL_VELOCITY_REQUESTED
Vertical velocity requested in addition to horizontal velocity
|
static byte |
HORIZONTAL_VELOCITY_REQUESTED_WITH_UNCERTAINTY
Uncertainty of horizontal velocity requested in addition to horizontal velocity
|
static byte |
VERTICAL_AND_HORIZONTAL_VELOCITY_REQUESTED_WITH_UNCERTAINTY
Uncertainty of vertical and horizontal velocity requested in addition to horizontal and vertical velocity
|
static byte |
GET_HORIZONTAL_VELOCITY
Obtain Horizontal Velocity Field from Velocity information.
|
static byte |
GET_VERTICAL_VELOCITY
Obtain Vertical Velocity Field from Velocity information.
|
static byte |
GET_HORIZONTAL_UNCERTAINTY_VELOCITY
Obtain Horizontal Uncertainty Velocity Field from Velocity information.
|
static byte |
GET_VERTICAL_UNCERTAINTY_VELOCITY
Obtain Vertical Uncertainty Velocity Field from Velocity information.
|
static byte |
VERTICAL_COORDINATE_NOT_REQUESTED
Vertical coordinate: not requested
|
static byte |
VERTICAL_COORDINATE_REQUESTED_BEST_EFFORT
Vertical coordinate: best effort
|
static byte |
PREFERRED_NMEA_SENTENCE_RMC
Preferred NMEA sentence: _RMC
|
static byte |
PREFERRED_NMEA_SENTENCE_GGA
Preferred NMEA sentence: _GGA
|
static byte |
PREFERRED_NMEA_SENTENCE_GLL
Preferred NMEA sentence: _GLL
|
static byte |
PREFERRED_NMEA_SENTENCE_GNS
Preferred NMEA sentence: _GNS
|
Modifier and Type | Method and Description |
---|---|
void |
performGeoLocationRequest(GeoLocationEventListener geoLocationEventListener)
Request a geographical location operation, using parameters defined in the object.
|
GeoLocationInfo |
performGeoLocationRequest(uicc.toolkit.ProactiveHandler proHandler)
Deprecated.
The method performGeoLocation(GeoLocationEventListener geoLocationEventListener) replace this method.
|
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 |
setPreferredMaximumResponseTime(byte preferredMaximumResponseTime)
Set Preferred Maximum Response Time parameter for this object as defined in 3GPP TS 31.111 [7].
|
void |
setPreferredNMEASentences(byte preferredNMEASentences)
Set Preferred NMEA sentences 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].
|
void |
setAlphaIdentifier(byte[] alphaIdentifier)
Set alpha identifier parameter for this object as defined in 3GPP TS 31.111 [7].
|
void |
setIconIdentifier(short iconIdentifier)
Set icon identifier parameter for this object as defined in 3GPP TS 31.111 [7].
|
static final byte HORIZONTAL_ACCURACY_BEST_EFFORT
static final byte VERTICAL_COORDINATE_NOT_REQUESTED
static final byte VERTICAL_COORDINATE_REQUESTED_BEST_EFFORT
static final byte HORIZONTAL_VELOCITY_REQUESTED
static final byte VERTICAL_AND_HORIZONTAL_VELOCITY_REQUESTED
static final byte HORIZONTAL_VELOCITY_REQUESTED_WITH_UNCERTAINTY
static final byte VERTICAL_AND_HORIZONTAL_VELOCITY_REQUESTED_WITH_UNCERTAINTY
static final byte GET_HORIZONTAL_VELOCITY
static final byte GET_VERTICAL_VELOCITY
static final byte GET_HORIZONTAL_UNCERTAINTY_VELOCITY
static final byte GET_VERTICAL_UNCERTAINTY_VELOCITY
static final byte GAD_SHAPES_ELLIPSOID_POINT
static final byte GAD_SHAPES_ELLIPSOID_POINT_WITH_UNCERTAINTY_CIRCLE
static final byte GAD_SHAPES_ELLIPSOID_POINT_WITH_UNCERTAINTY_ELLIPSE
static final byte GAD_SHAPES_ELLIPSOID_POINT_WITH_ALTITUDE
static final byte GAD_SHAPES_POLYGON
static final byte GAD_SHAPES_ELLIPSOID_POINT_WITH_ALTITUDE_AND_UNCERTAINTY_ELLIPSOID
static final byte GAD_SHAPES_ELLIPSOID_ARC
static final byte PREFERRED_NMEA_SENTENCE_RMC
static final byte PREFERRED_NMEA_SENTENCE_GGA
static final byte PREFERRED_NMEA_SENTENCE_GLL
static final byte PREFERRED_NMEA_SENTENCE_GNS
void setHorizontalAccuracy(byte horizontalAccuracy)
GeoLocationException
- with the following reason code: INCORRECT_PARAMETERS
in case of bad parameter is set.
void setVerticalCoordinate(byte verticalCoordinate)
GeoLocationException
- with the following reason code: INCORRECT_PARAMETERS
in case of bad parameter is set.
void setVelocity(byte velocity)
VelocityType
- byte to identify the Velocity Type to return. Possible value, one or combination (OR operation) of:GeoLocationException
- with the following reason code: INCORRECT_PARAMETERS
in case of bad parameter is set.
void setAcceptedGADShapes(byte acceptedGADShapes)
GeoLocationException
- with the following reason code: INCORRECT_PARAMETERS
in case of bad parameter is set.
void setPreferredNMEASentences(byte preferredNMEASentences)
GeoLocationException
- with the following reason code: INCORRECT_PARAMETERS
in case of bad parameter is set.
void setPreferredMaximumResponseTime(byte preferredMaximumResponseTime)
GeoLocationException
- with the following reason code: INCORRECT_PARAMETERS
in case of bad parameter is set.
void performGeoLocationRequest(GeoLocationEventListener geoLocationEventListener) throws GeoLocationException
geoLocationEventListener
object.GeoLocationInformation
object.
geoLocationEventListener
- the callback object to be invoked once the result is available.java.lang.NullPointerException
- if geoLocationEventListener
is null
GeoLocationException
- with the following reason codes: FUNCTION_DISABLED
in case the ME is currently unable to get the location information (e.g. due to lack of GPS coverage or due to a deactivated GPS receiver).
UNABLE_TO_PROCESS_COMMAND
in case the ME is not equipped with a positioning feature LOCATION_REQUEST_PROCESSING
in case a Geographical Location Request has already been issued and the Envelope Geographical Location Reporting is expected.
HANDLER_NOT_AVAILABLE
if there is on-going proactive session
void setAlphaIdentifier(byte[] alphaIdentifier)
void setIconIdentifier(short iconIdentifier)
GeoLocationException
- with the following reason code: INCORRECT_PARAMETERS
in case of bad parameter is set.