TileMath.h

Go to the documentation of this file.

/****************************************************************************
 *
 * (c) 2009-2024 QGROUNDCONTROL PROJECT <http://www.qgroundcontrol.org>
 *
 * QGroundControl is licensed according to the terms in the file
 * COPYING.md in the root of the source code directory.
 *
 ****************************************************************************/
 
#pragma once
 
#include <QtCore/QDebug>
#include <QtCore/QHashFunctions>
#include <QtCore/QMetaType>
#include <QtCore/QPointF>
#include <QtPositioning/QGeoCoordinate>
 
namespace TileMath {
 
constexpr double kEarthRadius = 6378137.0;    
constexpr double kMaxLatitude = 85.05112878;  
constexpr int kMinZoom = 0;
constexpr int kMaxZoom = 23;
constexpr int kTilePixels = 256;  
 
struct TileKey
{
    int x = 0;
    int y = 0;
    int zoom = 0;
 
    bool operator==(const TileKey& other) const { return (x == other.x) && (y == other.y) && (zoom == other.zoom); }
};
 
inline size_t qHash(const TileKey& key, size_t seed = 0)
{
    return ::qHashMulti(seed, key.x, key.y, key.zoom);
}
 
QDebug operator<<(QDebug debug, const TileKey& key);
 
}  // namespace TileMath
 
Q_DECLARE_METATYPE(TileMath::TileKey)
 
namespace TileMath {
 
double worldSize();
 
bool isValidKey(const TileKey& key);
 
QPointF geoToWorld(const QGeoCoordinate& coord);
 
QGeoCoordinate worldToGeo(const QPointF& world);
 
double mercatorScale(double latitude);
 
double tileSpanAtZoom(int zoom);
 
QPointF tileMinCorner(const TileKey& key);
 
TileKey tileForWorld(const QPointF& world, int zoom);
 
double metersPerPixelAtZoom(int zoom);
 
int zoomForMetersPerPixel(double metersPerPixel);
 
}  // namespace TileMath