NEWS

---

mapview 2.11.2.9000

✨ features and improvements

🐛 bug fixes

💬 documentation etc

🍬 miscellaneous

mapview 2.11.2 (2023-10-13)

🍬 miscellaneous

• removed retired package rgdal. #446

mapview 2.11.1

✨ features and improvements

• added mapshot2() which uses webshot2 package for screenshots.

🐛 bug fixes

• when burst = TRUE popups were not correct. #396 & #408
  • recreated data crs with sf::st_crs() to avoid warnings ('old-style crs object detected; please recreate object with a recent sf::st_crs()'). #411
  • RasterBrick method now returns correct @object slot.

mapview 2.10.4

new features:

• all methods now have a hide argument to hide layers at the first render.

mapview 2.10.3

new features:

• use interpolated numeric legend also if number of unique values <= 11. #389

bugfixes:

• stars image now renders correctly if supplying only a few colors. #388
• data now appears in maps when using default settings with VSCode R extension.

mapview 2.10.0

new features:

• new implementation of print method to make mapview with flatgeobuf work outside RStudio.
• auto setting of mapviewOptions(fgb = TRUE) at load only if not in knitr, notebook. https://twitter.com/TimSalabim3/status/1337714868925980674
• new option basemaps.color.shuffle to control if basemaps should automatically adjust to colors of overlays (i.e. use black basemap as default for very light colors). #377

miscellaneous:

• use tinytest for testing
• mapviewGetOption() is now vectorised.

bugfixes:

• rmd files did not compile due to missing popup.css #312
• method for RasterStackBrick now respects query.digits option. #334
• don't emit warning when length(at) == length(color). #327
• alpha.regions now respected if burst = TRUE. #352
• printing in rmarkdown notebooks works now if fgb & georaster options are FALSE. #351
• setting options("OutDec" = ",") does not cause an error anymore. #353
• factor legends now displayed correctly (hopefully). #362 #356
• re-enabled hidden argument hide to hide all but the first layer of a RasterStackBrick. #374
• custom layer names now respected when rendering lists (if same length). #383

mapview 2.9.0

new features:

• new function removeMapJunk to remove control elements from a map (e.g. the zoom control).
• added tentative support for platform 'leafgl'.
• stars method now uses leafem::addGeoRaster. https://github.com/r-spatial/leafem/issues/25
• leafem::addCopyExtent now included in all methods.
• sf(c) methods now use leafem::addFgb if GDAL >= 3.1.
• new | operator to compare two maps side-by-side.

miscellaneous:

• all deprecated functions are now defunct. See ?mapview-defunct.
• drop viridisLite dependency and use base::hcl.colors instead. We now depend on R >= 3.6.

mapview 2.7.8

new features:

• new method for tiled image collections (created with e.g. gdal2tiles). #222
• new method file path (currently vector only) without loading into R.
• initial support for 'mapdeck' as a rendering platform.
• mapshot now works for all and any htmlwidget.
• new functions startWatching/stopWatching to automatically mapview all spatial objects in a given environment (default .GlobalEnv).

miscellaneous:

• deprecated addStarsImage - now in package leafem. Thanks to Luigi Ranghetti #230
• deprecated addExtent - now in package leafem. Thanks to Lorenzo Busetto #233
• dropped Rcpp dependency.

bugfixes:

• factor legends should now work as expected. #240

mapview 2.7.0

miscellaneous:

• addMouseCoordinates now also displays native coordinates for leaflet maps. #205 - now moved to package leafem.
• deprecated slideview, cubeview, latticeview & sync, plainview, popup* functions.
• deprecated addFeatures, garnishMap, addHomeButton, addImageQuery, addLogo, addMouseCoordinates.

bugfixes:

• mapview would return NULL if zcol was of type logic. #200

mapview 2.6.3

miscellaneous:

• argument popup now also accepts FALSE in addition to NULL to suppress popups.
• plainview argument legend now accepts a list describing the colorkey (see ?lattice::levelplot for details). #187
• mapview popup css now has white background (for better leaflet integration).
• NAMESPACE now registers S3method (knitr::knit_print) conditionally as requested by KH.

mapview 2.6.0

new features:

• mapview has gained argument viewer.suppress to enable rendering in the browser.
• popupTable has gained argument feature.id to choose whether to show or hide 'Feature ID' column. #182

bugfixes:

• isFALSE (caused errors on R < 3.5) is now handled properly.
• mapshot does not unintentionally delete url anymore if saving to png with same name.
• mapshot now properly deletes temporary url when saving to png (or png and html).
• internal function mapview:::nrings now calculates number of polygon rings correctly. #181

mapview 2.5.0

new features:

