1 /*

     2 * Copyright (c) 2008-2008 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:  Interface definition for Location integration plug-in

    15 *

    16 */

    17 

    18 

    19 #ifndef MESMRLOCATIONPLUGIN_H

    20 #define MESMRLOCATIONPLUGIN_H

    21 

    22 

    23 #include <e32def.h>

    24 

    25 /**

    26  *  MESMRLocationPlugin defines the interface for accessing location service provider

    27  *  from ESMR GUI.

    28  */

    29 

    30 class MESMRLocationPlugin

    31 	{

    32 

    33 public:

    34 

    35 	/**

    36      * Shows map on the screen and asks user to select a position.

    37      * The function returns immediately and the selection is provided

    38      * to the caller via MESMRLocationPluginObserver interface.

    39      *

    40      * @param aSearchQuery Text to show as default address

    41      * @param aLocationUrl URL containing coordinates for maps focus

    42      */

    43     virtual void SelectFromMapL( const TDesC& aSearchQuery, const TDesC& aLocationUrl ) = 0;

    44     

    45     /**

    46      * Shows map on the screen. User may edit the search string and search

    47      * the position from the map, but the selection is not provided to the

    48      * caller

    49      * 

    50      * @param aSearchQuery Text to show as default address

    51      */

    52     virtual void SearchFromMapL( const TDesC& aSearchQuery ) = 0;

    53     

    54     /**

    55      * Shows map on the screen focused on the given location.

    56      *

    57      * @param aLocationUrl URL containing coordinates for maps focus

    58      */

    59     virtual void ShowOnMapL( const TDesC& aLocationUrl ) = 0;

    60 

    61 protected:

    62 

    63 	virtual ~MESMRLocationPlugin() {}

    64 

    65     };

    66 

    67 #endif // MESMRLOCATIONPLUGIN_H

    68