TPosition Class Reference

class TPosition : public TLocality

This class is the standard data structure for retrieving location information. It adds a time dimension to the inherited TLocality information. This enables the speed to be calculated from two TPosition instances.

The time reflects the system time (that is, the mobile terminal) of when the location fix was obtained. It does not indicate the time as obtained from the position technology (for example network or satellite time).

The time is contained in a TTime data structure that provides microsecond resolution. However, it should be noted that system clocks only provide a resolution of milliseconds or indeed hundredths of a second.

Inherits from

Public Member Functions
TPosition()
TPosition(const TLocality &, TTime)
IMPORT_C voidSetCurrentTime()
IMPORT_C voidSetTime(TTime)
IMPORT_C TIntSpeed(const TPosition &, TReal32 &)
IMPORT_C TIntSpeed(const TPosition &, TReal32 &, TReal32 &)
IMPORT_C TTimeTime()
Inherited Functions
TCoordinate::Altitude()const
TCoordinate::Datum()const
TCoordinate::Latitude()const
TCoordinate::Longitude()const
TCoordinate::Move(TReal32,TReal32)
TCoordinate::SetCoordinate(const TReal64 &,const TReal64 &)
TCoordinate::SetCoordinate(const TReal64 &,const TReal64 &,TReal32)
TCoordinate::SetDatum(TPositionDatumId)
TCoordinate::TCoordinate()
TCoordinate::TCoordinate(const TReal64 &,const TReal64 &)
TCoordinate::TCoordinate(const TReal64 &,const TReal64 &,TReal32)
TLocality::BearingTo(const TCoordinate &,TReal32 &)const
TLocality::BearingTo(const TLocality &,TReal32 &,TReal32 &)const
TLocality::Distance(const TCoordinate &,TReal32 &)const
TLocality::Distance(const TLocality &,TReal32 &,TReal32 &)const
TLocality::HorizontalAccuracy()const
TLocality::SetAccuracy(TReal32,TReal32)
TLocality::SetHorizontalAccuracy(TReal32)
TLocality::SetVerticalAccuracy(TReal32)
TLocality::TLocality()
TLocality::TLocality(const TCoordinate &,TReal32)
TLocality::TLocality(const TCoordinate &,TReal32,TReal32)
TLocality::VerticalAccuracy()const
Protected Attributes
TTime iTime
Private Attributes
TUint8 iReserved
Inherited Attributes
TCoordinate::iAltitude
TCoordinate::iDatum
TCoordinate::iLatitude
TCoordinate::iLongitude
TLocality::iHorizontalAccuracy
TLocality::iVerticalAccuracy

Constructor & Destructor Documentation

TPosition()

IMPORT_CTPosition()

TPosition(const TLocality &, TTime)

IMPORT_CTPosition(const TLocality &aLocality,
TTimeaTime
)

Parameters

const TLocality & aLocality
TTime aTime

Member Functions Documentation

SetCurrentTime()

IMPORT_C voidSetCurrentTime()

SetTime(TTime)

IMPORT_C voidSetTime(TTimeaTime)

Parameters

TTime aTime

Speed(const TPosition &, TReal32 &)

IMPORT_C TIntSpeed(const TPosition &aPosition,
TReal32 &aSpeed
)const

Parameters

const TPosition & aPosition
TReal32 & aSpeed

Speed(const TPosition &, TReal32 &, TReal32 &)

IMPORT_C TIntSpeed(const TPosition &aPosition,
TReal32 &aSpeed,
TReal32 &aDelta
)const

Parameters

const TPosition & aPosition
TReal32 & aSpeed
TReal32 & aDelta

Time()

IMPORT_C TTimeTime()const

Member Data Documentation

TUint8 iReserved

TUint8 iReserved[private]

Unused variable for future expansion.

TTime iTime

TTime iTime[protected]

This is the system time when the position related member data was obtained.