Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: LbsPositionInfo.h
Link against: lbsselflocate.lib

Class TPositionInfoBase

class TPositionInfoBase : public TPositionClassTypeBase;

Description

This class provides the interface used by RPositioner to get a location fix, and as such all classes used to get location info from the location server should derive from this class.

Class contains info about the update type and the ID of the module that gave the location fix

Derivation

Members

Defined in TPositionInfoBase:
ModuleId(), PositionMode(), PositionModeReason(), SetModuleId(), SetPositionMode(), SetPositionModeReason(), SetUpdateType(), TPositionInfoBase(), UpdateType(), iModuleId, iPositionMode, iPositionModeReason, iUpdateType

Inherited from TPositionClassTypeBase:
PositionClassSize(), PositionClassType(), iPosClassSize, iPosClassType


Construction and destruction


TPositionInfoBase()

protected: IMPORT_C TPositionInfoBase();

Description

Default constructor. Sets up class type information.

[Top]


Member functions


ModuleId()

IMPORT_C TPositionModuleId ModuleId() const;

Description

Returns the module Id of the module that gave the position fix

Return value

TPositionModuleId

Returns the module Id of the module that gave the position fix.


SetModuleId()

IMPORT_C void SetModuleId(TPositionModuleId aModuleId);

Description

Sets the Module Id stored in this class

Parameters

TPositionModuleId aModuleId

Module Id stored in this class is set to aModuleId.


UpdateType()

IMPORT_C TPositionUpdateType UpdateType() const;

Description

Returns the update type of the position fix.

Return value

TPositionUpdateType

Returns the update type of the position fix.


SetUpdateType()

IMPORT_C void SetUpdateType(TPositionUpdateType aUpdateType);

Description

Sets The update type of the position fix in this class

Parameters

TPositionUpdateType aUpdateType

The update type of the position fix in this class is set to this.


PositionMode()

IMPORT_C TPositionModuleInfo::TTechnologyType PositionMode() const;

Description

see TPositionModuleInfo::TTechnologyType

Return value

TPositionModuleInfo::TTechnologyType

Returns the actual mode used by the positioning module to calculate the position fix. A positioning module may not always be able to use the preferred location calculation mode. For example, if preferred mode is "terminal-assisted" but the phone is out of network coverage it may have used autonomous mode instead.


SetPositionMode()

IMPORT_C void SetPositionMode(TPositionModuleInfo::TTechnologyType aMode);

Description

see TPositionModuleInfo::TTechnologyType

Parameters

TPositionModuleInfo::TTechnologyType aMode

The mode used to calculate the position fix contained in this class. For example, terminal only (autonomous), terminal-assisted, network only or network-assisted.


PositionModeReason()

IMPORT_C TPositionModeReason PositionModeReason() const;

Description

see PositionMode see _TPositionModeReason

Return value

TPositionModeReason

Returns why the positioning mode used to calculate the position fix was different from the prefered mode. For example, this could indicate that the phone is out of network coverage.The method returns a bit mask the reasons why the position module was unable calculate the position in the prefered mode. EPositionModeReasonNone is returned if the mode used was the preferred.EPositionModeReasonNetworkError is returned when there is no network coverage or the service is unavailable.EPositionModeReasonLocalError represents environmental reasons that prevent a terminal based calculation. For example, no satellites are in view.EPositionModeReasonDataError is returned when there is a problem with the initialisation data. For example, GPS assistance data was received but it was either invalid or could not be used.


SetPositionModeReason()

IMPORT_C void SetPositionModeReason(TPositionModeReason aReason);

Description

see TPositionModuleInfo::TTechnologyType

Parameters

TPositionModeReason aReason

The mode used to calculate the position fix contained in this class was different from the prefered mode.

[Top]


Member data


iModuleId

protected: TPositionModuleId iModuleId;

Description

The Id of the module that gave the location fix.


iUpdateType

protected: TUint32 iUpdateType;

Description

The type of update that this location fix represents.


iPositionMode

protected: TPositionModuleInfo::TTechnologyType iPositionMode;

Description

The positioning mode used to calculate this location fix.


iPositionModeReason

protected: TPositionModeReason iPositionModeReason;

Description

The reason why the prefered position mode was not used.