class CPosLmAreaCriteria : public CPosLmSearchCriteria |
Criterion for searching for landmarks which reside in a certain area.
The search area is defined by providing two latitude and two longitude values which specify the borders of the area. Note that this search does not consider landmark coverage radius, see CPosLandmark::GetCoverageRadius.
The search area is defined as a spherical rectangle, limited by two longitude borders (WestLongitude and EastLongitude) and two latitude borders (SouthLatitude and NorthLatitude).
It is required that -90 =< SouthLatitude =< NorthLatitude =< 90. WestLongitude must be in the interval [-180, 180), i.e. not including +180. EastLongitude must be in the interval [-180, 180], i.e. including +180. It is allowed that EastLongitude < WestLongitude. This defines an area which crosses the 180 meridian. The area definition is inclusive, i.e. landmarks which lie on the border of the area will be considered as matches. If WestLongitude = EastLongitude and NorthLatitude = SouthLatitude then only landmarks which match the longitude and latitude respectively, are considered to be matches. If WestLongitude = -180 and EastLongitude = +180, all longitudes are included in the search.
This criterion is only valid when searching for landmarks, i.e. if it is passed to CPosLandmarkSearch::StartCategorySearchL, the function will fail with error code KErrArgument.
Public Member Functions | |
---|---|
~CPosLmAreaCriteria() | |
IMPORT_C void | GetSearchArea(TReal64 &, TReal64 &, TReal64 &, TReal64 &) |
IMPORT_C CPosLmAreaCriteria * | NewLC(const TReal64 &, const TReal64 &, const TReal64 &, const TReal64 &) |
IMPORT_C TInt | SetSearchArea(const TReal64 &, const TReal64 &, const TReal64 &, const TReal64 &) |
Private Member Functions | |
---|---|
CPosLmAreaCriteria() | |
CPosLmAreaCriteria(const CPosLmAreaCriteria &) | |
void | ConstructL(const TReal64 &, const TReal64 &, const TReal64 &, const TReal64 &) |
CPosLmAreaCriteria & | operator=(const CPosLmAreaCriteria &) |
Inherited Enumerations | |
---|---|
CPosLmSearchCriteria:TCriteriaType |
Private Attributes | |
---|---|
TReal64 | iEastLongitude |
TReal64 | iNorthLatitude |
TReal64 | iSouthLatitude |
TReal64 | iWestLongitude |
CPosLmAreaCriteria | ( | const CPosLmAreaCriteria & | ) | [private] |
const CPosLmAreaCriteria & |
void | ConstructL | ( | const TReal64 & | aSouthLatitude, |
const TReal64 & | aNorthLatitude, | |||
const TReal64 & | aWestLongitude, | |||
const TReal64 & | aEastLongitude | |||
) | [private] |
IMPORT_C void | GetSearchArea | ( | TReal64 & | aSouthLatitude, |
TReal64 & | aNorthLatitude, | |||
TReal64 & | aWestLongitude, | |||
TReal64 & | aEastLongitude | |||
) | const |
Returns the search area.
TReal64 & aSouthLatitude | The southern latitude border of the search area. |
TReal64 & aNorthLatitude | The northern latitude border of the search area. |
TReal64 & aWestLongitude | The western longitude border of the search area. |
TReal64 & aEastLongitude | The eastern longitude border of the search area. |
IMPORT_C CPosLmAreaCriteria * | NewLC | ( | const TReal64 & | aSouthLatitude, |
const TReal64 & | aNorthLatitude, | |||
const TReal64 & | aWestLongitude, | |||
const TReal64 & | aEastLongitude | |||
) | [static] |
Two-phased constructor.
The input parameters specify the area to search as described in the class description.
-90 =< aSouthLatitude =< aNorthLatitude =< 90
-180 <= aWestLongitude < 180
-180 <= aEastLongitude <= 180
const TReal64 & aSouthLatitude | The southern latitude border of the search area. |
const TReal64 & aNorthLatitude | The northern latitude border of the search area. |
const TReal64 & aWestLongitude | The western longitude border of the search area. |
const TReal64 & aEastLongitude | The eastern longitude border of the search area. |
IMPORT_C TInt | SetSearchArea | ( | const TReal64 & | aSouthLatitude, |
const TReal64 & | aNorthLatitude, | |||
const TReal64 & | aWestLongitude, | |||
const TReal64 & | aEastLongitude | |||
) |
Define the search area.
The input parameters specify the area to search as described in the class description.
-90 =< aSouthLatitude =< aNorthLatitude =< 90
-180 <= aWestLongitude < 180
-180 <= aEastLongitude <= 180
const TReal64 & aSouthLatitude | The southern latitude border of the search area. |
const TReal64 & aNorthLatitude | The northern latitude border of the search area. |
const TReal64 & aWestLongitude | The western longitude border of the search area. |
const TReal64 & aEastLongitude | The eastern longitude border of the search area. |
CPosLmAreaCriteria & | operator= | ( | const CPosLmAreaCriteria & | ) | [private] |
const CPosLmAreaCriteria & |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.