diff -r 913c9751c067 -r 716254ccbcc0 org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-53CE4DE6-F065-4339-8C18-5C30A9540053.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-53CE4DE6-F065-4339-8C18-5C30A9540053.html Fri Mar 05 19:11:15 2010 -0800 @@ -0,0 +1,44 @@ + + +JavaScript Location +Service API

JavaScript Location +Service API

+

The Location +Service API is supported since WRT 1.1.

+

The Location Service API allows widgets to retrieve information +about the physical location of a device and to perform calculations based +on location information. The API is integrated into WRT through the device object.

+

For an overview of the service and the API, see section Accessing device location information.

+

Using the Location Service API

+

To use the Location Service API, your widget must first create a service object for it +using the device.getServiceObject() method. +Use Service.Location to identify the service provider +and ILocation to identify the supported interface:

+
var so = device.getServiceObject("Service.Location", "ILocation");
+ +

This service object can then be used to access the services provided +by the API:

+ +

For the location services to function on an S60 device, the device must +be location aware. It must include some location information provider, such +as GPS, AGPS, or GPS across Bluetooth.

+
+

Emulator support

+

The S60 5th Edition SDK emulator provides full support for the Location +Service API.

+

GPS data is simulated by using Position System plugins (PSY) as dummy +providers. Dummy providers are available on the emulator by default.

+
+
\ No newline at end of file