/*

* Copyright (c) 2010 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: Class declaration of PosLocationServicesEngine.

*

*/

#ifndef POSLOCATIONSERVICESENGINE_H

#define POSLOCATIONSERVICESENGINE_H

#include "poslocationservicesengineprivate.h"

#include <QObject.h>

/**

 * PosLocationServicesEngine class provides interface to location services.

 * Using this interface. This interface provides services like list, delete

 * etc..

 */

class PosLocationServicesEngine : public QObject,

                                  public PosLocationServiceUpdateObserver

    {

    Q_OBJECT

public:

    /**

     * Constructor

     */

    PosLocationServicesEngine();

    /**

     * Destructor

     */

    virtual ~PosLocationServicesEngine();

    /**

     * Retrieves all location services info.

     *

     * @param[out] locationServiceList List of location

     *            services info.

     * @return  - KErrNone if location services information retrieved successfully.

     *          - KErrNotFound if there are no location services.

     *            otherwise system wide error codes.

     */

    int getLocationServices( QList<PosLocationServiceInfo>&

                             locationServiceList );

    /**

     * Removes location service based on the service Id.

     *

     * @param [in] serviceId Location service Id.

     *

     * @return following error codes

     *      - KErrNone if successful

     *      - KErrNotFound if service is not found

     *      otherwise system wide error codes.

     */

    int removeLocationService( int serviceId );

public:// From PosLocationServiceUpdateObserver

    void handleLocationServiceUpdate();

signals:

    /**

     * This signal is emitted when there is update in the

     * location services.

     */

    void locationServiceUpdate();

private:// Data members

    /**

     * Pointer to PosLocationServicesEnginePrivate object.

     * Own

     */

    PosLocationServicesEnginePrivate* d_ptr;

    };

#endif /* POSLOCATIONSERVICESENGINE_H */