leaflet 2.0.0
leaflet 2.0.0 is now on CRAN!
The leaflet R package wraps the Leaflet.js JavaScript library, and this release of the R package marks a major upgrade from the outdated Leaflet.js 0.7.x to the current Leaflet.js 1.x (specifically, 1.3.1).
Leaflet.js 1.x includes some non-backward-compatible API changes versus 0.7.x. If you’re using only R code to create your Leaflet maps, these changes should not affect you. If you are using custom JavaScript, some changes may be required to your code. Please see the Leaflet.js reference documentation and changelog.
Big thanks to @timelyportfolio and Bhaskar Karambelkar for their significant contributions to this release!
leaflet.extras and leaflet.esri
Two additional packages by Bhaskar, leaflet.extras and leaflet.esri, have been updated on CRAN to utilize the latest Leaflet.js library bindings. leaflet.extras extends the Leaflet R package using various Leaflet.js plugins, offering features like heatmaps, additional marker icons, and drawing tools. leaflet.esri provides access to ArcGIS services, based on the ESRI leaflet plugin.
library(leaflet)
library(leaflet.extras)
leaflet(quakes) %>%
addTiles() %>%
addHeatmap(lng = ~long, lat = ~lat, radius = 8)Full changelog
Breaking Changes
- Update to latest Leaflet.js 1.x (v1.3.1). Please see the Leaflet.js reference documentation and change log.
- Previously, labels were implemented using the 3rd party extension Leaflet.label. Leaflet.js 1.x now provides this functionality naively. There are some minor differences to note:
- If you are using custom JavaScript to create labels, you’ll need to change references to
L.LabeltoL.Tooltip. - Tooltips are now displayed with default Leaflet.js styling.
- In custom javascript extensions, change all
*.bindLabel()to*.bindTooltip(). - All Leaflet.js plugins updated to versions compatible with Leaflet.js 1.x.
Known Issues
- The default CSS z-index of the Leaflet map has changed; for some Shiny applications, the map now covers elements that are intended to be displayed on top of the map. This issue has been fixed on GitHub (
devtools::install_github("rstudio/leaflet")). For now, you can work around this in the CRAN version by including this line in your application UI:
tags$style(".leaflet-map-pane { z-index: auto; }")Features
- Added more providers for
addProviderTiles(): OpenStreetMap.CH, OpenInfraMap, OpenInfraMap.Power, OpenInfraMap.Telecom, OpenInfraMap.Petroleum, OpenInfraMap.Water, OpenPtMap, OpenRailwayMap, OpenFireMap, SafeCast. - Add
groupOptionsfunction. Currently the only option is letting you specify zoom levels at which a group should be visible. - Added support for drag events.
- Added
methodargument toaddRasterImage()to enable nearest neighbor interpolation when projecting categorical rasters. - Added an
'auto'method foraddRasterImage(). Projected factor results are coerced into factors. - Added
dataparameter to remainingaddXXX()methods, including addLegend. - Added
preferCanvasargument toleafletOptions(). ### Bug Fixes and Improvements - Relative protocols are used where possible when adding tiles. In RStudio 1.1.x on linux and windows, a known issue of ‘https://’ routes fail to load, but works within browsers (rstudio/rstudio#2661).
L.multiPolylinewas absorbed intoL.polyline, which also accepts an array of polyline information.- Fixed bug where icons were anchored to the top-center by default, not center-center.
- Fixed bug where markers would not appear in self contained knitr files.
L.Labelis nowL.tooltipin Leaflet.js.labelOptions()now translates old optionsclickabletointeractiveandnoHidetopermanent.- Fix a bug where the default
addTiles()would not work with .html files served directly from the filesystem. - Fix bug with accessing columns in formulas when the data source is a Crosstalk SharedData object wrapping a spatial data frame or sf object.
- Fix strange wrapping behavior for legend, especially common for Chrome when browser zoom level is not 100%.
- Fix incorrect opacity on NA entry in legend.
- Ensure type safety of
.indexOf(stamp). validateCoords()warns on invalid polygon data.
