Location Acquisition API reference

This document provides a list of the main classes and types that are part of the Location Acquisition API. Each section gives a brief description of the purpose of the classes. The links can be followed to:

• Full reference documentation describing each class

• Guide material describing how to use the classes

This section describes the most important classes of the Location Acquisition API.

RPositionServer is the class used to make a connection to the location server.

RPositioner is the class used to create a sub-session with the location server for the purpose of obtaining the current position.

See also

Location Acquisition API overview

How to get location information

TCoordinate is the class that holds the basic coordinates of a location (latitude, longitude and altitude).

TLocality is the class that adds an error estimate for the horizontal and vertical accuracy of a TCoordinate.

TPosition is the standard data structure for retrieving location data. It adds a timestamp to the inherited TLocality information.

See also

Position data and info classes

Position data

TPositionInfo is the standard class for getting a TPosition location fix from the location server.

See also

Position data and info classes

How to get location information

TCourse is the class used to hold information about the current speed and direction of the device.

TPositionCourseInfo is the class for getting TCourse data from the location server.

TSatelliteData is the class that holds satellite data.

TPositionSatelliteInfo is the class for getting TSatelliteData from the location server.

HPositionGenericInfo is the class for passing extended position data between a client and the Location Server. This class is only supported on the S60 platform.

See also

Position data and info classes

TPositionCriteria is the position criteria class used to select a positioning module.

TPositionSelectionOrder is the class used as part of the TPositionCriteria class to chose a positioning module that will provide the desired quality of position.

See also

Positioning technology module selection criteria

How to use module selection criteria

TPositionModuleInfo is the class that holds information on position modules. This information includes the capabilities of the module, such as whether it can supply altitude or satellite data and the quality of position described by a TPositionQuality object.

TPositionQuality is the class that describes the quality of position that a positioning module can deliver.

See also

Positioning technology modules

How to use module information

TPositionModuleStatus is the class that describes a positioning module's status, such as whether it is ready or disabled.

TPositionModuleStatusEvent is the class used to indicate that a module status change has occurred.

TPositionUpdateOptions is the class used by a client to set position update options such as a request timeout and whether partial updates are accepted.

See also

Positioning technology module status

How to get module status changes

Use of these classes is required only on the S60 platform.

CRequestor defines a privacy requester (such as a service or contact) that is requesting location information.

RRequestorStack defines a stack of CRequestors and is used when requester acts on behalf of another to request location information.

See also

Privacy requester classes

To use the Location Acquisition API, client applications do the following:

• Include the appropriate header files defined in table 1 below.

  Header file	Contents
  lbs.h	Main client/server classes
  lbsclasstypes.h	Enumerated types used in the API
  lbscommon.h	API constants, positioning module status and quality classes
  lbscriteria.h	Positioning module criteria classes
  lbserrors.h	API error and panic codes
  lbsfieldids.h	Field ids used by extended data class HPositionGenericInfo
  lbsfields.h	HPositionGenericInfo definition.
  lbsipc.h	Values used for client/server IPC
  lbsipc.hrh	Values used for client/server IPC
  lbsposition.h	Position data classes TPosition, TCourse etc.
  lbspositioncalc.h	Maths functions class TPositionCalc
  lbspositioninfo.h	Position info classes TPositionInfo etc.
  lbsrequestor.h	Privacy requester classes.
  lbssatellite.h	Classes for satellite data and info.

  Table 1. Location Acquisition API header files.

• On the S60 platform, link against the library lbs.dll (import library is lbs.lib)

• On other platforms, link against the library lbsselflocate.dll (import library is lbsselflocate.lib)