hcmap {highcharter}

Shortcut for create map from https://code.highcharts.com/mapdata/ collection.

Description

Shortcut for create map from https://code.highcharts.com/mapdata/ collection.

Usage

hcmap(
  map = "custom/world",
  download_map_data = getOption("highcharter.download_map_data"),
  data = NULL,
  value = NULL,
  joinBy = NULL,
  ...
)

Arguments

map

String indicating what map to chart, a list from https://code.highcharts.com/mapdata/. See examples.

download_map_data

A logical value whether to download (add as a dependency) the map. Default TRUE via getOption("highcharter.download_map_data").

data

Optional data to make a choropleth, in case of use the joinBy and value are needed.

value

A string value with the name of the variable to chart.

joinBy

What property to join the map and df.

...

Additional shared arguments for the data series (https://api.highcharts.com/highcharts/series).

Examples

options(highcharter.download_map_data = TRUE)

# hcmap(nullColor = "#DADADA")
# hcmap(nullColor = "#DADADA", download_map_data = FALSE)

require(dplyr)
data("USArrests", package = "datasets")
USArrests <- mutate(USArrests, "woe-name" = rownames(USArrests))

# hcmap(
#   map = "countries/us/us-all", data = USArrests,
#   joinBy = "woe-name", value = "UrbanPop", name = "Urban Population"
# )

# download_map_data = FALSE
# hcmap(
#    map = "countries/us/us-all", data = USArrests,
#   joinBy = "woe-name", value = "UrbanPop", name = "Urban Population",
#   download_map_data = FALSE
# )