Motorola Inc. | i88s J2ME Developers’ Guide |
Accuracy
The i88s phone is designed to receive location fixes within a preset level of geographic accuracy as determined by the network provider. Using the Position API, J2ME developers can retrieve a fix; however, the location value is not guaranteed to be within this level of accuracy. The API provides methods to determine whether a given fix is accurate or not.
Assist Data
AGPS uses cellular assisted data to retrieve a location fix. The Position API provides J2ME developers with a method to determine whether cellular assisted data is used for a given fix.
1.2The Position API
Position API is located in the com.motorola.iden.position package. The API provides the location functionalities required for Java applications to access GPS position information such as the following:
•Latitude
•Longitude
•Altitude
•Time Stamp
•Travel Direction
•Speed
•Altitude Uncertainty
•Speed Uncertainty
The Position API uses the GPS Privacy setting in the Main Menu of the i88s phone when a MIDlet invokes the API. Based on the GPS Privacy setting value, the MIDlet does or does not have the access to the position information. The API will use the users’ Privacy setting accordingly before providing position information. Some examples include:
•If the user’s GPS Privacy setting is set to “Restricted”, the Java API will return the position with all the attributes set to UNAVAILABLE and with the
PositionConnection’s status code set to POSITION_RESPONSE_RESTRICTED.
•If the user’s GPS Privacy setting is set to “Unrestricted”, the Java API will be able to access GPS data and will return the position.
•If the user’s GPS Privacy setting is set to “By Permission”, the application will be suspended as the Java API will bring up a system screen to prompt the user for permission to grant position access for this application. If the user does not grant permission, the Java API will return the position with all the attributes set to
UNAVAILABLE and with the PositionConnection’s status code set to
POSITION_RESPONSE_RESTRICTED. After selecting one of the permission options, the user needs to resume the application.
Version 1.0 - Page 6