24a428226bbbd5aaa2f076975e6df6582cb3c4da
[platform/core/location/maps-plugin-here.git] / inc / engine / geocoder / MultiReverseQueryListener.h
1 /*
2  * Copyright (C) 2013 HERE Global B.V. All rights reserved.
3  * This software, including documentation, is protected by copyright controlled by
4  * HERE Global B.V. (“Software”). All rights are reserved. Copying, including reproducing,
5  * storing, adapting or translating, any or all of this material requires the prior
6  * written consent of HERE Global B.V. You may use this
7  * Software in accordance with the terms and conditions defined in the
8  * HERE Location Platform Services Terms and Conditions, available at
9  * http://developer.here.com/terms-conditions-base
10  *
11  * As an additional permission to the above, you may distribute Software,
12  * in object code format as part of an Application, according to, and subject to, terms and
13  * conditions defined in the Tizen Software Development kit (“SDK”) License Agreement.
14  * You may distribute such object code format Application under terms of your choice,
15  * provided that the header and source files of the Software have not been modified.
16  */
17
18 #ifndef MULTIREVERSEQUERYLISTENER_H
19 #define MULTIREVERSEQUERYLISTENER_H
20
21 #include "common/HereMaps_global.h"
22 #include "common/QueryListener.h"
23
24 TIZEN_MAPS_BEGIN_NAMESPACE
25
26 class MultiReverseReply;
27
28 /**
29  * This class encapsulates a listener facility that is informed when the results
30  * of a query become available.
31  *
32  * The class exposes a callback method that must be implemented by the derived
33  * classes to process the data received from the server.
34  *
35  * @ingroup geocoding
36  */
37 class EXPORT_API MultiReverseQueryListener : public Here::Maps::QueryListener
38 {
39 public:
40     /**
41      * This method is the default constructor.
42      */
43     MultiReverseQueryListener();
44
45     /**
46      * This method is the destructor.
47      */
48     ~MultiReverseQueryListener();
49
50     /**
51      * This method is a callback invoked when data have arrived in response to a
52      * geocoding request.
53      *
54      * @param rReply A Constant reference to an object containing the response data.
55      */
56     virtual void OnMultiReverseReply(const MultiReverseReply& rReply) = 0;
57
58     #ifdef TIZEN_MIGRATION
59     /**
60      * This method is a callback invoked when geocoding request is failed.
61      *
62      * @param rReply A Constant reference to an object containing the response data.
63      */
64     virtual void OnMultiReverseFailure(const MultiReverseReply& rReply) = 0;
65     #endif
66
67 private:
68
69     void OnReplySuccess(Here::Maps::BaseReply& rReply);
70
71     #ifdef TIZEN_MIGRATION
72     void OnFailure(const Here::Maps::BaseReply& rReply);
73     #endif
74
75 };
76
77 TIZEN_MAPS_END_NAMESPACE
78
79 #endif