TPositionAreaExtendedInfo Class Reference

class TPositionAreaExtendedInfo : public TPositionAreaInfo

TPositionAreaExtendedInfo is a specialised area class and provides detailed information about the match between the current network information and the network information related to a known position.

In the future the class may be extended to provide information about a match between other available location information (e.g. WiFi MAC address).

In order to provide a user with simplified area information, the match between the two network information should be translated into a area information supported by the TPositionAreaInfo type.

Network Info Match > Area info conversion table
||==========================================================================================||
|| Mobile Country Code  | Mobile Network Code | Location Area Code | Cell Id | Area         ||
||==========================================================================================||
||           1          |          1          |         1          |    1    | EAreaCity    ||
||           1          |          1          |         1          |    0    | EAreaRegion  ||
||           1          |          1          |         0          |    0    | EAreaCountry ||
||           1          |          0          |         0          |    0    | EAreaCountry ||
||                                  Any other combination                    | EAreaUnknown ||
||==========================================================================================||

Please note that the conversion of the Cell Id match assumes the worst case scenario, where cells are big (e.g. tens of km radius). In centres of big cities the cell sizes are normally much smaller, taking the area down to the District or even Street level.

Constructor & Destructor Documentation

TPositionAreaExtendedInfo()

IMPORT_CTPositionAreaExtendedInfo()

Constructor for TPositionAreaExtendedInfo

Member Functions Documentation

CellIdMatch()

IMPORT_C TBoolCellIdMatch()const

Returns Cell Id code match.

In practice cell radius varies from 10s of meters in buildings, through 100s of meters in cities up to 10s of kilometres in countryside, but typically do not exceed 35 kilometres.

LocationAreaCodeMatch()

IMPORT_C TBoolLocationAreaCodeMatch()const

Returns Location Area code match.

Typically a Location Area consists of 10s or even 100s of Cells.

CellIdMatch()

MobileCountryCodeMatch()

IMPORT_C TBoolMobileCountryCodeMatch()const

Returns Country Code match. Country codes are network operator independent.

MobileNetworkCodeMatch()

IMPORT_C TBoolMobileNetworkCodeMatch()const

Returns Mobile Network code match.

SetCellIdMatch(TBool)

IMPORT_C voidSetCellIdMatch(TBoolaCidMatch)

Set whether a match for the Cell ID was found or not (this method is called by the server, not the client)

Parameters

TBool aCidMatch

SetLocationAreaCodeMatch(TBool)

IMPORT_C voidSetLocationAreaCodeMatch(TBoolaLacMatch)

Set whether a match for the Loca Area Code was found or not (this method is called by the server, not the client)

Parameters

TBool aLacMatch

SetMobileCountryCodeMatch(TBool)

IMPORT_C voidSetMobileCountryCodeMatch(TBoolaMccMatch)

Set whether a match for the Mobile Country Code was found or not (this method is called by the server, not the client)

Parameters

TBool aMccMatch

SetMobileNetworkCodeMatch(TBool)

IMPORT_C voidSetMobileNetworkCodeMatch(TBoolaMncMatch)

Set whether a match for the Mobile Network Code was found or not (this method is called by the server, not the client)

Parameters

TBool aMncMatch

Member Data Documentation

TBool iCID

TBool iCID[protected]

TBool iLAC

TBool iLAC[protected]

TBool iMCC

TBool iMCC[protected]

TBool iMNC

TBool iMNC[protected]

TUint8 iReserved2

TUint8 iReserved2[private]

Unused variable for future expansion.