bokeh.models.tiles

class BBoxTileSource(**kwargs)

Bases: bokeh.models.tiles.MercatorTileSource

The BBoxTileSource has the same default tile origin as the WMTSTileSource but requested tiles use a {XMIN}, {YMIN}, {XMAX}, {YMAX} e.g. http://your.custom.tile.service?bbox={XMIN},{YMIN},{XMAX},{YMAX}.

use_latlon

property type: use_latlon:Bool

Flag which indicates option to output {XMIN},{YMIN},{XMAX},{YMAX} in meters or latitude and longitude.

JSON Prototype
{
  "attribution": "",
  "extra_url_vars": {},
  "id": "5b9ec37b-0b60-45c5-8ca5-8d3d6103a2df",
  "initial_resolution": 156543.03392804097,
  "max_zoom": 30,
  "min_zoom": 0,
  "name": null,
  "tags": [],
  "tile_size": 256,
  "url": "",
  "use_latlon": false,
  "wrap_around": true,
  "x_origin_offset": 20037508.34,
  "y_origin_offset": 20037508.34
}
class MercatorTileSource(**kwargs)

Bases: bokeh.models.tiles.TileSource

MercatorTileSource is not generally useful to instantiate on its own, but is the parent class of mercator tile services (e.g. WMTSTileSource).

wrap_around

property type: wrap_around:Bool

Enables continuous horizontal panning by wrapping the x-axis based on bounds of map. Note that axis coordinates are not wrapped. To toggle axis label visibility, use plot.axis.visible = False.

JSON Prototype
{
  "attribution": "",
  "extra_url_vars": {},
  "id": "cc04b4ea-473a-4811-917b-a2eeca3e8896",
  "initial_resolution": 156543.03392804097,
  "max_zoom": 30,
  "min_zoom": 0,
  "name": null,
  "tags": [],
  "tile_size": 256,
  "url": "",
  "wrap_around": true,
  "x_origin_offset": 20037508.34,
  "y_origin_offset": 20037508.34
}
class QUADKEYTileSource(**kwargs)

Bases: bokeh.models.tiles.MercatorTileSource

The QUADKEYTileSource has the same tile origin as the WMTSTileSource but requests tiles using a quadkey argument instead of X, Y, Z e.g. http://your.quadkey.tile.host/{Q}.png

JSON Prototype
{
  "attribution": "",
  "extra_url_vars": {},
  "id": "b674d684-2be8-4db6-89ce-704ee4518192",
  "initial_resolution": 156543.03392804097,
  "max_zoom": 30,
  "min_zoom": 0,
  "name": null,
  "tags": [],
  "tile_size": 256,
  "url": "",
  "wrap_around": true,
  "x_origin_offset": 20037508.34,
  "y_origin_offset": 20037508.34
}
class TMSTileSource(**kwargs)

Bases: bokeh.models.tiles.MercatorTileSource

The TMSTileSource contains tile config info and provides urls for tiles based on a templated url e.g. http://your.tms.server.host/{Z}/{X}/{Y}.png. The defining feature of TMS is the tile-origin in located at the bottom-left.

The TMSTileSource can also be helpful in implementing tile renderers for custom tile sets, including non-spatial datasets.

JSON Prototype
{
  "attribution": "",
  "extra_url_vars": {},
  "id": "5f4ad1b3-268a-49fb-9bf2-d522443c92a3",
  "initial_resolution": 156543.03392804097,
  "max_zoom": 30,
  "min_zoom": 0,
  "name": null,
  "tags": [],
  "tile_size": 256,
  "url": "",
  "wrap_around": true,
  "x_origin_offset": 20037508.34,
  "y_origin_offset": 20037508.34
}
class TileSource(**kwargs)

Bases: bokeh.model.Model

A base class for all tile source types. TileSource is not generally useful to instantiate on its own. In general, tile sources are used as a required input for TileRenderer.

Subclasses should have these properties as well: x_origin_offset = Float y_origin_offset = Float initial_resolution = Float
attribution

property type: attribution:String

Data provider attribution content. This can include HTML content.

extra_url_vars

property type: extra_url_vars:Dict(String, Any)

A dictionary that maps url variable template keys to values. These variables are useful for parts of tile urls which do not change from tile to tile (e.g. server host name, or layer name).

initial_resolution

property type: initial_resolution:Float

resolution (plot_units / pixels) of minimum zoom level of tileset projection. None to auto-compute.

max_zoom

property type: max_zoom:Int

the maximum zoom level for the tile layer. This is the most “zoomed-in” level.

min_zoom

property type: min_zoom:Int

the minimum zoom level for the tile layer. This is the most “zoomed-out” level.

tile_size

property type: tile_size:Int

tile size in pixels (e.g. 256)

url

property type: url:String

tile service url (example: http://c.tile.openstreetmap.org/{Z}/{X}/{Y}.png)

x_origin_offset

property type: x_origin_offset:Float

x offset in plot coordinates

y_origin_offset

property type: y_origin_offset:Float

y offset in plot coordinates

JSON Prototype
{
  "attribution": "",
  "extra_url_vars": {},
  "id": "a5f213fb-8945-4044-95ee-2e33a1cf9747",
  "initial_resolution": null,
  "max_zoom": 30,
  "min_zoom": 0,
  "name": null,
  "tags": [],
  "tile_size": 256,
  "url": "",
  "x_origin_offset": null,
  "y_origin_offset": null
}
class WMTSTileSource(**kwargs)

Bases: bokeh.models.tiles.MercatorTileSource

The WMTSTileSource behaves much like TMSTileSource but has its tile-origin in the top-left. This is the most common used tile source for web mapping applications. Such companies as Google, MapQuest, Stamen, Esri, and OpenStreetMap provide service which use the WMTS specification e.g. http://c.tile.openstreetmap.org/{Z}/{X}/{Y}.png.

JSON Prototype
{
  "attribution": "",
  "extra_url_vars": {},
  "id": "c91846de-4dea-408c-8a56-f3e4323b7909",
  "initial_resolution": 156543.03392804097,
  "max_zoom": 30,
  "min_zoom": 0,
  "name": null,
  "tags": [],
  "tile_size": 256,
  "url": "",
  "wrap_around": true,
  "x_origin_offset": 20037508.34,
  "y_origin_offset": 20037508.34
}