/usr/include/KPim/KGAPI/kgapi/latitude/locationfetchjob.h is in libkpimgapi-dev 17.12.3-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 | /*
* This file is part of LibKGAPI library
*
* Copyright (C) 2013 Daniel Vrátil <dvratil@redhat.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) version 3, or any
* later version accepted by the membership of KDE e.V. (or its
* successor approved by the membership of KDE e.V.), which shall
* act as a proxy defined in Section 6 of version 3 of the license.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef LIBKGAPI2_LOCATIONFETCHJOB_H
#define LIBKGAPI2_LOCATIONFETCHJOB_H
#include "fetchjob.h"
#include "latitude.h"
#include "kgapilatitude_export.h"
namespace KGAPI2 {
/**
* @brief A job to fetch current or a specific locations from user's account on
* Google Latitude
*
* @author Daniel Vrátil <dvratil@redhat.com>
* @since 2.0
*/
class KGAPILATITUDE_EXPORT LocationFetchJob : public KGAPI2::FetchJob
{
Q_OBJECT
/**
* @brief Granularity of the results
*
* Specifies how precise the results should be. By default, Latitude::City
* granularity is used.
*
* This property can be modified only when the job is not running.
*
* @see setGranularity, granularity
*/
Q_PROPERTY(Latitude::Granularity granularity READ granularity WRITE setGranularity)
public:
/**
* @brief Constructs a job that will fetch users current locations from
* Google Latitude service
*
* @param account Account to authenticate the requests
* @param parent
*/
explicit LocationFetchJob(const AccountPtr &account, QObject* parent = nullptr);
/**
* @brief Constructs a job that will fetch specific past user's location from
* Google Latitude service
*
* @param timestamp Timestamp of the location to fetch
* @param account Account to authenticate the requests
* @param parent
*/
explicit LocationFetchJob(qlonglong timestamp, const AccountPtr &account, QObject* parent = nullptr);
/**
* @brief Destructor
*/
virtual ~LocationFetchJob();
/**
* @brief Sets granularity of the requested result. By default it's City.
*
* @param granularity
*/
void setGranularity(Latitude::Granularity granularity);
/**
* @brief Returns granularity of the requested location.
*/
Latitude::Granularity granularity() const;
protected:
/**
* @brief KGAPI2::Job::start implementation
*/
void start() override;
/**
* @brief KGAPI2::FetchJob::handleReplyWithItems implementation
*
* @param reply
* @param rawData
*/
ObjectsList handleReplyWithItems(const QNetworkReply *reply,
const QByteArray& rawData) override;
private:
class Private;
Private * const d;
friend class Private;
};
} // namespace KGAPI2
#endif // LIBKGAPI2_LOCATIONFETCHJOB_H
|