Class TPosition

class TPosition : public TLocality;

Description

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.

Derivation

• TCoordinate - TCoordinate is used to hold the basic coordinates of a location (latitude, longi...

• TLocality - Adds an error estimate for the horizontal and vertical accuracy of the point to ...

• TPosition - This class is the standard data structure for retrieving location information. I...

Members

Defined in TPosition:

• SetCurrentTime()Sets the time of this position data to the current universal time as indicated b...
• SetTime(TTime)Sets the time of this position data.
• Speed(const TPosition &,TReal32 &)constThis method calculates the horizontal speed between the current position and the...
• Speed(const TPosition &,TReal32 &,TReal32 &)constThis method calculates the horizontal speed between the current position and the...
• TPosition()Default constructor for TCoordinate. Sets the member data to default values (NaN...
• TPosition(const TLocality &,TTime)Constructor for TPosition. Allows the client to set a locality and an associated...
• Time()constRetrieves the time of this position data.
• iTimeThis is the system time when the position related member data was obtained.

Inherited from TCoordinate:

• Altitude()constAccessor for altitude.
• Datum()constAccessor for the datum.
• Latitude()constAccessor for latitude.
• Longitude()constAccessor for longitude.
• Move(TReal32,TReal32)This method moves this coordinate aDistance in the direction specified by aBeari...
• SetCoordinate(const TReal64 &,const TReal64 &)This method assigns a new latitude and longitude to the object. The altitude is ...
• SetCoordinate(const TReal64 &,const TReal64 &,TReal32)This method assigns a new latitude, longitude and altitude to the object.
• SetDatum(TPositionDatumId)This method assigns a new datum to the object.
• TCoordinate(const TReal64 &,const TReal64 &)Constructor for TCoordinate. Allows the client to set just latitude and longitud...
• TCoordinate(const TReal64 &,const TReal64 &,TReal32)Constructor for TCoordinate. Allows the client to set the latitude, longitude an...
• iAltitudeAltitude, defaults to WGS-84 format.
• iDatumThe ID of the datum the coordinate is in, defaults to WGS-84 format.
• iLatitudeLatitude, defaults to WGS-84 format.
• iLongitudeLongitude, defaults to WGS-84 format.
• iReservedUnused variable for future expansion.

Inherited from TLocality:

• BearingTo(const TCoordinate &,TReal32 &)constThis method calculates the bearing from this coordinate to the supplied coordina...
• BearingTo(const TLocality &,TReal32 &,TReal32 &)constThis method calculates the bearing from this locality to the supplied locality.
• Distance(const TCoordinate &,TReal32 &)constThis method calculates the distance between this coordinate and the supplied coo...
• Distance(const TLocality &,TReal32 &,TReal32 &)constThis method calculates the distance between this locality and the supplied local...
• HorizontalAccuracy()constRetrieves the horizontal accuracy of this coordinate.
• SetAccuracy(TReal32,TReal32)Sets both the horizontal and vertical accuracy of this coordinate.
• SetHorizontalAccuracy(TReal32)Sets the horizontal accuracy of this coordinate.
• SetVerticalAccuracy(TReal32)Sets the vertical accuracy of this coordinate.
• TLocality(const TCoordinate &,TReal32)Constructor for TLocality. Allows the client to set a coordinate and a 'surface'...
• TLocality(const TCoordinate &,TReal32,TReal32)Constructor for TLocality. Allows the client to set a coordinate and both a hori...
• VerticalAccuracy()constRetrieves the vertical accuracy of this coordinate.
• iHorizontalAccuracyHorizontal (earths-surface) accuracy, in metres.
• iVerticalAccuracyAltitudinal accuracy, in metres.

IMPORT_C TPosition();

Description

Default constructor for TCoordinate. Sets the member data to default values (NaN for coordinates, 0 for time).

IMPORT_C TPosition(const TLocality &aLocality, TTime aTime);

Description

Constructor for TPosition. Allows the client to set a locality and an associated time.

Parameters

const TLocality &aLocality specifies an initial value for the locality of the position. TTime aTime specifies an initial value for the time of the position.

IMPORT_C void SetTime(TTime aTime);

Description

Sets the time of this position data.

Parameters

TTime aTime is the new timing information.

IMPORT_C void SetCurrentTime();

Description

Sets the time of this position data to the current universal time as indicated by the systems clock.

IMPORT_C TTime Time() const;

Description

Retrieves the time of this position data.

Return value

TTime the timing component of this position information.

IMPORT_C TInt Speed(const TPosition &aPosition, TReal32 &aSpeed) const;

Description

This method calculates the horizontal speed between the current position and the supplied instance aPosition. The speed is calculated based on the coordinates and time associated with each instance.

Parameters

const TPosition &aPosition is another position to use in the calculation. TReal32 &aSpeed upon successful completion, this is set to the speed indicated by being at this position at its recorded time, and at aPosition at its recorded time. Always positive, in metres per second.

Return value

TInt a Symbian OS error code. KErrArgument if any of iLatitude, iLongitude, aPosition.iLatitude or aPosition.iLongitude are set to NaN. KErrArgument if either of iTime or aPosition.iTime are set to zero. KErrArgument if iTime and aPosition.iTime are the same.

IMPORT_C TInt Speed(const TPosition &aPosition, TReal32 &aSpeed, TReal32 &aDelta) const;

Description

This method calculates the horizontal speed between the current position and the supplied instance aPosition. The speed is calculated based on the coordinates and time associated with each instance. An estimate of the accuracy of the result is also provided.

Parameters

const TPosition &aPosition is another position to use in the calculation. TReal32 &aSpeed upon successful completion, this is set to the speed indicated by being at this position at its recorded time, and at aPosition at its recorded time. Always positive, in metres per second. TReal32 &aDelta upon successful completion, this is set to an estimate of the accuracy of the calculation, in metres per second.

Return value

TInt a Symbian OS error code. KErrArgument if any of iLatitude, iLongitude, aPosition.iLatitude or aPosition.iLongitude are set to NaN. KErrArgument if any of iHorizontalAccuracy or aPosition.iHorizontalAccuracy are set to NaN. KErrArgument if either of iTime or aPosition.iTime are set to zero. KErrArgument if iTime and aPosition.iTime are the same.

protected: TTime iTime;

Description

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