1 /* |
|
2 * Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies). |
|
3 * All rights reserved. |
|
4 * This component and the accompanying materials are made available |
|
5 * under the terms of "Eclipse Public License v1.0" |
|
6 * which accompanies this distribution, and is available |
|
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html". |
|
8 * |
|
9 * Initial Contributors: |
|
10 * Nokia Corporation - initial contribution. |
|
11 * |
|
12 * Contributors: |
|
13 * |
|
14 * Description: CMnrpPositionRequest class definition |
|
15 * |
|
16 */ |
|
17 |
|
18 |
|
19 #ifndef MNRP_POSITION_REQUEST_H_ |
|
20 #define MNRP_POSITION_REQUEST_H_ |
|
21 |
|
22 #include <e32base.h> |
|
23 #include <lbs.h> |
|
24 |
|
25 class TPositionUpdateOptions; |
|
26 |
|
27 /** Position observer */ |
|
28 class MMnrpPositionObserver |
|
29 { |
|
30 public: |
|
31 virtual void HandlePositionRequestCompletedL( TInt aError ) =0; |
|
32 }; |
|
33 |
|
34 /** Provides an interface for retrieving the current location. |
|
35 */ |
|
36 class CMnrpPositionRequest: public CActive |
|
37 { |
|
38 public: |
|
39 |
|
40 /** Creates new instance of request |
|
41 * @param aAppName the name of this application |
|
42 * @param aObserver observer to callback when locations are retrieved |
|
43 */ |
|
44 IMPORT_C static CMnrpPositionRequest* NewL( |
|
45 const TDesC& aRequestorName, |
|
46 MMnrpPositionObserver& aObserver); |
|
47 |
|
48 IMPORT_C ~CMnrpPositionRequest(); |
|
49 |
|
50 public: |
|
51 |
|
52 /** |
|
53 * Starts the fetching of a location. In the first place the default |
|
54 * proxy is used for retrieving a location. If fetching default location |
|
55 * fails the last known location is fetched. If fetching last known |
|
56 * location fails, an error code is returned to the observer. |
|
57 * |
|
58 * @param aLastKnownLocationAllowed whether last know location is allowed |
|
59 */ |
|
60 IMPORT_C void FetchNewPosition( TBool aLastKnownLocationAllowed = EFalse ); |
|
61 |
|
62 /** Returns current location */ |
|
63 IMPORT_C void GetPosition( TPositionInfo& aPosition ); |
|
64 |
|
65 /** Returns current speed info */ |
|
66 IMPORT_C TReal32 Speed(); |
|
67 |
|
68 /** Returns current heading info */ |
|
69 IMPORT_C TReal32 Heading(); |
|
70 |
|
71 /** Returns current magnetic heading info */ |
|
72 IMPORT_C TReal32 MagneticHeading(); |
|
73 |
|
74 /** Returns current course info */ |
|
75 IMPORT_C TReal32 Course(); |
|
76 |
|
77 /** Returns current magnetic course info */ |
|
78 IMPORT_C TReal32 MagneticCourse(); |
|
79 |
|
80 /** Modifies options for the next request */ |
|
81 IMPORT_C void SetOptionsL( const TPositionUpdateOptionsBase& aOptions ); |
|
82 |
|
83 protected: // from CActive |
|
84 |
|
85 void DoCancel(); |
|
86 void RunL(); |
|
87 TInt RunError(TInt aError); |
|
88 |
|
89 private: |
|
90 |
|
91 CMnrpPositionRequest( MMnrpPositionObserver& aObserver ); |
|
92 void ConstructL( const TDesC& aAppName ); |
|
93 |
|
94 /** Issues new request for location retrieval. */ |
|
95 void ExecuteNextStep(); |
|
96 |
|
97 void InitContainer( HPositionGenericInfo& aGenericInfo ); |
|
98 void SaveContainer( const HPositionGenericInfo& aGenericInfo ); |
|
99 |
|
100 private: |
|
101 |
|
102 /** |
|
103 * TState defines the different states this object may enter. |
|
104 */ |
|
105 enum TState |
|
106 { |
|
107 EIdle, |
|
108 EAcquiringDefaultLocation, |
|
109 EAcquiringLastKnownLocation |
|
110 }; |
|
111 |
|
112 private: |
|
113 |
|
114 //! Contains the location |
|
115 HPositionGenericInfo* iGenericPosition; |
|
116 |
|
117 //! Local storage for last location info |
|
118 TPositionInfo iPositionInfo; |
|
119 TReal32 iSpeed; |
|
120 TReal32 iHeading; |
|
121 TReal32 iMagneticHeading; |
|
122 TReal32 iCourse; |
|
123 TReal32 iMagneticCourse; |
|
124 |
|
125 //! The observer to callback when location retieval is ready |
|
126 MMnrpPositionObserver& iObserver; |
|
127 |
|
128 //! Reference to the Location Server session |
|
129 RPositionServer iLocationServer; |
|
130 |
|
131 //! Reference to the Location Server subsession |
|
132 RPositioner iPositioner; |
|
133 |
|
134 TBool iLastKnownLocationAllowed; |
|
135 |
|
136 //! The current state this object has entered |
|
137 TState iState; |
|
138 }; |
|
139 |
|
140 #endif // MNRP_POSITION_REQUEST_H_ |
|
141 |
|