1/****************************************************************************
2**
3** Copyright (C) 2015 The Qt Company Ltd.
4** Contact: http://www.qt.io/licensing/
5**
6** This file is part of the QtLocation module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL3$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see http://www.qt.io/terms-conditions. For further
15** information use the contact form at http://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPLv3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or later as published by the Free
28** Software Foundation and appearing in the file LICENSE.GPL included in
29** the packaging of this file. Please review the following information to
30** ensure the GNU General Public License version 2.0 requirements will be
31** met: http://www.gnu.org/licenses/gpl-2.0.html.
32**
33** $QT_END_LICENSE$
34**
35****************************************************************************/
36
37#ifndef QPLACEMANAGER_H
38#define QPLACEMANAGER_H
39
40#include <QtLocation/QPlaceContentReply>
41#include <QtLocation/QPlaceContentRequest>
42#include <QtLocation/QPlaceIdReply>
43#include <QtLocation/QPlaceReply>
44#include <QtLocation/QPlaceDetailsReply>
45#include <QtLocation/QPlaceMatchReply>
46#include <QtLocation/QPlaceMatchRequest>
47#include <QtLocation/QPlaceSearchSuggestionReply>
48#include <QtLocation/QPlaceSearchRequest>
49#include <QtLocation/QPlaceSearchResult>
50
51#include <QtCore/QLocale>
52#include <QtCore/QVector>
53#include <QtCore/QString>
54#include <QtCore/QObject>
55#include <QtLocation/QPlaceIcon>
56
57QT_BEGIN_NAMESPACE
58
59class QPlaceManagerEngine;
60class QPlaceSearchRequest;
61class QPlaceSearchReply;
62
63class Q_LOCATION_EXPORT QPlaceManager : public QObject
64{
65 Q_OBJECT
66public:
67 ~QPlaceManager();
68
69 QString managerName() const;
70 int managerVersion() const;
71
72 QPlaceDetailsReply *getPlaceDetails(const QString &placeId) const;
73
74 QPlaceContentReply *getPlaceContent(const QPlaceContentRequest &request) const;
75
76 QPlaceSearchReply *search(const QPlaceSearchRequest &query) const;
77
78 QPlaceSearchSuggestionReply *searchSuggestions(const QPlaceSearchRequest &request) const;
79
80 QPlaceIdReply *savePlace(const QPlace &place);
81 QPlaceIdReply *removePlace(const QString &placeId);
82
83 QPlaceIdReply *saveCategory(const QPlaceCategory &category, const QString &parentId = QString());
84 QPlaceIdReply *removeCategory(const QString &categoryId);
85
86 QPlaceReply *initializeCategories();
87 QString parentCategoryId(const QString &categoryId) const;
88 QStringList childCategoryIds(const QString &parentId = QString()) const;
89
90 QPlaceCategory category(const QString &categoryId) const;
91 QList<QPlaceCategory> childCategories(const QString &parentId = QString()) const;
92
93 QList<QLocale> locales() const;
94 void setLocale(const QLocale &locale);
95 void setLocales(const QList<QLocale> &locale);
96
97 QPlace compatiblePlace(const QPlace &place);
98
99 QPlaceMatchReply *matchingPlaces(const QPlaceMatchRequest &request) const;
100
101Q_SIGNALS:
102 void finished(QPlaceReply *reply);
103 void error(QPlaceReply *, QPlaceReply::Error error, const QString &errorString = QString());
104
105 void placeAdded(const QString &placeId);
106 void placeUpdated(const QString &placeId);
107 void placeRemoved(const QString &placeId);
108
109 void categoryAdded(const QPlaceCategory &category, const QString &parentId);
110 void categoryUpdated(const QPlaceCategory &category, const QString &parentId);
111 void categoryRemoved(const QString &categoryId, const QString &parentId);
112 void dataChanged();
113
114private:
115 explicit QPlaceManager(QPlaceManagerEngine *engine, QObject *parent = nullptr);
116 Q_DISABLE_COPY(QPlaceManager)
117
118 QPlaceManagerEngine *d;
119
120 friend class QGeoServiceProvider;
121 friend class QGeoServiceProviderPrivate;
122 friend class QPlaceIcon;
123};
124
125QT_END_NAMESPACE
126
127#endif // QPLACEMANAGER_H
128

source code of qtlocation/src/location/places/qplacemanager.h