Location Acquisition API Reference

This document lists the main classes of the Location Acquisition API with links to reference documentation.

Purpose

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

API classes and types

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

Client/server interaction classes

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

Position data classes

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

Data retrieval classes

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

Extended data retrieval classes

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.

See also

Position Data and Info Classes

Module information

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 Modules

How to Use Module Information

Module updates, status and events

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 Module Status

How to Get Module Status Changes

Privacy requester classes

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

Header files and libraries

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.

    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.

  • link against the library lbs.dll (import library is lbs.lib).