Specifies icons from a png images, which can be used as markers in thematic maps.
The function marker_icon()
is the specification of the default marker.
tmap_icons(
file,
names = NULL,
width = 48,
height = 48,
keep.asp = TRUE,
just = c("center", "center"),
merge = NA,
as.local = TRUE,
...
)marker_icon()
icon data (see leaflet::icons()
)
character value/vector containing the file path(s) or url(s).
names to be given to the icons. Useful when icons are assigned to factor levels.
width of the icon. If keep.asp
, this is interpreted as the maximum width.
height of the icon. If keep.asp
, this is interpreted as the maximum height.
keep the aspect ratio of the png image. If TRUE
and the aspect
ratio differs from width/height
, either width
or height
is adjusted accordingly.
justification of the icons relative to the point coordinates.
The first value specifies horizontal and the second value vertical justification.
Possible values are: "left"
, "right"
, "center"
, "bottom"
, and "top"
.
Numeric values of 0 specify left alignment and 1 right alignment.
The default value of just
is c("center", "center")
.
merge icons to one icon list (see return value)? If FALSE
, a list is created per file. By default TRUE
, unless names
are specified.
if the file
is a url, should it be saved to local temporary file?
arguments passed on to leaflet::icons()
.
When iconWidth
, iconHeight
, iconAnchorX
, and iconAnchorY
are specified,
they override width
and height
, and just
.
tm_symbols()