Adds a rectangle to a google map
add_rectangles(map, data = get_map_data(map), north, east, south, west,
id = NULL, draggable = NULL, editable = NULL, stroke_colour = NULL,
stroke_opacity = NULL, stroke_weight = NULL, fill_colour = NULL,
fill_opacity = NULL, mouse_over = NULL, mouse_over_group = NULL,
info_window = NULL, layer_id = NULL, update_map_view = TRUE,
z_index = NULL, digits = 4, palette = NULL, legend = F,
legend_options = NULL, load_interval = 0, focus_layer = FALSE)
a googleway map object created from google_map()
data frame containing the bounds for the rectangles
String specifying the column of data
that contains the
northern most latitude coordinate
String specifying the column of data
that contains the
eastern most longitude
String specifying the column of data
that contains the
southern most latitude coordinate
String specifying the column of data
that contains the
western most longitude
string specifying the column containing an identifier for a shape
string specifying the column of data
defining if
the polygon is 'draggable'. The column of data should be logical (either TRUE or FALSE)
String specifying the column of data
that indicates if the
rectangle is editable. The value in the column should be logical
either a string specifying the column of data
containing
the stroke colour of each shape, or a valid hexadecimal numeric HTML style to
be applied to all the shapes
either a string specifying the column of data
containing
the stroke opacity of each shape, or a value between 0 and 1 that will be
applied to all the shapes
either a string specifying the column of data
containing
the stroke weight of each shape, or a number indicating the width of pixels
in the line to be applied to all the shapes
either a string specifying the column of data
containing
the fill colour of each shape, or a valid hexadecimal numeric HTML style to
be applied to all the shapes
either a string specifying the column of data
containing
the fill opacity of each shape, or a value between 0 and 1 that will be applied
to all the shapes
string specifying the column of data to display when the mouse rolls over the shape
string specifying the column of data specifying which groups of shapes to highlight on mouseover
string specifying the column of data to display in an info window when a shape is clicked.
single value specifying an id for the layer. Use this value to
distinguish between shape layers for when using any update_
function, and
for separating legends.
logical specifying if the map should re-centre according to the shapes
single value specifying where the circles appear in the layering
of the map objects. Layers with a higher z_index
appear on top of those with
a lower z_index
. See details.
integer. Use this parameter to specify how many digits (decimal places) should be used for the latitude / longitude coordinates.
a function, or list of functions, that generates hex colours given a single number as an input. See details.
either a logical indiciating if the legend(s) should be displayed, or a named list indicating which colour attributes should be included in the legend.
A list of options for controlling the legend.
time in miliseconds to wait between plotting each shape
logical indicating if the map should re-centre according to this layer
The palette
is used to specify the colours that will map to variables.
You can specify a single function to map to all variables, or a named list
that specifies a separate function to map to each variable. The elements must
be named either fill_colour
or stroke_colour
, and their values
are the colour generating functions. The default is viridisLite::viridis
The legend_options
can be used to control the appearance of the legend.
This should be a named list, where the names are one of
position - one of c("TOP_LEFT", "TOP_CENTER", "TOP_RIGHT", "RIGHT_TOP",
"RIGHT_CENTER", "RIGHT_BOTTOM", "BOTTOM_RIGHT", "BOTTOM_CENTER", "BOTTOM_LEFT",
"LEFT_BOTTOM", "LEFT_CENTER", "LEFT_TOP")
css - a string of valid css
for controlling the appearance of the legend
title - a string to use for the title of the legend
if legend_options
are NULL, the default values will apply
If you are displaying two legends, one for stroke_colour
and one
for fill_colour
, you can specify different options for the different
colour attributes. See examples for add_circles.
z_index
values define the order in which objects appear on the map.
Those with a higher value appear on top of those with a lower value. The default
order of objects is (1 being underneath all other objects)
1. Polygon
2. Rectangle
3. Polyline
4. Circle
Markers are always the top layer
# NOT RUN {
map_key <- 'your_api_key'
df <- data.frame(north = 33.685, south = 33.671, east = -116.234, west = -116.251)
google_map(key = map_key) %>%
add_rectangles(data = df, north = 'north', south = 'south',
east = 'east', west = 'west')
## editable rectangle
df <- data.frame(north = -37.8459, south = -37.8508, east = 144.9378,
west = 144.9236, editable = T, draggable = T)
google_map(key = map_key) %>%
add_rectangles(data = df, north = 'north', south = 'south',
east = 'east', west = 'west',
editable = 'editable', draggable = 'draggable')
# }
Run the code above in your browser using DataLab