Creates geographic map tiles from geospatial map files or non-geographic map tiles from simple image files. This package provides a tile generator function for creating map tile sets for use with packages such as 'leaflet'. In addition to generating map tiles based on a common raster layer source, it also handles the non-geographic edge case, producing map tiles from arbitrary images. These map tiles, which have a non-geographic, simple coordinate reference system (CRS), can also be used with 'leaflet' when applying the simple CRS option. Map tiles can be created from an input file with any of the following extensions: tif, grd and nc for spatial maps and png, jpg and bmp for basic images. This package requires 'Python' and the 'gdal' library for 'Python'. 'Windows' users are recommended to install 'OSGeo4W' (< https://trac.osgeo.org/osgeo4w/>) as an easy way to obtain the required 'gdal' support for 'Python'.
Author: Matthew Leonawicz
License: MIT
The tiler
package provides a tile generator function for creating map tile sets for use with packages such as leaflet
. In addition to generating map tiles based on a common raster layer source, it also handles the non-geographic edge case, producing map tiles from arbitrary images. These map tiles, which have a a non-geographic simple coordinate reference system, can also be used with leaflet
when applying the simple CRS option.
Map tiles can be created from an input file with any of the following extensions: tif
, grd
and nc
for spatial maps and png
, jpg
and bmp
for basic images.
This package helps R users who wish to create geographic and non-geographic map tiles easily and seamlessly with only a single line of R code. The intent is to do this with a package that has
Install tiler
from CRAN with:
install.packages("tiler")
Install the development version from GitHub with:
remotes::install_github("ropensci/tiler")
For non-geographic tiles, using a png
file is recommended for quality and file size. jpg
may yield a lower quality result, while a large, high resolution bmp
file may have an enormous file size compared to png
.
jpg
and bmp
are optionally supported by tiler
. This means they are not installed and imported with tiler
. It is assumed the user will provide png
images. If using jpg
or bmp
and the packages jpeg
or bmp
are not installed, respectively, tile
will print a message to the console notifying of the required package installations.
This package requires Python and the gdal
library for Python. Windows users are recommended to install OSGeo4W as an easy way to obtain the required gdal
support for Python in Windows. See ?tiler_options
or the package vignette for more information.
See the introduction vignette for more details and examples.
Complete package reference and function documentation
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
OSGeo4W.bat
path to system path.leaflet
examples of remotely hosted tiles generated by tiler
to vignette.OSGeo4W.bat
being ignored on Windows.gdal2tiles*
scripts have been updated to accept a command line argument when called by R that provides a path for any temporary files, i.e., tmp.*.vrt
files created by the gdal2tiles*
scripts. These were previously accumulating in the system temp folder. The new temporary directory is a sub-directory inside tempdir()
. Therefore, it is cleaned up when exiting R. Nevertheless, tile
also force deletes this subdirectory immediately after its internal system call to one of the gdal2tiles*
scripts returns, so the temporary sub-directory does not even exist for the full duration of the tile
call.tile_viewer
and view_tiles
and other supporting functions for generating HTML Leaflet tile preview web page.tile
. tile
now generates previewer by default.tile
, added arguments including resume
and format
, changed some argument names.gdal2tiles
.tile
function for generating map tiles from geographic or non-geographic maps/images.