TSatelliteData Class Reference

API published in: S60 2nd Ed FP 2

Link against: lbs.lib

Capability Information

Required Capabilities

None

Exceptions

The capability Location is required in:

TInt RPositionServer::GetDefaultModuleId(TPositionModuleId& aModuleId) const;

TInt RPositionServer::GetNumModules(TUint& aNumModules) const;

TInt RPositionServer::GetModuleInfoByIndex(TInt aModuleIndex, TPositionModuleInfoBase& aModuleInfo) const;

TInt RPositionServer::GetModuleInfoById(TPositionModuleId aModuleId, TPositionModuleInfoBase& aModuleInfo) const;

TInt RPositionServer::GetModuleStatus(TPositionModuleStatusBase& aPosModuleStatus, TPositionModuleId aModuleId) const;

void RPositionServer::NotifyModuleStatusEvent(TPositionModuleStatusEventBase& aStatusEvent,TRequestStatus& aStatus,const TPositionModuleId aModuleId = KPositionNullModuleId) const;

TInt RPositioner::SetRequestor(CRequestor::TRequestorType aType,CRequestor::TRequestorFormat aFormat,const TDesC& aData);

TInt RPositioner::SetRequestor(const RRequestorStack& aRequestorStack);

TInt RPositioner::SetUpdateOptions(const TPositionUpdateOptionsBase& aPosOption);

TInt RPositioner::GetUpdateOptions(TPositionUpdateOptionsBase& aPosOption) const;

void RPositioner::GetLastKnownPosition(TPositionInfoBase& aPosInfo,TRequestStatus& aStatus) const;

void RPositioner::NotifyPositionUpdate(TPositionInfoBase& aPosInfo,TRequestStatus& aStatus) const;


#include <lbssatellite.h>

Detailed Description

This class is used to transfer data about a satellite.

Public Member Functions

IMPORT_C  TSatelliteData ()
  Default constructor for a TSatelliteData.
IMPORT_C TInt  SatelliteId () const
IMPORT_C void  SetSatelliteId (TInt aSatelliteId)
  This method is not intended for the client's usage.
IMPORT_C TReal32  Azimuth () const
  Get the azimuth value of the satellite.
IMPORT_C void  SetAzimuth (TReal32 aAzimuth)
  This method is not intended for the client's usage.
IMPORT_C TReal32  Elevation () const
IMPORT_C void  SetElevation (TReal32 aElevation)
  This method is not intended for the client's usage.
IMPORT_C TBool  IsUsed () const
  Find if this satellite is being used to obtain position information.
IMPORT_C void  SetIsUsed (TBool aIsUsed)
  This method is not intended for the client's usage.
IMPORT_C TInt  SignalStrength () const
  Get the strength of the satellite signal.
IMPORT_C void  SetSignalStrength (TInt aSignalStrength)
  This method is not intended for the client's usage.

Protected Attributes

TInt  iSatelliteId
  The ID (in GPS, the PRN).
TReal32  iAzimuth
  The azimuth, in degrees.
TReal32  iElevation
  The elevation, in degrees.
TBool  iIsUsed
  Whether the satellite is used.
TInt  iSignalStrength
  The signal strength, in decibels.

Constructor & Destructor Documentation

IMPORT_C TSatelliteData::TSatelliteData  ) 
 

Default constructor for a TSatelliteData.

Note the azimuth and elevation are both initially NaN.


Member Function Documentation

IMPORT_C TReal32 TSatelliteData::Azimuth  )  const
 

Get the azimuth value of the satellite.

Note:
The azimuth can be NaN. The client should check if this field is NaN using Math::IsNaN() before doing any calculations based on this field.
Returns:
The satellite azimuth
IMPORT_C TReal32 TSatelliteData::Elevation  )  const
 
Note:
The elevation can be NaN. The client should check if this field is NaN using Math::IsNaN() before doing any calculations based on this field.
Returns:
The satellite elevation
IMPORT_C TBool TSatelliteData::IsUsed  )  const
 

Find if this satellite is being used to obtain position information.

Returns:
Whether this satellite is used
IMPORT_C TInt TSatelliteData::SatelliteId  )  const
 
Returns:
The Satellite ID
IMPORT_C void TSatelliteData::SetAzimuth TReal32  aAzimuth  ) 
 

This method is not intended for the client's usage.

The positioning module uses this method to set the azimuth of this satellite.

Parameters:
aAzimuth  The satellite azimuth to be set
IMPORT_C void TSatelliteData::SetElevation TReal32  aElevation  ) 
 

This method is not intended for the client's usage.

The positioning module uses this method to set the elevation of this satellite.

Parameters:
aElevation  The satellite elevation to be set
IMPORT_C void TSatelliteData::SetIsUsed TBool  aIsUsed  ) 
 

This method is not intended for the client's usage.

The positioning module uses this method to set if this satellite is being used for position determination.

Parameters:
aIsUsed  Whether this satellite will be used
IMPORT_C void TSatelliteData::SetSatelliteId TInt  aSatelliteId  ) 
 

This method is not intended for the client's usage.

The positioning module uses this method to set the Id of this satellite.

Parameters:
aSatelliteId  The satellite ID to be set
IMPORT_C void TSatelliteData::SetSignalStrength TInt  aSignalStrength  ) 
 

This method is not intended for the client's usage.

The positioning module uses this method to set the strength of the signal from this satellite.

Parameters:
aSignalStrength  The signal strength to set
IMPORT_C TInt TSatelliteData::SignalStrength  )  const
 

Get the strength of the satellite signal.

Returns:
The signal strength

Field Documentation

TReal32 TSatelliteData::iAzimuth [protected]
 

The azimuth, in degrees.

TReal32 TSatelliteData::iElevation [protected]
 

The elevation, in degrees.

TBool TSatelliteData::iIsUsed [protected]
 

Whether the satellite is used.

TInt TSatelliteData::iSatelliteId [protected]
 

The ID (in GPS, the PRN).

TInt TSatelliteData::iSignalStrength [protected]
 

The signal strength, in decibels.


The documentation for this class was generated from the following file:

Copyright © Nokia Corporation 2001-2008
Back to top