Finding -the location of a mobile device

The Location Acquisition API allows applications to access the location information of -a mobile device regardless of the location -technology used.

Typical use cases include:

Finding the location of a mobile device by using the Global -Positioning System (GPS).
Finding the location of a mobile device by network based -positioning.
Basic calculations using location information such as distances, -bearing, and timestamp (see TPosition and -Extended location information).

Important implementation considerations include:

Applications should close their RPositioner when -they do not need positioning for an extended period of time. Also, when staying -in background for more then a minute.Question -for the reviewers, is there any advice we can give the developers on this -issue (For example, can developers use something in TPositionUpdateOptions -to manage this issue?)
The system automatically selects an appropriate positioning -method, based on the type of the class given as input for Open (RPositionServer &aPosServer) method. The system tries all available methods until it succeeds. Generally -applications use this method. For special cases, applications can use Open -(RPositionServer &aPosServer, TPositionModuleId aModuleId) to -force system to use specified positioning method. In that case system does -not fallback in case of failure

- -

The Symbian SDK does not have a Map API, and therefore you must use -a third party API to display the location information you receive on a map.

- -

Getting the location -of a device -

To find the location of a mobile device:

Use the methods -of the Location Acquisition API to construct your application.
-
-
The RPositionServer and RPositioner classes -are particularly relevant in getting the location of your device, which is -typically stored in the TPositionInfo class.
-
For information on some detailed uses of the API, see the Location Acquisition -API Usage section for:
-
- a list of the steps required for finding the location of -a mobile device in a basic use case
- how to obtain the current location estimate
- how to obtain an extended location estimate, including information -such as bearing, speed, and available satellites, which is not normally returned -with the current location estimate
- how to obtain your last known position information, using -cached information if available. This means that this method does not retrieve -the location information from the underlying positioning methods.
-
-
Make sure lbs.lib is -accessible to your linker when compiling your application by including it -in your mmp file -or by editing the project properties in your IDE, depending on your build -environment.
Make sure -you have the correct capabilities information set for your application, depending -on your application you need at least Location.

Additional information -on locating your device -

For more information, see:

The purpose and general overview of the Location Acquisition -API.
The description and class structure of the API.
A general overview on how to create applications using the -API.
The LocationRefAppForS60 in the SDK (<SDK -installation directory>\S60CppExamples\AutoAdaptedToTouchEx), for -an example of how to use the Location Acquisition API.

Related APIs -

The Symbian platform also offers the following related services:

EXIF -API
- -
Allows you to include data, such as location information, in image files.
- -
Landmarks -API
- -
Allows you to store -location information on your mobile device.
- -
Bluetooth
- -
Allows you to use Bluetooth functions when creating connections between -your mobile device and a Bluetooth enabled GPS receiver.
- -
How -to Get Location Information
- -
Allows you to use the Location Acquisition API to obtain the position -of the mobile device from the LBS subsystem.
- -

+ + + + + +Finding +the location of a mobile device +

The Location Acquisition API allows applications to access the location information of +a mobile device regardless of the location +technology used.

Typical use cases include:

Finding the location of a mobile device by using the Global +Positioning System (GPS).
Finding the location of a mobile device by network based +positioning.
Basic calculations using location information such as distances, +bearing, and timestamp (see TPosition and +Extended location information).

Important implementation considerations include:

Applications should close their RPositioner when +they do not need positioning for an extended period of time. Also, when staying +in background for more then a minute.Question +for the reviewers, is there any advice we can give the developers on this +issue (For example, can developers use something in TPositionUpdateOptions +to manage this issue?)
The system automatically selects an appropriate positioning +method, based on the type of the class given as input for Open (RPositionServer &aPosServer) method. The system tries all available methods until it succeeds. Generally +applications use this method. For special cases, applications can use Open +(RPositionServer &aPosServer, TPositionModuleId aModuleId) to +force system to use specified positioning method. In that case system does +not fallback in case of failure

+ +

The Symbian SDK does not have a Map API, and therefore you must use +a third party API to display the location information you receive on a map.

+ +

Getting the location +of a device +

To find the location of a mobile device:

Use the methods +of the Location Acquisition API to construct your application.
+
+
The RPositionServer and RPositioner classes +are particularly relevant in getting the location of your device, which is +typically stored in the TPositionInfo class.
+
For information on some detailed uses of the API, see the Location Acquisition +API Usage section for:
+
- a list of the steps required for finding the location of +a mobile device in a basic use case
- how to obtain the current location estimate
- how to obtain an extended location estimate, including information +such as bearing, speed, and available satellites, which is not normally returned +with the current location estimate
- how to obtain your last known position information, using +cached information if available. This means that this method does not retrieve +the location information from the underlying positioning methods.
+
+
Make sure lbs.lib is +accessible to your linker when compiling your application by including it +in your mmp file +or by editing the project properties in your IDE, depending on your build +environment.
Make sure +you have the correct capabilities information set for your application, depending +on your application you need at least Location.

Additional information +on locating your device +

For more information, see:

The purpose and general overview of the Location Acquisition +API.
The description and class structure of the API.
A general overview on how to create applications using the +API.
The LocationRefAppForS60 in the SDK (<SDK +installation directory>\S60CppExamples\AutoAdaptedToTouchEx), for +an example of how to use the Location Acquisition API.

Related APIs +

The Symbian platform also offers the following related services:

EXIF +API
+ +
Allows you to include data, such as location information, in image files.
+ +
Landmarks +API
+ +
Allows you to store +location information on your mobile device.
+ +
Bluetooth
+ +
Allows you to use Bluetooth functions when creating connections between +your mobile device and a Bluetooth enabled GPS receiver.
+ +
How +to Get Location Information
+ +
Allows you to use the Location Acquisition API to obtain the position +of the mobile device from the LBS subsystem.
+ +

\ No newline at end of file