Collapse all Symbian^3 Application Developer Library

TLbsNetPosRequestQuality Class Reference

class TLbsNetPosRequestQuality : public TLbsNetClassTypeBase

The TLbsNetPosRequestQuality is used by the network protocol module to specify the desired quality of a location request. An instance of the class is passed by the protocol module when it calls MLbsNetworkProtocolObserver::ProcessLocationRequest .

The parameters in TLbsNetPosRequestQuality include the desired minumum horizontal and vertical accuracy for the requested location update. It also enables a time limit and age of the fix to be specified.

The time limit indicates the maximum time the device should spend calculating before it responses to network.

The maximum fix age indicates that the network will accept a previous location calculation that is within the given time period.

It is possible to combine both the desired minimum accuracy and the maximum time. In this situation the LBS subsystem should respond either when the desired accuracy has been achieved or when the time limit has been reached.

CLbsLocationSourceBase::RequestLocationUpdate MLbsLocationSourceObserver

Inherits from

TLbsNetPosRequestQuality
- TLbsNetClassTypeBase

Public Member Functions
	TLbsNetPosRequestQuality ()
IMPORT_C TTimeIntervalMicroSeconds	MaxFixAge ()
IMPORT_C TTimeIntervalMicroSeconds	MaxFixTime ()
IMPORT_C TReal32	MinHorizontalAccuracy ()
IMPORT_C TReal32	MinVerticalAccuracy ()
IMPORT_C void	SetMaxFixAge ( TTimeIntervalMicroSeconds )
IMPORT_C void	SetMaxFixTime ( TTimeIntervalMicroSeconds )
IMPORT_C void	SetMinHorizontalAccuracy ( TReal32 )
IMPORT_C void	SetMinVerticalAccuracy ( TReal32 )

Inherited Functions
	TLbsNetClassTypeBase::ClassSize()const
	TLbsNetClassTypeBase::ClassType()const
	TLbsNetClassTypeBase::TLbsNetClassTypeBase()

Protected Attributes
TTimeIntervalMicroSeconds	iMaxFixAge
TTimeIntervalMicroSeconds	iMaxFixTime
TReal32	iMinHorizontalAccuracy
TReal32	iMinVerticalAccuracy
TUint8	iReserved

Inherited Attributes
	TLbsNetClassTypeBase::iClassSize
	TLbsNetClassTypeBase::iClassType

Constructor & Destructor Documentation

TLbsNetPosRequestQuality()

IMPORT_C

TLbsNetPosRequestQuality

(

)

Constructor for the TLbsNetPosRequestQuality

CLbsLocationSourceGpsBase

Member Functions Documentation

MaxFixAge()

IMPORT_C TTimeIntervalMicroSeconds

MaxFixAge

(

)

const

The maximum age of a location fix that is acceptable to the network.

SetMaxFixAge

MaxFixTime()

IMPORT_C TTimeIntervalMicroSeconds

MaxFixTime

(

)

const

The maximum time the network is prepared to wait while lbs subsystem calculates the current location.

SetMaxFixTime

MinHorizontalAccuracy()

IMPORT_C TReal32

MinHorizontalAccuracy

(

)

const

The desired minimum horizontal accuracy for a location update.

SetMaxFixTime

MinVerticalAccuracy()

IMPORT_C TReal32

MinVerticalAccuracy

(

)

const

The desired minimum vertical accuracy for a location update.

SetMaxFixTime

SetMaxFixAge(TTimeIntervalMicroSeconds)

IMPORT_C void

SetMaxFixAge

(

TTimeIntervalMicroSeconds

aTime

)

Specifies the maximum age of a location fix that can be returned to the network.

MaxFixAge

Parameters

TTimeIntervalMicroSeconds aTime

specifies the maximum time that the data source should spend calculating the current location.

SetMaxFixTime(TTimeIntervalMicroSeconds)

IMPORT_C void

SetMaxFixTime

(

TTimeIntervalMicroSeconds

aTime

)

The maximum time a data source should spend calculating the current location. When used in conjunction with SetMinHorizontalAccuracy and/or SetMinVerticalAccuracy the Lbs subsystem will produce an update either when the desired accuracy has be met or when the time limit is reached.

MaxFixTime

Parameters

TTimeIntervalMicroSeconds aTime

specifies the maximum time that the data source should spend calculating the current location.

SetMinHorizontalAccuracy(TReal32)

IMPORT_C void

SetMinHorizontalAccuracy

(

TReal32

aAccuracy

)

The desired minimum horizontal accuracy for a location update. When used in conjunction with SetMaxFixTime the data source will produce an update either when the desired accuracy has be met or when the time limit is reached.

SetMaxFixTime

Parameters

TReal32 aAccuracy

specifies the desired minimum horizontal accuracy (in metres) for a location update produced by the data source.

SetMinVerticalAccuracy(TReal32)

IMPORT_C void

SetMinVerticalAccuracy

(

TReal32

aAccuracy

)

The desired minimum vertical accuracy for a location update. When used in conjunction with SetMaxFixTime the data source will produce an update either when the desired accuracy has be met or when the time limit is reached.

SetMaxFixTime