Class: QgsTileMatrix

class qgis.core.QgsTileMatrix

Bases: sip.wrapper

Defines a matrix of tiles for a single zoom level: it is defined by its size (width * brief height) and map extent that it covers.

Please note that we follow the XYZ convention of X/Y axes, i.e. top-left tile has [0,0] coordinate (which is different from TMS convention where bottom-left tile has [0,0] coordinate).

New in version 3.14:

Methods

extent

Returns extent of the tile matrix

fromWebMercator

Returns a tile matrix for the usual web mercator

mapToTileCoordinates

Returns row/column coordinates (floating point number) from the given point in map coordinates

matrixHeight

Returns number of rows of the tile matrix

matrixWidth

Returns number of columns of the tile matrix

scale

Returns scale denominator of the tile matrix

tileCenter

Returns center of the given tile in this matrix

tileExtent

Returns extent of the given tile in this matrix

tileRangeFromExtent

Returns tile range that fully covers the given extent

zoomLevel

Returns zoom level of the tile matrix

extent(self) QgsRectangle

Returns extent of the tile matrix

Return type

QgsRectangle

fromWebMercator(mZoomLevel: int) QgsTileMatrix

Returns a tile matrix for the usual web mercator

Parameters

mZoomLevel (int) –

Return type

QgsTileMatrix

mapToTileCoordinates(self, mapPoint: QgsPointXY) QPointF

Returns row/column coordinates (floating point number) from the given point in map coordinates

Parameters

mapPoint (QgsPointXY) –

Return type

QPointF

matrixHeight(self) int

Returns number of rows of the tile matrix

Return type

int

matrixWidth(self) int

Returns number of columns of the tile matrix

Return type

int

scale(self) float

Returns scale denominator of the tile matrix

Return type

float

tileCenter(self, id: QgsTileXYZ) QgsPointXY

Returns center of the given tile in this matrix

Parameters

id (QgsTileXYZ) –

Return type

QgsPointXY

tileExtent(self, id: QgsTileXYZ) QgsRectangle

Returns extent of the given tile in this matrix

Parameters

id (QgsTileXYZ) –

Return type

QgsRectangle

tileRangeFromExtent(self, mExtent: QgsRectangle) QgsTileRange

Returns tile range that fully covers the given extent

Parameters

mExtent (QgsRectangle) –

Return type

QgsTileRange

zoomLevel(self) int

Returns zoom level of the tile matrix

Return type

int