Skip to content

r-spatial/mapview

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
November 4, 2022 10:49
R
October 27, 2023 14:46
man
October 13, 2023 10:15
August 22, 2020 19:47
November 17, 2021 11:55
September 23, 2023 13:04
September 23, 2023 13:04
October 13, 2023 10:20
August 20, 2015 13:07
October 13, 2023 10:20
October 13, 2023 10:20
September 30, 2023 11:45
September 30, 2023 11:45
August 22, 2020 19:47
April 15, 2022 13:07

mapview

tic cran checks monthly total CRAN License Coverage Status status

Interactive viewing of spatial data in R

mapview provides functions to very quickly and conveniently create interactive visualisations of spatial data. It’s main goal is to fill the gap of quick (not presentation grade) interactive plotting to examine and visually investigate both aspects of spatial data, the geometries and their attributes. It can also be considered a data-driven API for the leaflet package as it will automatically render correct map types, depending on the type of the data (points, lines, polygons, raster). In addition, it makes use of some advanced rendering functionality that will enable viewing of much larger data than is possible with leaflet. Furthermore, if you’re a fan of mapdeck (which you should!), you can choose to use it as the rendering platform instead of leaflet by setting mapviewOptions(platform = "mapdeck").

The main user relevant functions are:

  • mapview - view (multiple) spatial objects on a set of background maps
  • viewExtent - view extent / bounding box of spatial objects
  • viewRGB - view RGB true- or false-color images of raster objects
  • mapshot - easily save maps (including leaflet maps) as html and/or png (or other image formats)

Functions that have been deprecated/deleted recently:

  • addHomeButton - deprecated, use package leafem instead.
  • addLogo - deprecated, use package leafem instead.
  • addFeatures - deprecated, use package leafem instead.
  • addMouseCoordinates - deprecated, use package leafem instead.
  • addExtent - deprecated, use package leafem instead.
  • addImageQuery - deprecated, use package leafem instead.
  • latticeView & sync - deprecated, use package leafsync instead.
  • slideView - deprecated, use package slideview instead.
  • cubeView - deprecated, use package cubeview instead.
  • plainview - deprecated, use package plainview instead.
  • popupTable, popupGraph & popupImage - deprecated, use package leafpop instead.
  • addLargeFeatures - use leafgl::addGL* functions instead.

Objects of the following spatial classes are supported:

  • sf
  • raster (Layer, Stack, Brick and SpatialPixels* / SpatialGridDataFrame)
  • stars
  • sp (Points, Polygons, Lines and their DataFrame version)
  • satellite

Installation

For CRAN release version of mapview use

install.packages("mapview")

To install the development version you can install the remotes package.

NOTE: As of version 2.9.1 development will happen on the master branch. Please consider the develop branch obsolete.

remotes::install_github("r-spatial/mapview")

Usage

The most basic call

mapview(breweries)

will produce a web map visualisation of the breweries data with the following components:

Contact

Please file bug reports and feature requests at https://github.com/r-spatial/mapview/issues