• addMouseCoordinates now displays basic info by default. Detailed info can be accessed by holding Ctrl keyboard button which also copies lon, lat and zoom info to the clipboard when Ctrl + clicking on the map. #113
• npts has gained argument by_feature to count the number of vertices for each feature individually. #155
• canvas now auto-detected based on feature complexity.
• layer.name is now cut at 50 characters which used to be especially problematic for dplyr chains inside a mapview call. Fixes #159
• added '+' method for RHS class NULL. https://twitter.com/TimSalabim3/status/1012213914262794240
• popupImage has gained argument embed to specify whether local images should be embeded as base64 in the popup html. #168
• stars methods re-enabled since now on CRAN.
• added viewRGB method for stars images.

bugfixes:

• leaflet::addScalebar would prevent Raster* method from rendering correctly for multiple layers.
• cex was not respected when burst = TRUE. #149
• popupTable no longer causes a stack overflow with large point data. #154
• popupGraph no longer relies on png files on disk but embeds graphs via base64. #156
• in mapshot, remove temporary url files only if remove_url = TRUE. #157
• removeMouseCoordinates should work properly now (also exported). #145
• home button for single point now zooms to maximum zoom 18.

miscellaneous:

• dropped gdalUtils from Imports. gdalinfo and gdal_translate now used via sf.
• addMapPane has been migrated to leaflet.
• legend now TRUE by default as all legends are now linked to layers.
• better error messages in some cases (e.g. missing zcol, empty objects).
• package now depends on leaflet >= 1.0.0
• highlight now also accepts FALSE in addition to NULL to stop highlighting.

mapview 2.4.0

new features:

• addImageQuery has gained argument prefix to modify the layerId prefix.
• mapview methods for raster data have gained arguments label, query.type, query.digits, query.position and query.prefix to modify raster value query settings. https://twitter.com/pierreroudier/status/958476875344392193
• popupTable now right aligns values.
• Thanks to Pierre Roudier quantile strectching in viewRGB can now be turned off by simply setting to NULL. #127
• mapshot has gained argument remove_controls to remove map junk when saving to image file format.
• mapview method for data.frame has gained argument crs to enable rendering on a basemap #138
• updated to work with leaflet 2.0.0 #129 (incl. deprecation of previously used large methods)
• new function addMapPane to enable control over layer order.
• mapview has gained argument pane as it now uses addMapPane to ensure points overlay lines overlay polygons.
• mapview has gained argument canvas to enable canvas rendering.

bugfixes:

• viewRGB failed because of missing method argument. #125
• combineExtent didn't check properly for crs and failed for raster images.

mapview 2.3.0

new features:

• popupTable has gained argument row.numbers to disable row numbers. #109
• new function addStarsImage to visualise stars images.
• new function addImageQuery to provide raster/stars value query on mouseover/click.
• mapview has gained new argument method to specify the method used for resampling of raster data. #123

bugfixes:

• raster method with native.crs = TRUE did throw an error on windows. #111
• SpatialPixelsDataFrame and SpatialGridDataFrame failed because of missing map argument.
• example for multiple popupImages was broken. #118
• SpatialPixelsDataFrame failed when zcol was supplied. #124

misc:

• added more details in description field as per request of Uwe Ligges.
• moved leaflet from Depends to Imports.

mapview 2.2.0

new features:

• if supported by the installed leaflet version, legends are now automatically linked to layers.
• simple features with XYZ, XYM or XYZM geometries are now supported.
• added function addExtent to add rectangles showing bbox/extent/outline of sf/sp/raster objects.
• more concise internal recursive method dispatch.
• if multiple layers are plotted (via "+") initial zoom is now on global extent and a "Zoom full" button is added to the map at the bottom left of the map to re-zoom to this global extent.
• we now have mapview method for class 'data.frame' which enables interactive scatter plots.
• we now have mapview method for class 'numeric' which enables interactive plots of a numeric variable.
• updated slideView to accommodate more than one incident in a flexdashboard #95
• if supplied data has only one attribute/field column mapview will now colour the plot automatically according to that attribute/field.
• new mapview method for class 'bbox' -> mapview(st_bbox(x)) is equivalent to viewExtent(x)
• plainview now provides mouse coordinates

enhancements:

• added testthat suite of functions.
• increased performance when using "+"-method (about 10x faster now).

bugfixes:

• manifold bug fixes - addressing issues with list layers, alpha channel and many more.

mapview 2.1.4

new features:

• popupImage now accepts more than one file name (list or vector) in argument img.

bugfixes:

• na.alpha caused list/burst methods to fail.
• legend did not work when zcol only had one unique value. This was actually a delibarate choice as for a single map it doesn't really make sense to have a legend for only one color. However, for latticeView/sync this does actually make sense, hence re-enabled.

mapview 2.1.0

new features:

• plainview/cubeview now respects/has gained argument na.color.
• mapview now supports st_GEOMETRY with truely mixed feature types (e.g. LINESTRING and POLYGON) - fixes #85
• addFeatures: one function to add them all. Type agnostic version of leaflet::add* functions for simple features objects.
• mapview (for vector data only) has gained argument na.alpha to control opacity of missing values.

