18 #ifndef QGSCOORDINATEREFERENCESYSTEM_H
19 #define QGSCOORDINATEREFERENCESYSTEM_H
22 #include "qgis_core.h"
29 #include <QReadWriteLock>
30 #include <QExplicitlySharedDataPointer>
35 #include "qgsconfig.h"
42 class QgsCoordinateReferenceSystemPrivate;
49 typedef struct PJconsts
PJ;
51 #if PROJ_VERSION_MAJOR>=8
216 Q_PROPERTY(
bool isGeographic READ isGeographic )
217 Q_PROPERTY( QString authid READ authid )
218 Q_PROPERTY( QString description READ description )
276 operator QVariant()
const
278 return QVariant::fromValue( *
this );
288 static QList< long > validSrsIds();
354 Q_DECL_DEPRECATED
bool createFromId(
long id, CrsType type = PostgisCrsId )
SIP_DEPRECATED;
368 bool createFromOgcWmsCrs(
const QString &
crs );
379 Q_DECL_DEPRECATED
bool createFromSrid(
long srid )
SIP_DEPRECATED;
393 bool createFromWkt(
const QString &wkt );
407 bool createFromSrsId(
long srsId );
432 Q_DECL_DEPRECATED
bool createFromProj4(
const QString &projString )
SIP_DEPRECATED;
462 bool createFromProj(
const QString &projString,
bool identify =
true );
464 bool createFromProj(
const QString &projString );
482 bool createFromString(
const QString &definition );
501 bool createFromUserInput(
const QString &definition );
516 bool isValid() const;
563 bool readXml( const QDomNode &node );
571 bool writeXml( QDomNode &node, QDomDocument &doc ) const;
600 long postgisSrid() const;
614 QString authid() const;
623 QString description() const;
650 QString userFriendlyIdentifier( IdentifierType type = MediumString )
const;
658 QString projectionAcronym()
const;
666 QString ellipsoidAcronym()
const;
677 WKT2_2019 = WKT2_2018,
678 WKT2_2019_SIMPLIFIED = WKT2_2018_SIMPLIFIED,
680 WKT_PREFERRED = WKT2_2019,
681 WKT_PREFERRED_SIMPLIFIED = WKT2_2019_SIMPLIFIED,
682 WKT_PREFERRED_GDAL = WKT2_2019,
696 QString toWkt( WktVariant variant = WKT1_GDAL,
bool multiline =
false,
int indentationWidth = 4 )
const;
724 QString toProj() const;
730 bool isGeographic() const;
740 bool isDynamic() const;
790 void setCoordinateEpoch(
double epoch );
815 double coordinateEpoch() const;
877 void updateDefinition();
882 void setValidationHint( const QString &html );
887 QString validationHint();
895 static
int syncDatabase();
910 long saveAsUserCrs( const QString &name,
Qgis::CrsDefinitionFormat nativeFormat =
Qgis::CrsDefinitionFormat::Wkt );
921 void setNativeFormat(
Qgis::CrsDefinitionFormat format );
932 Qgis::CrsDefinitionFormat nativeFormat() const;
946 QString geographicCrsAuthId() const;
949 SIP_PYOBJECT __repr__();
952 std::isfinite( sipCpp->coordinateEpoch() ) ? QStringLiteral(
" @ %1" ).arg( sipCpp->coordinateEpoch() ) : QString() )
953 : QStringLiteral(
"<QgsCoordinateReferenceSystem: invalid>" );
954 sipRes = PyUnicode_FromString(
str.toUtf8().constData() );
969 PJ *projObject()
const;
991 bool createFromProjObject(
PJ *
object );
999 Q_DECL_DEPRECATED
static QStringList recentProjections()
SIP_DEPRECATED;
1025 static void invalidateCache(
bool disableCache =
false );
1035 static void invalidateCache(
bool disableCache
SIP_PYARGREMOVE =
false );
1048 static QString projFromSrsId(
int srsId );
1055 void setProjString(
const QString &projString );
1060 bool setWktString(
const QString &wkt );
1068 typedef QMap<QString, QString> RecordMap;
1077 RecordMap getRecord(
const QString &sql );
1089 static long getRecordCount();
1091 bool loadFromAuthCode(
const QString &auth,
const QString &code );
1096 static QList< long > userSrsIds();
1105 long matchToUserCrs()
const;
1111 bool loadFromDatabase(
const QString &db,
const QString &expression,
const QString &value );
1113 bool createFromWktInternal(
const QString &wkt,
const QString &description );
1115 QExplicitlySharedDataPointer<QgsCoordinateReferenceSystemPrivate> d;
1117 QString mValidationHint;
1124 static void removeFromCacheObjectsBelongingToCurrentThread(
PJ_CONTEXT *pj_context );
1131 static bool sDisableSrIdCache;
1132 static bool sDisableOgcCache;
1133 static bool sDisableProjCache;
1134 static bool sDisableWktCache;
1135 static bool sDisableSrsIdCache;
1136 static bool sDisableStringCache;
1139 static const QHash< QString, QgsCoordinateReferenceSystem > &stringCache();
1140 static const QHash< QString, QgsCoordinateReferenceSystem > &projCache();
1141 static const QHash< QString, QgsCoordinateReferenceSystem > &ogcCache();
1142 static const QHash< QString, QgsCoordinateReferenceSystem > &wktCache();
1143 static const QHash< long, QgsCoordinateReferenceSystem > &srsIdCache();
1144 static const QHash< long, QgsCoordinateReferenceSystem > &srIdCache();
1146 friend class TestQgsCoordinateReferenceSystem;
1153 bool createFromPostgisSrid(
const long id );
1162 QString mySummary( QStringLiteral(
"\n\tSpatial Reference System:" ) );
1163 mySummary += QLatin1String(
"\n\t\tDescription : " );
1170 mySummary += QLatin1String(
"Undefined" );
1172 mySummary += QLatin1String(
"\n\t\tProjection : " );
1179 mySummary += QLatin1String(
"Undefined" );
1182 mySummary += QLatin1String(
"\n\t\tEllipsoid : " );
1189 mySummary += QLatin1String(
"Undefined" );
1192 mySummary += QLatin1String(
"\n\t\tProjString : " );
1193 if ( !r.
toProj().isNull() )
1199 mySummary += QLatin1String(
"Undefined" );
1202 return os << mySummary.toLocal8Bit().data() << std::endl;
The Qgis class provides global constants for use throughout the application.
CrsDefinitionFormat
CRS definition formats.
A registry for known coordinate reference system (CRS) definitions, including any user-defined CRSes.
This class represents a coordinate reference system (CRS).
QString toProj() const
Returns a Proj string representation of this CRS.
QString ellipsoidAcronym() const
Returns the ellipsoid acronym for the ellipsoid used by the CRS.
QString projectionAcronym() const
Returns the projection acronym for the projection used by the CRS.
CrsType
Enumeration of types of IDs accepted in createFromId() method.
@ InternalCrsId
Internal ID used by QGIS in the local SQLite database.
@ PostgisCrsId
SRID used in PostGIS. DEPRECATED – DO NOT USE.
IdentifierType
Type of identifier string to create.
@ MediumString
A medium-length string, recommended for general purpose use.
@ FullString
Full definition – possibly a very lengthy string, e.g. with no truncation of custom WKT definitions.
@ ShortString
A heavily abbreviated string, for use when a compact representation is required.
WktVariant
WKT formatting variants, only used for builds based on Proj >= 6.
@ WKT1_GDAL
WKT1 as traditionally output by GDAL, deriving from OGC 01-009. A notable departure from WKT1_GDAL wi...
@ WKT2_2018_SIMPLIFIED
Alias for WKT2_2019_SIMPLIFIED.
@ WKT_PREFERRED
Preferred format, matching the most recent WKT ISO standard. Currently an alias to WKT2_2019,...
@ WKT2_2015
Full WKT2 string, conforming to ISO 19162:2015(E) / OGC 12-063r5 with all possible nodes and new keyw...
@ WKT2_2018
Alias for WKT2_2019.
@ WKT1_ESRI
WKT1 as traditionally output by ESRI software, deriving from OGC 99-049.
@ WKT2_2015_SIMPLIFIED
Same as WKT2_2015 with the following exceptions: UNIT keyword used. ID node only on top element....
Contains information about a datum ensemble.
Custom exception class which is raised when an operation is not supported.
Point geometry type, with support for z-dimension and m-values.
Used to create and store a proj context object, correctly freeing the context upon destruction.
Contains information about a PROJ operation.
contains various cartographic properties, such as scale factors, angular distortion and meridian conv...
A rectangle specified with double values.
Helper functions for various unit types.
DistanceUnit
Units of distance.
Unique pointer for sqlite3 databases, which automatically closes the database when the pointer goes o...
void * OGRSpatialReferenceH
bool CORE_EXPORT operator<(const QgsCoordinateReferenceSystem &c1, const QgsCoordinateReferenceSystem &c2)
bool CORE_EXPORT operator>(const QgsCoordinateReferenceSystem &c1, const QgsCoordinateReferenceSystem &c2)
bool CORE_EXPORT operator<=(const QgsCoordinateReferenceSystem &c1, const QgsCoordinateReferenceSystem &c2)
std::ostream & operator<<(std::ostream &os, const QgsCoordinateReferenceSystem &r)
Output stream operator.
struct projCtx_t PJ_CONTEXT
bool CORE_EXPORT operator>=(const QgsCoordinateReferenceSystem &c1, const QgsCoordinateReferenceSystem &c2)
void(* CUSTOM_CRS_VALIDATION)(QgsCoordinateReferenceSystem &)
Q_DECLARE_METATYPE(QgsMeshTimeSettings)
const QgsCoordinateReferenceSystem & crs