/*
* Copyright (c) 2009 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:	The header file for ReverseGeoCoderPlugin that creates the ReverseGeocoder
*
*/


#ifndef __REVERSEGEOCODERPLUGIN_H__
#define __REVERSEGEOCODERPLUGIN_H__

// INCLUDES
#include <e32base.h>

#include "reversegeocode.h"

/**
 * CReverseGeoCoderPlugin
 *
 * An implementation of the CReverseGeoCoderPlugin definition. 
 *              Encapsulates the reverse goecoding functionality
 *              This is concrete class, instance of which
 *              ECOM framework gives to ECOM clients.
 */
class CReverseGeoCoderPlugin : public CBase
	{
public:
	
	/**
	* Create instance of concrete implementation. 
	* @return: Instance of this class.
	*/
	static CReverseGeoCoderPlugin* NewL();

	/**
	* Static constructor.
	* @return: Instance of this class.
	*/
	static CReverseGeoCoderPlugin* NewLC();

	/**
	* Destructor.
	*/
	~CReverseGeoCoderPlugin();


protected:
	
	/**
	* The default constructor
	* Perform the first phase of two phase construction
	*/
	CReverseGeoCoderPlugin();

	/**
	*  Perform the second phase construction of a
	*             CImplementationClassPlus object.
	*/
	void ConstructL();
	
public:
	
	/**
	 * Creates the instance of Reverse Geocoder
	 * 
	 */
	void CreateReverseGeoCoderL();

	/**
	 * Initializes the ReverseGeoCodeObserver
	 * @param: aObserver The observer class instance that is to be notified when reverse geocoding completes
	 * 
	 */
    virtual void AddObserverL(MReverseGeocodeObserver& aObserver);

	/**
	 * A wrapper API to fetch the address from geocoordinates
	 * Internally calls the ReverseGeoCoder
	 * @param aLocality A TLocality object that contains the geocoordinate information
	 * @param aOption Indicates if the connection is silent connection or not
	 * 
	 */
    virtual void GetAddressByCoordinateL( TLocality aLocality,const TConnectionOption aOption );

	/**
	 * Wrapper API to check if the ReverseGeoCoder allows a silent connection
	 * @return:TBool Indicates if a silent connection is allowed
	 * 
	 */
	virtual TBool SilentConnectionAllowed();
	
private:
	
    /** 
    * iRevGeocoder
    * An instance of the CReverseGeocode class to fetch the place name from geocoordinates
    */
	CReverseGeocode *iRevGeocoder;

	/*
	 * iObserver
	 * An instance of the class that is to be notified once Reverse Geocoding is completed
	 */
	MReverseGeocodeObserver* iObserver;
	/**
	  * iDtorKey
	  * Identification of the plugin on cleanup
	  */
	TUid iDtorKey;

	};


#endif //__REVERSEGEOCODERPLUGIN_H__

//End of file