Class: QgsTileMatrixSet¶
Defines a set of tile matrices for multiple zoom levels.
Added in version 3.22.6.
Class Hierarchy¶
Subclasses¶
Encapsulates properties of a vector tile matrix set, including tile origins and scaling information. |
Methods
Adds tile matrices corresponding to the standard web mercator/GoogleCRS84Quad setup. |
|
Adds a matrix to the set. |
|
Calculates the correct scale to use for the tiles when rendered using the specified map properties. |
|
Returns the coordinate reference system associated with the tiles. |
|
Deletes any existing matrices which fall outside the zoom range specified by minimumZoom to maximumZoom, inclusive. |
|
Returns |
|
Returns the maximum zoom level for tiles present in the set. |
|
Returns the minimum zoom level for tiles present in the set. |
|
Returns the root tile matrix (usually corresponding to zoom level 0). |
|
Calculates the correct scale to use for the tiles when rendered using the specified render context. |
|
Returns the scale to tile zoom method. |
|
Calculates a fractional zoom level given a map scale denominator. |
|
Finds the best fitting (integer) zoom level given a map scale denominator. |
|
Sets the root tile matrix (usually corresponding to zoom level 0). |
|
Sets the scale to tile zoom method. |
|
Returns the availability of the given tile in this matrix. |
|
Returns the tile matrix corresponding to the specified zoom. |
|
Returns a list of tiles in the given tile range. |
Virtual Methods
In PyQGIS, only methods marked as virtual
can be safely overridden in a Python subclass of QgsTileMatrixSet. See the FAQ for more details.
Reads the set from an XML element. |
|
Writes the set to an XML element. |
- class qgis.core.QgsTileMatrixSet[source]¶
Bases:
object
- addGoogleCrs84QuadTiles(self, minimumZoom: int = 0, maximumZoom: int = 14)[source]¶
Adds tile matrices corresponding to the standard web mercator/GoogleCRS84Quad setup.
- Parameters:
minimumZoom (int = 0)
maximumZoom (int = 14)
- addMatrix(self, matrix: QgsTileMatrix)[source]¶
Adds a
matrix
to the set.Any existing matrix with the same
QgsTileMatrix.zoomLevel()
will be replaced.- Parameters:
matrix (QgsTileMatrix)
- calculateTileScaleForMap(self, actualMapScale: float, mapCrs: QgsCoordinateReferenceSystem, mapExtent: QgsRectangle, mapSize: QSize, mapDpi: float) float [source]¶
Calculates the correct scale to use for the tiles when rendered using the specified map properties.
Added in version 3.26.
- Parameters:
actualMapScale (float)
mapCrs (QgsCoordinateReferenceSystem)
mapExtent (QgsRectangle)
mapSize (QSize)
mapDpi (float)
- Return type:
float
- crs(self) QgsCoordinateReferenceSystem [source]¶
Returns the coordinate reference system associated with the tiles.
In the case of a tile set containing mixed CRS at different zoom levels this method will return the crs of the minimum zoom tile matrix.
- Return type:
- dropMatricesOutsideZoomRange(self, minimumZoom: int, maximumZoom: int)[source]¶
Deletes any existing matrices which fall outside the zoom range specified by
minimumZoom
tomaximumZoom
, inclusive.- Parameters:
minimumZoom (int)
maximumZoom (int)
- maximumZoom(self) int [source]¶
Returns the maximum zoom level for tiles present in the set.
See also
- Return type:
int
- minimumZoom(self) int [source]¶
Returns the minimum zoom level for tiles present in the set.
See also
- Return type:
int
- virtual readXml(self, element: QDomElement, context: QgsReadWriteContext) bool [source]¶
Reads the set from an XML
element
.See also
- Parameters:
element (QDomElement)
context (QgsReadWriteContext)
- Return type:
bool
- rootMatrix(self) QgsTileMatrix [source]¶
Returns the root tile matrix (usually corresponding to zoom level 0).
Added in version 3.28.
- Return type:
- scaleForRenderContext(self, context: QgsRenderContext) float [source]¶
Calculates the correct scale to use for the tiles when rendered using the specified render
context
.Added in version 3.26.
- Parameters:
context (QgsRenderContext)
- Return type:
float
- scaleToTileZoomMethod(self) Qgis.ScaleToTileZoomLevelMethod [source]¶
Returns the scale to tile zoom method.
See also
- Return type:
- scaleToZoom(self, scale: float) float [source]¶
Calculates a fractional zoom level given a map
scale
denominator.The zoom level will be linearly interpolated between zoom levels present in the set.
- Parameters:
scale (float)
- Return type:
float
- scaleToZoomLevel(self, scale: float, clamp: bool = True) int [source]¶
Finds the best fitting (integer) zoom level given a map
scale
denominator. An optionalclamp
parameter can be set toFalse
to disable clamping zoom level to the tile matrix set’s minimum and maximum zoom level.Values are constrained to the zoom levels between
minimumZoom()
andmaximumZoom()
.- Parameters:
scale (float)
clamp (bool = True)
- Return type:
int
- setRootMatrix(self, matrix: QgsTileMatrix)[source]¶
Sets the root tile
matrix
(usually corresponding to zoom level 0).Added in version 3.28.
- Parameters:
matrix (QgsTileMatrix)
- setScaleToTileZoomMethod(self, method: Qgis.ScaleToTileZoomLevelMethod)[source]¶
Sets the scale to tile zoom method.
See also
- Parameters:
method (Qgis.ScaleToTileZoomLevelMethod)
- tileAvailability(self, id: QgsTileXYZ) Qgis.TileAvailability [source]¶
Returns the availability of the given tile in this matrix.
This method can be used to determine whether a particular tile actually exists within the matrix, or is not available (e.g. due to holes within the matrix).
This method returns
Qgis
.TileAvailability.Available by default, unless specific tile availability is known for the givenid
.Added in version 3.32.
- Parameters:
id (QgsTileXYZ)
- Return type:
- tileMatrix(self, zoom: int) QgsTileMatrix [source]¶
Returns the tile matrix corresponding to the specified
zoom
.- Parameters:
zoom (int)
- Return type:
- tilesInRange(self, range: QgsTileRange, zoomLevel: int) List[QgsTileXYZ] ¶
Returns a list of tiles in the given tile range.
Added in version 3.32.
- Parameters:
range (QgsTileRange)
zoomLevel (int)
- Return type:
List[QgsTileXYZ]
- virtual writeXml(self, document: QDomDocument, context: QgsReadWriteContext) QDomElement [source]¶
Writes the set to an XML element.
- Parameters:
document (QDomDocument)
context (QgsReadWriteContext)
- Return type:
QDomElement