TPositionAreaExtendedInfo Class Reference

#include <lbsareainfo.h>

class TPositionAreaExtendedInfo : public TPositionAreaInfo

Detailed Description

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.

Member Attribute Documentation

iCID

TBool iCID[protected]

iLAC

TBool iLAC[protected]

iMCC

TBool iMCC[protected]

iMNC

TBool iMNC[protected]

Constructor & Destructor Documentation

TPositionAreaExtendedInfo ( )

IMPORT_CTPositionAreaExtendedInfo()

Constructor for TPositionAreaExtendedInfo

Member Function 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.

Return Value
TRUE if the current Cell Id and the Cell Id associated with the position match; FALSE otherwise.

LocationAreaCodeMatch ( )

IMPORT_C TBoolLocationAreaCodeMatch()const

Returns Location Area code match.

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

See also: CellIdMatch()

Return Value
TRUE if the current Location Area Code and the Location Area Code associated with the position match; FALSE otherwise.

MobileCountryCodeMatch ( )

IMPORT_C TBoolMobileCountryCodeMatch()const

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

Return Value
TRUE if the current Country Code and the Country Code associated with the position match; FALSE otherwise.

MobileNetworkCodeMatch ( )

IMPORT_C TBoolMobileNetworkCodeMatch()const

Returns Mobile Network code match.

Return Value
TRUE if the current Network Code and the Network Code associated with the position match; FALSE otherwise.

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)

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)

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)

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)