--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/qtmobility/src/location/qgeopositioninfo.cpp Fri Apr 16 15:51:22 2010 +0300
@@ -0,0 +1,324 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the Qt Mobility Components.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights. These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+#include "qgeopositioninfo.h"
+
+#include <QHash>
+#include <QDebug>
+#include <QDataStream>
+
+QTM_BEGIN_NAMESPACE
+
+class QGeoPositionInfoPrivate
+{
+public:
+ QDateTime dateTime;
+ QGeoCoordinate coord;
+ QHash<int, qreal> doubleAttribs;
+};
+
+/*!
+ \class QGeoPositionInfo
+ \brief The QGeoPositionInfo class contains information gathered on a global position, direction and velocity at a particular point in time.
+ \ingroup location
+
+ A QGeoPositionInfo contains, at a minimum, a geographical coordinate and
+ a timestamp. It may also have heading and speed measurements as well as
+ estimates of the accuracy of the provided data.
+
+ \sa QGeoPositionInfoSource
+*/
+
+/*!
+ \enum QGeoPositionInfo::Attribute
+ Defines the attributes for positional information.
+
+ \value Direction The bearing to true north from the direction of travel, in degrees.
+ \value GroundSpeed The ground speed, in metres/sec.
+ \value VerticalSpeed The vertical speed, in metres/sec.
+ \value MagneticVariation The angle between the horizontal component of the magnetic field and true north, in degrees. Also known as magnetic declination. A positive value indicates a clockwise direction from true north and a negative value indicates a counter-clockwise direction.
+ \value HorizontalAccuracy The accuracy of the provided latitude-longitude value, in metres.
+ \value VerticalAccuracy The accuracy of the provided altitude value, in metres.
+*/
+
+/*!
+ Creates an invalid QGeoPositionInfo object.
+
+ \sa isValid()
+*/
+QGeoPositionInfo::QGeoPositionInfo()
+ : d(new QGeoPositionInfoPrivate)
+{
+}
+
+/*!
+ Creates a QGeoPositionInfo for the given \a coordinate and \a dateTime.
+*/
+QGeoPositionInfo::QGeoPositionInfo(const QGeoCoordinate &coordinate, const QDateTime &dateTime)
+ : d(new QGeoPositionInfoPrivate)
+{
+ d->dateTime = dateTime;
+ d->coord = coordinate;
+}
+
+/*!
+ Creates a QGeoPositionInfo with the values of \a other.
+*/
+QGeoPositionInfo::QGeoPositionInfo(const QGeoPositionInfo &other)
+ : d(new QGeoPositionInfoPrivate)
+{
+ operator=(other);
+}
+
+/*!
+ Destroys a QGeoPositionInfo object.
+*/
+QGeoPositionInfo::~QGeoPositionInfo()
+{
+ delete d;
+}
+
+/*!
+ Assigns the values from \a other to this QGeoPositionInfo.
+*/
+QGeoPositionInfo &QGeoPositionInfo::operator=(const QGeoPositionInfo & other)
+{
+ if (this == &other)
+ return *this;
+
+ d->dateTime = other.d->dateTime;
+ d->coord = other.d->coord;
+ d->doubleAttribs = other.d->doubleAttribs;
+
+ return *this;
+}
+
+/*!
+ Returns true if all of this object's values are the same as those of
+ \a other.
+*/
+bool QGeoPositionInfo::operator==(const QGeoPositionInfo &other) const
+{
+ return d->dateTime == other.d->dateTime
+ && d->coord == other.d->coord
+ && d->doubleAttribs == other.d->doubleAttribs;
+}
+
+/*!
+ \fn bool QGeoPositionInfo::operator!=(const QGeoPositionInfo &other) const
+
+ Returns true if any of this object's values are not the same as those of
+ \a other.
+*/
+
+/*!
+ Returns true if the dateTime() and coordinate() values are both valid.
+
+ \sa QGeoCoordinate::isValid(), QDateTime::isValid()
+*/
+bool QGeoPositionInfo::isValid() const
+{
+ return d->dateTime.isValid() && d->coord.isValid();
+}
+
+/*!
+ Sets the date and time at which this position was reported to \a dateTime.
+
+ The \a dateTime must be in UTC time.
+
+ \sa dateTime()
+*/
+void QGeoPositionInfo::setDateTime(const QDateTime &dateTime)
+{
+ d->dateTime = dateTime;
+}
+
+/*!
+ Returns the date and time at which this position was reported, in UTC time.
+
+ Returns an invalid QDateTime if no date/time value has been set.
+
+ \sa setDateTime()
+*/
+QDateTime QGeoPositionInfo::dateTime() const
+{
+ return d->dateTime;
+}
+
+/*!
+ Sets the coordinate for this position to \a coordinate.
+
+ \sa coordinate()
+*/
+void QGeoPositionInfo::setCoordinate(const QGeoCoordinate &coordinate)
+{
+ d->coord = coordinate;
+}
+
+/*!
+ Returns the coordinate for this position.
+
+ Returns an invalid coordinate if no coordinate has been set.
+
+ \sa setCoordinate()
+*/
+QGeoCoordinate QGeoPositionInfo::coordinate() const
+{
+ return d->coord;
+}
+
+/*!
+ Sets the value for \a attribute to \a value.
+
+ \sa attribute()
+*/
+void QGeoPositionInfo::setAttribute(Attribute attribute, qreal value)
+{
+ d->doubleAttribs[int(attribute)] = value;
+}
+
+/*!
+ Returns the value of the specified \a attribute as a qreal value.
+
+ Returns -1 if the value has not been set.
+
+ \sa hasAttribute(), setAttribute()
+*/
+qreal QGeoPositionInfo::attribute(Attribute attribute) const
+{
+ if (d->doubleAttribs.contains(int(attribute)))
+ return d->doubleAttribs[int(attribute)];
+ return -1;
+}
+
+/*!
+ Removes the specified \a attribute and its value.
+*/
+void QGeoPositionInfo::removeAttribute(Attribute attribute)
+{
+ d->doubleAttribs.remove(int(attribute));
+}
+
+/*!
+ Returns true if the specified \a attribute is present for this
+ QGeoPositionInfo object.
+*/
+bool QGeoPositionInfo::hasAttribute(Attribute attribute) const
+{
+ return d->doubleAttribs.contains(int(attribute));
+}
+
+#ifndef QT_NO_DEBUG_STREAM
+QDebug operator<<(QDebug dbg, const QGeoPositionInfo &update)
+{
+ dbg.nospace() << "QGeoPositionInfo(" << update.d->dateTime;
+ dbg.nospace() << ", ";
+ dbg.nospace() << update.d->coord;
+
+ QList<int> attribs = update.d->doubleAttribs.keys();
+ for (int i = 0; i < attribs.count(); i++) {
+ dbg.nospace() << ", ";
+ switch (attribs[i]) {
+ case QGeoPositionInfo::Direction:
+ dbg.nospace() << "Direction=";
+ break;
+ case QGeoPositionInfo::GroundSpeed:
+ dbg.nospace() << "GroundSpeed=";
+ break;
+ case QGeoPositionInfo::VerticalSpeed:
+ dbg.nospace() << "VerticalSpeed=";
+ break;
+ case QGeoPositionInfo::MagneticVariation:
+ dbg.nospace() << "MagneticVariation=";
+ break;
+ case QGeoPositionInfo::HorizontalAccuracy:
+ dbg.nospace() << "HorizontalAccuracy=";
+ break;
+ case QGeoPositionInfo::VerticalAccuracy:
+ dbg.nospace() << "VerticalAccuracy=";
+ break;
+ }
+ dbg.nospace() << update.d->doubleAttribs[attribs[i]];
+ }
+ dbg.nospace() << ')';
+ return dbg;
+}
+#endif
+
+#ifndef QT_NO_DATASTREAM
+/*!
+ \fn QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)
+ \relates QGeoPositionInfo
+
+ Writes the given \a info to the specified \a stream.
+
+ \sa {Format of the QDataStream Operators}
+*/
+
+QDataStream &operator<<(QDataStream &stream, const QGeoPositionInfo &info)
+{
+ stream << info.d->dateTime;
+ stream << info.d->coord;
+ stream << info.d->doubleAttribs;
+ return stream;
+}
+#endif
+
+#ifndef QT_NO_DATASTREAM
+/*!
+ \fn QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo &info)
+ \relates QGeoPositionInfo
+
+ Reads a coordinate from the specified \a stream into the given
+ \a info.
+
+ \sa {Format of the QDataStream Operators}
+*/
+
+QDataStream &operator>>(QDataStream &stream, QGeoPositionInfo &info)
+{
+ stream >> info.d->dateTime;
+ stream >> info.d->coord;
+ stream >> info.d->doubleAttribs;
+ return stream;
+}
+#endif
+
+QTM_END_NAMESPACE