File indexing completed on 2025-01-05 03:59:31

 // SPDX-License-Identifier: LGPL-2.1-or-later
 //
 // SPDX-FileCopyrightText: 2010 Dennis Nienhüser <nienhueser@kde.org>
 // SPDX-FileCopyrightText: 2011 Thibaut Gridel <tgridel@free.fr>
 // SPDX-FileCopyrightText: 2012 Bernhard Beschow <bbeschow@cs.tu-berlin.de>
 //
 
 #ifndef MARBLE_REVERSEGEOCODINGRUNNERPLUGIN_H
 #define MARBLE_REVERSEGEOCODINGRUNNERPLUGIN_H
 
 #include <QObject>
 #include "PluginInterface.h"
 
 namespace Marble
 {
 
 class ReverseGeocodingRunner;
 
 /**
   * A plugin for Marble to execute a reverse geocoding task.
   */
 class DIGIKAM_EXPORT ReverseGeocodingRunnerPlugin : public QObject, public PluginInterface
 {
     Q_OBJECT
 
 public:
     /** Constructor with optional parent object */
     explicit ReverseGeocodingRunnerPlugin( QObject* parent = nullptr );
 
     /** Destructor */
     ~ReverseGeocodingRunnerPlugin() override;
 
     /**
      * @brief Returns the string that should appear in the user interface.
      *
      * For example, "Nominatim" should be returned for the Nominatim reverse geocoding plugin.
      */
     virtual QString guiString() const = 0;
 
     /** Plugin factory method to create a new runner instance.
       * Method caller gets ownership of the returned object
       */
     virtual ReverseGeocodingRunner *newRunner() const = 0;
 
     /** True if the plugin supports its tasks on the given planet */
     bool supportsCelestialBody( const QString &celestialBodyId ) const;
 
     /** True if the plugin can execute its tasks without network access */
     bool canWorkOffline() const;
 
     /**
      * @brief Returns @code true @endcode if the plugin is able to perform its claimed task.
      *
      * The default implementation returns @code true @endcode. This method can be
      * overridden for example to indicate an incomplete installation.
      */
     virtual bool canWork() const;
 
     // Overridden methods with default implementations
 
     QIcon icon() const override;
 
 protected:
     void setSupportedCelestialBodies( const QStringList &celestialBodies );
 
     void setCanWorkOffline( bool canWorkOffline );
 
 private:
     class Private;
     Private * const d;
 };
 
 }
 
 Q_DECLARE_INTERFACE( Marble::ReverseGeocodingRunnerPlugin, "org.kde.Marble.ReverseGeocodingRunnerPlugin/1.01" )
 
 #endif // MARBLE_REVERSEGEOCODINGRUNNERPLUGIN_H