1 /****************************************************************************
3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4 ** All rights reserved.
5 ** Contact: Nokia Corporation (qt-info@nokia.com)
7 ** This file is part of the Qt Mobility Components.
9 ** $QT_BEGIN_LICENSE:LGPL$
10 ** No Commercial Usage
11 ** This file contains pre-release code and may not be distributed.
12 ** You may use this file in accordance with the terms and conditions
13 ** contained in the Technology Preview License Agreement accompanying
16 ** GNU Lesser General Public License Usage
17 ** Alternatively, this file may be used under the terms of the GNU Lesser
18 ** General Public License version 2.1 as published by the Free Software
19 ** Foundation and appearing in the file LICENSE.LGPL included in the
20 ** packaging of this file. Please review the following information to
21 ** ensure the GNU Lesser General Public License version 2.1 requirements
22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24 ** In addition, as a special exception, Nokia gives you certain additional
25 ** rights. These rights are described in the Nokia Qt LGPL Exception
26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28 ** If you have questions regarding the use of this file, please contact
29 ** Nokia at qt-info@nokia.com.
40 ****************************************************************************/
41 #ifndef QGEOPOSITIONINFOSOURCE_H
42 #define QGEOPOSITIONINFOSOURCE_H
44 #include "qmobilityglobal.h"
45 #include "qgeopositioninfo.h"
53 class QGeoPositionInfoSourcePrivate;
54 class Q_LOCATION_EXPORT QGeoPositionInfoSource : public QObject
57 Q_PROPERTY(int updateInterval READ updateInterval WRITE setUpdateInterval)
58 Q_PROPERTY(int minimumUpdateInterval READ minimumUpdateInterval)
61 enum PositioningMethod {
62 SatellitePositioningMethods = 0x000000ff,
63 NonSatellitePositioningMethods = 0xffffff00,
64 AllPositioningMethods = 0xffffffff
66 Q_DECLARE_FLAGS(PositioningMethods, PositioningMethod)
68 explicit QGeoPositionInfoSource(QObject *parent);
69 virtual ~QGeoPositionInfoSource();
71 virtual void setUpdateInterval(int msec);
72 int updateInterval() const;
74 virtual void setPreferredPositioningMethods(PositioningMethods methods);
75 PositioningMethods preferredPositioningMethods() const;
77 virtual QGeoPositionInfo lastKnownPosition(bool fromSatellitePositioningMethodsOnly = false) const = 0;
79 virtual PositioningMethods supportedPositioningMethods() const = 0;
80 virtual int minimumUpdateInterval() const = 0;
82 static QGeoPositionInfoSource *createDefaultSource(QObject *parent);
85 virtual void startUpdates() = 0;
86 virtual void stopUpdates() = 0;
88 virtual void requestUpdate(int timeout = 0) = 0;
91 void positionUpdated(const QGeoPositionInfo &update);
95 Q_DISABLE_COPY(QGeoPositionInfoSource)
96 QGeoPositionInfoSourcePrivate *d;
99 Q_DECLARE_OPERATORS_FOR_FLAGS(QGeoPositionInfoSource::PositioningMethods)