Appendix: GPS Functionality

GPS stands for Global Positioning System. The GPS uses satellites to transmit precise microwave signals. The mobile devices with GPS receivers derive the current location, time, and velocity of the device from the signals.

GPS functionality has the following three main components:

Absolute location - determines the location of the user
Relative movement - useful in applications related to Seismology and Astronomical Sciences
Time transfer - clock synchronization that enables time transfer.

These components determine the current position of the user based on the following factors:

Cellular ID
Longitude
Latitude.

GPS functionality is useful in the following scenarios:

Commerce - to locate a nearby ATM or a hotel
Scientific Uses - to determine planetary movements
Tracking - vehicle tracking
Surveillance.

Kony Visualizer has implemented the GPS functionality using W3C standards. As per the W3C standards, the HTML 5.0 tags allow the web browsers within an application or a browser on a mobile device to directly access and use the location data. Kony Visualizer provides you the option of enabling an application to use the GPS functionality, which internally uses the HTML 5.0 tags to fetch the current location data.

Supported Platforms on Mobile Web

Mobile Web supports GPS functionality for the following platforms:

iPhone
Android

Process for Capturing Location Details

You must specify that the application should capture the location details by selecting Requires GPS under Mobile Web Properties.

The location details are obtained using the Javascript APIs supported by the web browsers.
Set Capture GPS property for the form on which you want to capture the GPS details. For more information about this property, see Kony Widget User Guide.
When you set the above mentioned property on a form, the application displays a popup seeking permission from the user to access the location details.
If the user cancels this popup, an error with error code 102 (Location API access is denied by user) is thrown. This error can be handled by the application.
If the user allows the popup, the Javascript API is executed which captures the location details of the application. These details are updated on the kony Application Server.
The details updated on the Kony Application Server are returned when phone.mylocation API is invoked on the device.

For more information about phone.mylocation API, see Kony API Reference Guide.