// 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 "PluginInterface.h"
#include <QObject>

namespace Marble
{

class ReverseGeocodingRunner;

/**
 * A plugin for Marble to execute a reverse geocoding task.
 */
class MARBLE_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
