/*
* Copyright (c) 2002-2005 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:    LandmarksUi Content File -    Implements methods for interfacing with Location Acquisition API.
*
*/







#ifndef __CLMKLOCATIONSERVICE_H__
#define __CLMKLOCATIONSERVICE_H__

//  INCLUDES
#include <lbs.h>

// FORWARD DECLARATION
class MLmkLocationObserver;
class TPosition;
class RPositionServer;
class RPositioner;
class TPositionInfo;


// CLASS DECLARATION
/**
*  Implements entry point class to LmkEng.dll
*/
class CLmkLocationService : public CActive
    {
    public:
        /**
        * Two-phased constructor.
        * @param location service requester name
        *        (Landmarks Application's name)
        *        which is passed to Location framework as a parameter to Location Acquisition API
        *        It is maintained by Location Framework for privacy rules and logging purposes
        * @return CLmkLocationService object.
        */
        IMPORT_C static CLmkLocationService* NewL(const TDesC& aSrvName);

        /**
        * Destructor.
        */
        virtual ~CLmkLocationService();

    private:
        /**
        * By default Symbian 2nd phase constructor is private.
        * @param location service requester name
        *        (Landmarks Application's name)
        *        which is passed to Location framework as a parameter to Location Acquisition API
        *        It is maintained by Location Framework for privacy rules and logging purposes
        */
        void ConstructL(const TDesC& aSrvName);

        /**
        * C++ default constructor.
        * @param newly instantiated object
        */
        CLmkLocationService();

    public: //new functions
        /**
        * Set observer
        * The calling class sets itself as observer to CLmkLocationService class
        * @param the calling class which sets itself as observer to this class
        */
        IMPORT_C void SetObserver(MLmkLocationObserver& aObserver);

        /**
        * Remove observer
        */
        IMPORT_C void RemoveModelObserver();

        /**
        * Request current location
        */
        IMPORT_C void LocationRequestL();

        /**
        * Get current location
        * @return TPosition reference
        */
        IMPORT_C TPosition& CurrentPosition();

        /**
        * Cancel location request
        */
        IMPORT_C void CancelRequest();

    private: // from CActive
        void RunL();
        void DoCancel();
        TInt RunError(TInt aError);

    private:    // data
        /// Own: iServer
        RPositionServer iServer;

        ///Ref:
        MLmkLocationObserver* iObserver;

        ///  RPositioner
        RPositioner iPositioner;

        ///  TPosition
        TPosition iPosition;

        TPositionInfo iPositionInfo;

    };

#endif // __CLMKLOCATIONSERVICE_H__

// End of File