File indexing completed on 2024-05-12 05:22:24

 /*
     SPDX-FileCopyrightText: 2012 Jan Grulich <grulja@gmail.com>
 
     SPDX-License-Identifier: LGPL-2.1-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
 */
 
 #pragma once
 
 #include "kgapilatitude_export.h"
 #include "latitude.h"
 #include "types.h"
 
 namespace KGAPI2
 {
 
 /**
  * @brief Additional methods for implementing support for Google Latitude service
  *
  * You should never need to use these methods, unless implementing your own Job
  */
 namespace LatitudeService
 {
 
 /**
  * @brief Parses JSON data into a Location object
  *
  * @param jsonData
  */
 KGAPILATITUDE_DEPRECATED_EXPORT LocationPtr JSONToLocation(const QByteArray &jsonData);
 
 /**
  * @brief Serializes a Location object to JSON
  *
  * @param location
  */
 KGAPILATITUDE_DEPRECATED_EXPORT QByteArray locationToJSON(const LocationPtr &location);
 
 /**
  * @brief Parses a JSON feed into list of Locations
  *
  * @param jsonFeed
  * @param feedData The structure will be filled with additional data about
  *                 the feed
  */
 KGAPILATITUDE_DEPRECATED_EXPORT ObjectsList parseLocationJSONFeed(const QByteArray &jsonFeed, FeedData &feedData);
 
 /**
  * @brief Supported version of API
  */
 KGAPILATITUDE_DEPRECATED_EXPORT QString APIVersion();
 
 /**
  * @brief Returns URL for fetch current user's location
  *
  * @param granularity
  */
 KGAPILATITUDE_DEPRECATED_EXPORT QUrl retrieveCurrentLocationUrl(const Latitude::Granularity granularity = Latitude::City);
 
 /**
  *  @brief Returns URL for deleting user's current location
  */
 KGAPILATITUDE_DEPRECATED_EXPORT QUrl deleteCurrentLocationUrl();
 
 /**
  *  @brief Returns URL for uploading user's current location
  */
 KGAPILATITUDE_DEPRECATED_EXPORT QUrl insertCurrentLocationUrl();
 
 /**
  * @brief Returns URL for fetching history of user's locations
  *
  * @param granularity Precision of the coordinates
  * @param maxResults Maximum amount of results to return
  * @param maxTime Maximum timestamp since epoch (in ms)
  * @param minTime Minimum timestamp since epoch (in ms)
  */
 KGAPILATITUDE_DEPRECATED_EXPORT QUrl locationHistoryUrl(const Latitude::Granularity granularity,
                                                         const int maxResults = 0,
                                                         const qlonglong maxTime = 0,
                                                         const qlonglong minTime = 0);
 
 /**
  * @brief URL for fetching a specific location
  *
  * @param id
  * @param granularity;
  */
 KGAPILATITUDE_DEPRECATED_EXPORT QUrl retrieveLocationUrl(const qlonglong id, const Latitude::Granularity granularity = Latitude::City);
 
 /**
  * @brief Returns URL for uploading a location
  */
 KGAPILATITUDE_DEPRECATED_EXPORT QUrl insertLocationUrl();
 
 /**
  * @brief Returns URL to delete a specific location
  *
  * @param id
  */
 KGAPILATITUDE_DEPRECATED_EXPORT QUrl deleteLocationUrl(const qlonglong id);
 
 } // namespace LatitudeService
 
 } // namespace KGAPI2