OpenLayers 3

Class: TileGrid

ol.tilegrid.TileGrid

Base class for setting the grid pattern for sources accessing tiled-image servers.

new ol.tilegrid.TileGrid(options)

src/ol/tilegrid/tilegrid.js, line 34
Name Type Description
options

Tile grid options.

Name Type Description
extent ol.Extent | undefined experimental

Extent for the tile grid. No tiles outside this extent will be requested by ol.source.Tile sources. When no origin or origins are configured, the origin will be set to the bottom-left corner of the extent. When no sizes are configured, they will be calculated from the extent.
minZoom number | undefined experimental

Minimum zoom. Default is 0.
origin ol.Coordinate | undefined

Origin, i.e. the bottom-left corner of the grid. Default is null.
origins Array.<ol.Coordinate> | undefined

Origins, i.e. the bottom-left corners of the grid for each zoom level. If given, the array length should match the length of the resolutions array, i.e. each resolution can have a different origin.
resolutions Array.<number>

Resolutions. The array index of each resolution needs to match the zoom level. This means that even if a minZoom is configured, the resolutions array will have a length of maxZoom + 1.
tileSize number | ol.Size | undefined

Tile size. Default is [256, 256].
tileSizes Array.<(number|ol.Size)> | undefined

Tile sizes. If given, the array length should match the length of the resolutions array, i.e. each resolution can have a different tile size.

Subclasses

Members

createTileCoordTransform experimental

Creates a TileCoord transform function for use with this tile grid. Transforms the internal tile coordinates with bottom-left origin to the tile coordinates used by the ol.TileUrlFunction. The returned function expects an ol.TileCoord as first and an ol.proj.Projection as second argument and returns a transformed ol.TileCoord.

Methods

getMaxZoom(){number} experimental

src/ol/tilegrid/tilegrid.js, line 214

Get the maximum zoom level for the grid.

Returns:
Max zoom.

getMinZoom(){number} experimental

src/ol/tilegrid/tilegrid.js, line 224

Get the minimum zoom level for the grid.

Returns:
Min zoom.

getOrigin(z){ol.Coordinate}

src/ol/tilegrid/tilegrid.js, line 235

Get the origin for the grid at the given zoom level.

Name Type Description
z number

Z.
Returns:
Origin.

getResolution(z){number}

src/ol/tilegrid/tilegrid.js, line 255

Get the resolution for the given zoom level.

Name Type Description
z number

Z.
Returns:
Resolution.

getResolutions(){Array.<number>}

src/ol/tilegrid/tilegrid.js, line 268

Get the list of resolutions for the tile grid.

Returns:
Resolutions.

getTileCoordForCoordAndResolution(coordinate, resolution, opt_tileCoord){ol.TileCoord} experimental

src/ol/tilegrid/tilegrid.js, line 388

Get the tile coordinate for the given map coordinate and resolution. This method considers that coordinates that intersect tile boundaries should be assigned the higher tile coordinate.

Name Type Description
coordinate ol.Coordinate

Coordinate.
resolution number

Resolution.
tileCoord ol.TileCoord

Destination ol.TileCoord object.
Returns:
Tile coordinate.

getTileCoordForCoordAndZ(coordinate, z, opt_tileCoord){ol.TileCoord} experimental

src/ol/tilegrid/tilegrid.js, line 439

Get a tile coordinate given a map coordinate and zoom level.

Name Type Description
coordinate ol.Coordinate

Coordinate.
z number

Zoom level.
tileCoord ol.TileCoord

Destination ol.TileCoord object.
Returns:
Tile coordinate.

getTileSize(z){number|ol.Size}

src/ol/tilegrid/tilegrid.js, line 468

Get the tile size for a zoom level. The type of the return value matches the tileSize or tileSizes that the tile grid was configured with. To always get an ol.Size, run the result through ol.size.toSize().

Name Type Description
z number

Z.
Returns:
Tile size.