Class: QgsCoordinateReferenceSystemRegistry¶
- class qgis.core.QgsCoordinateReferenceSystemRegistry¶
Bases:
PyQt5.QtCore.QObject
A registry for known coordinate reference system (CRS) definitions, including any user-defined CRSes.
QgsCoordinateReferenceSystemRegistry
is not usually directly created, but rather accessed throughQgsApplication.coordinateReferenceSystemRegistry()
.New in version 3.18.
QgsCoordinateReferenceSystemRegistry(parent: QObject = None) Constructor for
QgsCoordinateReferenceSystemRegistry
, with the specifiedparent
object.Methods
Adds a new
crs
definition as a custom ("USER") CRS.Returns a list of all known celestial bodies.
Returns a map of all valid PROJ operations.
Removes the existing user CRS with matching
id
.Updates the definition of the existing user CRS with matching
id
.Returns a list containing the details of all registered custom (user-defined) CRSes.
Signals
pyqtSignal(*types, name: str = ..., revision: int = ..., arguments: Sequence = ...) -> PYQT_SIGNAL
pyqtSignal(*types, name: str = ..., revision: int = ..., arguments: Sequence = ...) -> PYQT_SIGNAL
pyqtSignal(*types, name: str = ..., revision: int = ..., arguments: Sequence = ...) -> PYQT_SIGNAL
pyqtSignal(*types, name: str = ..., revision: int = ..., arguments: Sequence = ...) -> PYQT_SIGNAL
- class UserCrsDetails¶
Bases:
sip.wrapper
Contains details of a custom (user defined) CRS.
New in version 3.18.
- crs¶
- id¶
- name¶
- proj¶
- wkt¶
- addUserCrs(self, crs: QgsCoordinateReferenceSystem, name: str, nativeFormat: Qgis.CrsDefinitionFormat = Qgis.CrsDefinitionFormat.Wkt) int ¶
Adds a new
crs
definition as a custom (“USER”) CRS.Returns the new CRS
srsid()
, or -1 if the CRS could not be saved.The
nativeFormat
argument specifies the format to use when saving the CRS definition. FormatWkt is recommended as it is a lossless format.Warning
Not all CRS definitions can be represented as a Proj string, so take care when using the FormatProj option.
See also
See also
- Parameters:
crs (QgsCoordinateReferenceSystem) –
name (str) –
nativeFormat (Qgis.CrsDefinitionFormat = Qgis.CrsDefinitionFormat.Wkt) –
- Return type:
int
- celestialBodies(self) List[QgsCelestialBody] ¶
Returns a list of all known celestial bodies.
Warning
This method requires PROJ 8.1 or later
- Raises:
QgsNotSupportedException – on QGIS builds based on PROJ 8.0 or earlier.
New in version 3.20.
- Return type:
List[QgsCelestialBody]
- childEvent(self, QChildEvent)¶
- connectNotify(self, QMetaMethod)¶
- crsDefinitionsChanged¶
pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL
types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.
- Parameters:
name (str = ...) –
revision (int = ...) –
arguments (Sequence = ...) –
- Return type:
PYQT_SIGNAL
- customEvent(self, QEvent)¶
- disconnectNotify(self, QMetaMethod)¶
- isSignalConnected(self, QMetaMethod) bool ¶
- projOperations(self) Dict[str, QgsProjOperation] ¶
Returns a map of all valid PROJ operations.
The map keys correspond to PROJ operation IDs.
New in version 3.20.
- Return type:
Dict[str, QgsProjOperation]
- receivers(self, PYQT_SIGNAL) int ¶
- removeUserCrs(self, id: int) bool ¶
Removes the existing user CRS with matching
id
.Returns
False
if the CRS could not be removed.See also
- Parameters:
id (int) –
- Return type:
bool
- sender(self) QObject ¶
- senderSignalIndex(self) int ¶
- timerEvent(self, QTimerEvent)¶
- updateUserCrs(self, id: int, crs: QgsCoordinateReferenceSystem, name: str, nativeFormat: Qgis.CrsDefinitionFormat = Qgis.CrsDefinitionFormat.Wkt) bool ¶
Updates the definition of the existing user CRS with matching
id
.The
crs
argument specifies a CRS with the desired new definition.Returns
False
if the new CRS definition could not be saved.The
nativeFormat
argument specifies the format to use when saving the CRS definition. FormatWkt is recommended as it is a lossless format.Warning
Not all CRS definitions can be represented as a Proj string, so take care when using the FormatProj option.
See also
See also
- Parameters:
id (int) –
crs (QgsCoordinateReferenceSystem) –
name (str) –
nativeFormat (Qgis.CrsDefinitionFormat = Qgis.CrsDefinitionFormat.Wkt) –
- Return type:
bool
- userCrsAdded¶
pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL
types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.
- Parameters:
name (str = ...) –
revision (int = ...) –
arguments (Sequence = ...) –
- Return type:
PYQT_SIGNAL
- userCrsChanged¶
pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL
types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.
- Parameters:
name (str = ...) –
revision (int = ...) –
arguments (Sequence = ...) –
- Return type:
PYQT_SIGNAL
- userCrsList(self) List[QgsCoordinateReferenceSystemRegistry.UserCrsDetails] ¶
Returns a list containing the details of all registered custom (user-defined) CRSes.
- Return type:
- userCrsRemoved¶
pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL
types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.
- Parameters:
name (str = ...) –
revision (int = ...) –
arguments (Sequence = ...) –
- Return type:
PYQT_SIGNAL