basemapconnection.h

Go to the documentation of this file.

 
#ifndef BASEMAPCONNECTION_H
#define BASEMAPCONNECTION_H
 
#include <QMap>
#include <QString>
 
// ---------------------------------------------------------------------------
// Types shared across connection structs
// ---------------------------------------------------------------------------
 
using BasemapHttpHeaders = QMap<QString, QString>;
 
enum class TileAxisOrder
{
    ZXY = 0,  
    ZYX = 1,  
};
 
// ---------------------------------------------------------------------------
// Per-connection auth credentials (runtime only — never persisted in JSON)
// ---------------------------------------------------------------------------
 
struct BasemapAuth
{
    QString username;
    QString password;
 
    [[nodiscard]] bool isEmpty() const { return username.isEmpty() && password.isEmpty(); }
};
 
// ---------------------------------------------------------------------------
// XYZ tile connection
// ---------------------------------------------------------------------------
 
struct XYZConnection
{
    QString            name;
    QString            urlTemplate;
    int                zMin           = 0;
    int                zMax           = 19;
    int                tilePixelRatio = 0;
    TileAxisOrder      axisOrder      = TileAxisOrder::ZXY;
    BasemapHttpHeaders httpHeaders;   
    bool               isBuiltin      = false; 
    static QList<XYZConnection> builtins()
    {
        return {
            { "OpenStreetMap",
              "https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png",
              0, 19, 0, TileAxisOrder::ZXY, {}, true },
            { "CartoDB Positron",
              "https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}@2x.png",
              0, 20, 2, TileAxisOrder::ZXY, {}, true },
            { "CartoDB Dark Matter",
              "https://{s}.basemaps.cartocdn.com/dark_all/{z}/{x}/{y}@2x.png",
              0, 20, 2, TileAxisOrder::ZXY, {}, true },
            { "Stadia Alidade Smooth",
              "https://tiles.stadiamaps.com/tiles/alidade_smooth/{z}/{x}/{y}@2x.png",
              0, 20, 2, TileAxisOrder::ZXY, {}, true },
            { "ESRI World Imagery",
              "https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}",
              0, 23, 0, TileAxisOrder::ZXY, {}, true },
        };
    }
};
 
// ---------------------------------------------------------------------------
// WMS / WMTS connection  (protocol auto-detected at Connect time)
// ---------------------------------------------------------------------------
 
struct WMSConnection
{
    QString            name;
    QString            url;
 
    // --- Layer selection (populated after Connect) ---
    QString            layerName;
    QString            style;
    QString            imageFormat    = "image/png";
    QString            crs            = "EPSG:3857";
    QString            tileMatrixSet;     
    // --- Advanced options (mirrors QGIS WMS provider settings) ---
    int                dpiMode                 = 7;
    int                tilePixelRatio          = 0;  
    bool               ignoreGetMapURI         = false;
    bool               ignoreAxisOrientation   = false;
    bool               invertAxisOrientation   = false;
    bool               smoothPixmapTransform   = true;
 
    BasemapHttpHeaders httpHeaders;
};
 
// ---------------------------------------------------------------------------
// WCS (Web Coverage Service) connection
// ---------------------------------------------------------------------------
 
struct WCSConnection
{
    QString            name;
    QString            url;                   
    QString            version      = QStringLiteral("2.0.1");
 
    // --- Coverage selection (populated after Connect + DescribeCoverage) ---
    QString            coverageId;            
    QString            outputCrs    = QStringLiteral("EPSG:4326");
    QString            outputFormat = QStringLiteral("image/tiff"); 
    QString            rangeSubset;
    QString            interpolation = QStringLiteral("nearest");
 
    BasemapHttpHeaders httpHeaders;
};
 
// ---------------------------------------------------------------------------
// WFS connection
// ---------------------------------------------------------------------------
 
struct WFSConnection
{
    QString            name;
    QString            url;         
    QString            version;
 
    QString            typeName;
 
    BasemapHttpHeaders httpHeaders;
};
 
// ---------------------------------------------------------------------------
// ArcGIS REST connection
// ---------------------------------------------------------------------------
 
struct ArcGISRestConnection
{
    QString            name;
    QString            url;
    QString            urlPrefix;          
    QString            contentEndpoint;
    QString            communityEndpoint;
 
    BasemapHttpHeaders httpHeaders;
};
 
// ---------------------------------------------------------------------------
// Local raster connection
// ---------------------------------------------------------------------------
 
struct LocalRasterConnection
{
    QString name;
    QString filePath;
    QString worldFilePath;   
    QString crsAuthCode;     
};
 
#endif // BASEMAPCONNECTION_H