1 /*

     2 * Copyright (c) 2006-2010 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:  An interface to Location Trail.

    15 *

    16 */

    17 

    18 #ifndef R_RLOCATIONTRAIL_H

    19 #define R_RLOCATIONTRAIL_H

    20 

    21 

    22 /**

    23  *  Fake implementation of RLocationManager class which is used for creating a Location Manager session.

    24  *  Location Manager is used to start and stop the location trail, retrieve 

    25  *  location information and write the location information to images.

    26 */

    27 class  RLocationTrail

    28     {

    29 public:

    30     /**

    31      * Location trail states.

    32      */

    33     enum TTrailState

    34         {

    35         ETrailStopped,

    36         EWaitingGPSData,

    37         ESearchingGPS,

    38         ETrailStarted,

    39         ETrailStopping,

    40         ETrailStarting

    41         };

    42 

    43     enum TTrailCaptureSetting

    44     	{

    45     	EOff,

    46     	ECaptureNetworkInfo,

    47     	ECaptureAll 

    48     	};    

    49 

    50 public:

    51 	RLocationTrail();

    52 	

    53 	~RLocationTrail();

    54 

    55     /**

    56      * Starts recording location information to location trail.

    57      * @since S60 3.2

    58      * @param aState, an enumeration of ECaptureNetworkInfo  

    59      * (only cell ID stored) and ECaptureAll 

    60      * (GPS coordinates and cell ID stored).

    61      * @return KErrNone if successful, otherwise one of the other 

    62      *         system-wide error codes.

    63      */

    64     int StartLocationTrail(TTrailCaptureSetting aState);

    65     

    66     /**

    67      * Stops recording location information to location trail.

    68      * @since S60 3.1

    69      * @param None.

    70      * @return KErrNone if successful, otherwise one of the other 

    71      *         system-wide error codes.

    72      */

    73     int StopLocationTrail();

    74     

    75     

    76     /**

    77     * Connect to location trail server

    78     * @return KErrNone if successful, otherwise one of the other 

    79     *         system-wide error codes.

    80     **/

    81     int Connect();

    82     

    83     void Close();

    84 

    85 private:

    86     bool mTrailConnected;

    87     bool mTrailStarted;

    88     };

    89     

    90 #endif // R_RLOCATIONTRAIL_H

    91 

    92 //End of File