Tile Layer
Usage
add_tile_layer(
rdeck,
...,
id = uuid::UUIDgenerate(),
name = "TileLayer",
group_name = NULL,
data = NULL,
visible = TRUE,
pickable = FALSE,
opacity = 1,
wrap_longitude = FALSE,
position_format = "XY",
color_format = "RGBA",
auto_highlight = FALSE,
highlight_color = "#00008080",
get_tile_data = NULL,
extent = NULL,
tile_size = 512,
max_zoom = NULL,
min_zoom = 0,
max_cache_size = NULL,
max_cache_byte_size = NULL,
refinement_strategy = "best-available",
z_range = NULL,
max_requests = 6,
zoom_offset = 0,
blending_mode = "normal",
visibility_toggle = TRUE,
tooltip = NULL,
desaturate = 0,
transparent_color = "#00000000",
tint_color = "#ffffff"
)
update_tile_layer(
rdeck,
...,
id,
name = cur_value(),
group_name = cur_value(),
data = cur_value(),
visible = cur_value(),
pickable = cur_value(),
opacity = cur_value(),
wrap_longitude = cur_value(),
position_format = cur_value(),
color_format = cur_value(),
auto_highlight = cur_value(),
highlight_color = cur_value(),
get_tile_data = cur_value(),
extent = cur_value(),
tile_size = cur_value(),
max_zoom = cur_value(),
min_zoom = cur_value(),
max_cache_size = cur_value(),
max_cache_byte_size = cur_value(),
refinement_strategy = cur_value(),
z_range = cur_value(),
max_requests = cur_value(),
zoom_offset = cur_value(),
blending_mode = cur_value(),
visibility_toggle = cur_value(),
tooltip = cur_value(),
desaturate = cur_value(),
transparent_color = cur_value(),
tint_color = cur_value()
)
Arguments
- rdeck
<
rdeck
|rdeck_proxy
> An rdeck map instance.- ...
Additional parameters that will be forwarded to deck.gl javascript without validation nor processing. All dots must be named and will be
camelCased
when serialised. A warning is raised when dots are used, warning classrdeck_dots_nonempty
.- id
<
string
> The layer's identifier must be unique for among all layers of the same type for a map. Defaults touuid::UUIDgenerate()
, but should be explicitly defined for updatable layers in a shiny application.- name
<
string
> Identifies the layer on tooltips and legends. It does not need to be unique, but should be brief. Defaults to the deck.gl class name for the layer.- group_name
<
string
> Defines the group that this layer belongs to. Currently only effective on the layer selector, ifvisibility_toggle = TRUE
.- data
<
character
> A character vector of raster tile url templates. Substrings"{x}"
,"{y}"
,"{z}"
will be replaced with a tile's actual index on request.If multiple url templates are supplied, each endpoint must return the same data for the same tile index.
- visible
<
boolean
> Determines whether the layer is visible or not; also determines whether any legend elements for the layer will be displayed.- pickable
<
boolean
> Determines if the layer responds to pointer / touch events.- opacity
<
number
> Determines the layer's opacity.- wrap_longitude
<
boolean
> Normalises geometry longitudes.- position_format
<
"XY"
|"XYZ"
> Determines whether each coordinate has two (XY) or three (XYZ) elements.- color_format
<
"RGB"
|"RGBA"
> Determines whether the alpha channel of the colours will be ignored by accessors, making all colours opaque.- auto_highlight
<
boolean
> WhenTRUE
, the current object hovered by the cursor is highlighted byhighlight_color
.- highlight_color
<
accessor
|scale
|color
> Whenauto_highlight
andpickable
are enabled,highlight_color
determines the colour of the currently highlighted object. If a single colour value is supplied, that colour will be used to highlight all objects in the layer. Per-object highlighting is achieved with a colour scale, or a tidy-eval column of colours.- get_tile_data
<
JS
> retrieves the data of each tile. See deck.gl getTileData.- extent
<
c(min_x, min_y, max_x, max_y)
> Tiles in this bounding box will be rendered atmin_zoom
, when zoomed out belowmin_zoom
.- tile_size
<
number
> A power of 2 that is the pixel dimensions of the tile.- max_zoom
<
number
> Tiles above this zoom level are not shown. Defaults toNULL
.- min_zoom
<
number
> Tiles below this zoom level are not shown. Defaults to0
.- max_cache_size
<
number
> Maximum number of tiles that can be cached. Defaults to 5x the number of tiles in current viewport.- max_cache_byte_size
<
number
> Maximum memory used for caching tiles.- refinement_strategy
<
"best-available"
|"no-overlap"
|"never"
> How the tile layer refines visibility of tiles. Defaults to"best-available"
.- z_range
<
c(min, max)
> Array representing the range of heights in the tile.- max_requests
<
number
> Maximum number of concurrent HTTP requests across all specified tile provider domains. If a negative number is supplied no throttling occurs (HTTP/2 only).- zoom_offset
<
int
> The offset changes the zoom level at which the tiles are fetched.- blending_mode
<
"normal"
|"additive"
|"subtractive"
> Sets the blending mode. Blending modes:normal
: Normal blending doesn't alter colours of overlapping objects.additive
: Additive blending adds colours of overlapping objects. Useful for highlighting dot density on dark maps.subtractive
: Subtractive blending darkens overlapping objects. Useful for highlighting dot density on light maps.
- visibility_toggle
<
boolean
> Whether this layer will appear in the layer selector.- tooltip
<
tooltip
> Defines the columns (and their order) that will be displayed in the layer tooltip, ifpickable == TRUE
. Supports tidy-select if adata
is adata.frame
. Geometry columns are always removed.- desaturate
<
number
> The desaturation of the bitmap. Between0
and1
,being
the original colour,1
being greyscale.- transparent_color
<
color
> The colour to use for transparent pixels.- tint_color
<
color
> The colour to tint the bitmap by. Alpha channel is ignored if supplied.
See also
https://github.com/visgl/deck.gl/blob/8.7-release/docs/api-reference/geo-layers/tile-layer.md
Other geo-layers:
great_circle_layer
,
h3_cluster_layer
,
h3_hexagon_layer
,
mvt_layer
,
quadkey_layer
,
s2_layer
,
terrain_layer
,
tile_3d_layer
,
trips_layer
Other layers:
arc_layer
,
bitmap_layer
,
column_layer
,
contour_layer
,
cpu_grid_layer
,
geojson_layer
,
gpu_grid_layer
,
great_circle_layer
,
grid_cell_layer
,
grid_layer
,
h3_cluster_layer
,
h3_hexagon_layer
,
heatmap_layer
,
hexagon_layer
,
icon_layer
,
line_layer
,
mvt_layer
,
path_layer
,
point_cloud_layer
,
polygon_layer
,
quadkey_layer
,
s2_layer
,
scatterplot_layer
,
scenegraph_layer
,
screen_grid_layer
,
simple_mesh_layer
,
solid_polygon_layer
,
terrain_layer
,
text_layer
,
tile_3d_layer
,
trips_layer