/*
* 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: Positioning Indicators Info - QT Wrapper
*
*/

#ifndef POSITIONINDICATORINFO_H
#define POSITIONINDICATORINFO_H

#include <QObject.h>

#include "posgeoaddress.h"
#include "posindicatorglobal.h"

class PosIndicatorInfoPrivate;

class POSINDICATOR_EXPORT PosIndicatorInfo :  public QObject
    {    
    Q_OBJECT
    
public :
    /*
     * Constructor
     */
     PosIndicatorInfo();
    
    /*
     * Destructor
     */
     ~PosIndicatorInfo();
    
    /**
     * Requests for positioning information from Positioning Indicator 
     * Helper Server.PosInfoUpdated() will be emitted when
     * position information is available.
     *                   
     */
     void requestPosInfo(); 
     
     /**
      * Cancels position info request.
      */
     void cancelPosInfo();
	 
private:
    signals:
    /*
     * Signal emitted when new position updates available
     * When coordinates are available, this object is 
     * populated with only Position attribute. 
     * When reverse geo-code address has been resolved, 
     * the only address fields will be populated.
     * 
     * @param[in] posGeoAddress - Object containing position information
     * @param[in] error - Any error code while retrieving position information
     *                  - KTimeOut - if time out during retrieval of position information
     */
    void posInfoUpdated(PosGeoAddress& posGeoAddress, int error);    

private:    
    Q_DECLARE_PRIVATE_D(d_ptr, PosIndicatorInfo)   
    
private:
    /**
     * Pointer to private implementation.
     * Owns
     */
    PosIndicatorInfoPrivate* d_ptr;
    };

#endif /* POSITIONINDICATORINFO_H */