2 Situare - A location system for Facebook
3 Copyright (C) 2010 Ixonos Plc. Authors:
5 Jussi Laitinen - jussi.laitinen@ixonos.com
7 Situare is free software; you can redistribute it and/or
8 modify it under the terms of the GNU General Public License
9 version 2 as published by the Free Software Foundation.
11 Situare is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with Situare; if not, write to the Free Software
18 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
22 #ifndef GPSPOSITIONPRIVATELIBLOCATION_H
23 #define GPSPOSITIONPRIVATELIBLOCATION_H
27 #include "gpsposition.h"
28 #include "geopositioninfo.h"
30 class LiblocationWrapper;
33 * @brief GPSPositionPrivate class use GPS to receive location information.
35 class GPSPositionPrivate : public QObject
41 * @brief Constructor creates GPS source.
43 * @param parent QObject
45 GPSPositionPrivate(QObject *parent);
47 /******************************************************************************
48 * MEMBER FUNCTIONS AND SLOTS
49 ******************************************************************************/
52 * @brief Enables power save mode.
54 * Starts GPS for position update and then stops it.
56 void enablePowerSave(bool enabled);
59 * @brief Returns is GPS initialized.
61 * @return true if initialized, false otherwise
66 * @brief Checks if GPS is running.
68 * @return true if GPS running, false otherwise
73 * @brief Return last known position.
75 QPointF lastPosition();
78 * @brief Informs gps to emit last known position.
80 void requestLastPosition();
83 * @brief Requests update from GPS.
85 * Enables GPS if it is disabled
90 * @brief Set GPS mode.
92 * Modes: default and simulation.
93 * @param mode GPS mode
94 * @param filePath file path to NMEA file if simulation mode is used
96 void setMode(GPSPosition::Mode mode, const QString &filePath = 0);
99 * @brief Set GPS update interval
101 * @return interval interval in milliseconds
103 void setUpdateInterval(int interval);
117 * @brief Returns horizontal accuracy.
119 * @param positionInfo geo position info
120 * @return accuracy value, -1 if undefined. Returns -1 also is timestamp is not valid
121 * (when using network positioning)
123 qreal accuracy(const GeoPositionInfo &positionInfo);
128 * @brief Slot for received position update.
130 * @param positionInfo Geo position info.
132 void positionUpdated(const GeoPositionInfo &positionInfo);
135 * @brief Slot for location error.
137 * Called when there is error in GPS.
139 void locationError(const QString &errorMessage);
141 /*******************************************************************************
143 ******************************************************************************/
145 LiblocationWrapper *m_liblocationWrapper; ///< Liblocation wrapper object
146 GPSPosition *m_parent; ///< Parent object
147 bool m_initialized; ///< GPS is initialized
148 bool m_powerSave; ///< Power save flag
149 bool m_running; ///< GPS is running
150 int m_updateInterval; ///< GPS update interval
153 const int DEFAULT_UPDATE_INTERVAL = 5000; ///< Default update interval
155 #endif // GPSPOSITIONPRIVATELIBLOCATION_H