bugfixes:

• deleted obsolete data.table import.
• fixed #79: colnames of popupTables are now converted to utf-8.
• fixed #78: respect explicit setting of 'layer.name' argument.
• included NEWS file as R-help doesn't render NEWS.md
• highlight now respects alpha/alpha.regions = 0

mapview 2.0.1

new features:

• addMouseCoordinates has gained argument 'style' to specify whether to show 'basic' (lat, lon, zoom) or 'detailed' (x, y, epsg, proj4, lat, lon, zoom) information. Factory-fresh default is 'detailed'.

• addLogo has gained argument 'alpha' to set the opacity of the image.

• Someone draws quickest...

• added new method for list of objects so that we can do mapview(list(x, y, z)) which is great for computational outputs such as lapply.

• slideView has gained arguments 'label1' and 'label2' to supply slider names for the respective images, img1 and img2.

• new popup layout (making more use of the space available).

• added new function addLargeFeatures to render large datasets of up to ~100k features which is used automatically. To lower/elevate the threshold use maxpoints = ... (See ?mapview for details).

• mapview methods for all basic sf classes (XY/sfg, sfc, sf)

• added support for sf to "+"

• we can now render features/objects with arbitrary CRS (without map background) by setting 'native.crs = TRUE'.

• mapview will now decide which default base map to use based on average luminence of rendered colors.

• mapview now provides subtle highlighting of polygons (changing opacity slightly) and lines (changing thickness).

• plainView, slideView and cubeView have gained argument legend. default is TRUE. Legends only available for non-RGB methods!

• new data sets:

  • 'franconia' (administrative district boundaries of Franconia)
  • 'breweries' (extended version of the 'breweries91' data)
  • 'trails' (selected hiking trails in franconia to connect the breweries)

• data sets 'breweries91', 'gadmCHE' and 'atlStorms2005' have been deleted and moved to leaflet.

bugfixes:

• sync, addMouseCoordinates and addLogo did not work anymore. Now fixed thanks to @timelyportfolio

changes:

• MAJOR internal change: All vector data are now processed as sf objects internally. This also means that objects returned in slot @object will be of class sf (regardless of input class).
• polygons and points now have a darkish gray line frame (unless add*LargeFeatures is used - where the overhead of passing two sets of colors would be too high).
• updated examples (in line with new data).
• github repository moved from https://github.com/environmentalinformatics-marburg/mapview to https://github.com/r-spatial/mapview

mapview 1.2.0

new features:

• garnishMap: function to add multiple decoration elements, such as leaflet::addLayersControl or addHomeButton to a map (mainly for internal use).
• addHomeButton: add a zoom-to-layer button to a map.
• addLogo: add an image to a map.
• plainview now shows CRS and dimension info.

bugfixes:

• na.color was not respected for Raster* and SpatialPiXelsDF.
• removed lat and lon entries in popupTable for polygons as we now have mousecoordinates.
• for raster objects the legend did not respect the intervals specified by 'at'.
• mapview working again for objects with no projection (NA).
• mapview for SPoints* with only one point did through an error #36.

mapview 1.1.0

new features:

• addMouseCoordinates: add cursor position information to mapview or leaflet map. (thanks to Kent Russell).
• if available from leaflet version, a scalebar is added to the map.
• latticeView: view mapview or leaflet maps as small multiples and sync some, all or none (thanks to Kent Russell).
• sync: synchronise two or more leaflet maps (thanks to Kenton Russell).
• mapshot: to save maps as html page or static image or both.
• knitr integration (i.e. no need to call the @map slot anymore to render in knitr).
• cubeView: view raster bricks or stacks hovmoeller style, use keys up & down, left & right, page up & page down to navigate through y, x, z dimensions, respectively.
• labels: if zcol is set, mouseover will now show the repesctive values of zcol, if zcol is not set moseover shows feature ID. Only available if suitable leaflet package version is installed.
• new popup functions popupTable, popupGraph and popupImage.
• functions to turn coordinates into spatial lines or spatial polygons.
• mapview objects now work natively on shiny applications (i.e. renderMapview and mapviewOutput now available).
• "zcol = Var" in combination with burst = TRUE now plots one layer for each unique value of the variable supplied to zcol.

changes:

• spplot method has been removed.
• colors: viridis based colors now default if viridisLite package is available.
• basemaps: new default basemap is "CartoDB.Positron" as colors of features are better visible on the grey background.
• layer names now include the name of the object they originate from (e.g. "meuse lead" instead of "lead").

bugfixes:

• if attribute was of class "character" mapview did through an error if passed to zcol.
• user provided layer names were not respected when zcol was set. See also note on changes in default layer names.

mapview 1.0.0

• Initial release