{"Package":"maptiles","Title":"Download and Display Map Tiles","Version":"0.9.0","Authors@R":"c(person(given = \"Timothée\",\nfamily = \"Giraud\",\nemail = \"timothee.giraud@cnrs.fr\",\nrole = c(\"cre\",\"aut\"),\ncomment = c(ORCID = \"0000-0002-1932-3323\")),\nperson(given = \"Diego\",\nfamily = \"Hernangómez\",\nrole = c(\"ctb\"),\ncomment = c(ORCID = \"0000-0001-8457-4658\")),\nperson(given = \"Robert J.\",\nfamily = \"Hijmans\",\nrole = c(\"ctb\"),\ncomment = c(ORCID = \"0000-0001-5872-2872\")),\nperson(given = \"Hugh A.\",\nfamily = \"Graham\",\nrole = c(\"ctb\")))","Description":"To create maps from tiles, 'maptiles' downloads, composes and\ndisplays tiles from a large number of providers (e.g. 'OpenStreetMap',\n'Stadia', 'Esri', 'CARTO', or 'Thunderforest').","URL":"https://github.com/riatelab/maptiles/","BugReports":"https://github.com/riatelab/maptiles/issues/","License":"GPL-3","Depends":"R (>= 3.5.0)","Imports":"sf, curl, digest, graphics, grDevices, png, terra, tools,\nslippymath, utils","Suggests":"covr, tinytest","Encoding":"UTF-8","RoxygenNote":"7.3.2","NeedsCompilation":"no","Packaged":"2025-02-04 09:09:00 UTC; tim","Author":"Timothée Giraud [cre, aut] (),\nDiego Hernangómez [ctb] (),\nRobert J. Hijmans [ctb] (),\nHugh A. Graham [ctb]","Maintainer":"Timothée Giraud ","Repository":"CRAN","Date/Publication":"2025-02-04 10:00:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/maptiles_0.9.0.tar.gz","jsonAuthors":[{"name":"Timothée Giraud","email":"timothee.giraud@cnrs.fr","maintainer":true},{"name":"Diego Hernangómez","email":null,"maintainer":false},{"name":"Robert J. Hijmans","email":null,"maintainer":false},{"name":"Hugh A. Graham","email":null,"maintainer":false}],"readme":"\n\n\n# maptiles

\n\n\n\n[![R-CMD-check](https://github.com/riatelab/maptiles/actions/workflows/check-standard.yaml/badge.svg)](https://github.com/riatelab/maptiles/actions/workflows/check-standard.yaml)\n[![Codecov test\ncoverage](https://codecov.io/gh/riatelab/maptiles/branch/main/graph/badge.svg)](https://app.codecov.io/gh/riatelab/maptiles?branch=main)\n[![CRAN\nstatus](https://www.r-pkg.org/badges/version/maptiles)](https://CRAN.R-project.org/package=maptiles)\n![](https://cranlogs.r-pkg.org/badges/maptiles) [![Project Status:\nActive – The project has reached a stable, usable state and is being\nactively\ndeveloped.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n\n\nTo create maps from tiles, `maptiles` downloads, composes and displays\ntiles from a large number of providers (e.g. OpenStreetMap, Stadia,\nEsri, CARTO, or Thunderforest).\n\n## Installation\n\nYou can install the released version of `maptiles` from\n[CRAN](https://CRAN.R-project.org/package=maptiles) with:\n\n``` r\ninstall.packages(\"maptiles\")\n```\n\nYou can install the development version of `maptiles` from GitHub with:\n\n``` r\n# install.packages(\"remotes\")\nremotes::install_github(\"riatelab/maptiles\")\n```\n\n## Demo\n\nThis is a basic example which shows you how to dowload and display\nOpenStreetMap tiles over North Carolina:\n\n``` r\nlibrary(sf)\n#> Linking to GEOS 3.13.0, GDAL 3.10.1, PROJ 9.5.1; sf_use_s2() is TRUE\nlibrary(maptiles)\n# import North Carolina counties\nnc_raw <- st_read(system.file(\"shape/nc.shp\", package = \"sf\"), quiet = TRUE)\n# Project to EPSG:3857\nnc <- st_transform(nc_raw, \"EPSG:3857\")\n# dowload tiles and compose raster (SpatRaster)\nnc_osm <- get_tiles(nc, crop = TRUE)\n# display map\nplot_tiles(nc_osm)\n# add Norh Carolina counties\nplot(st_geometry(nc), col = NA, add = TRUE)\n# add credit\nmtext(text = get_credit(\"OpenStreetMap\"), side = 1, line = -1, adj = .99)\n```\n\n![](man/figures/README-example-1.png)\n\n`maptiles` gives access to a lot of tiles servers, but it is possible to\nadd others. The following example demonstrates the setting of a map\ntiles server and how to cache the original tiles for future use:\n\n``` r\n# define the tile server parameters\nosmpos <- create_provider(\n name = \"CARTO.POSITRON\",\n url = \"https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png\",\n sub = c(\"a\", \"b\", \"c\", \"d\"),\n citation = \"© OpenStreetMap contributors © CARTO \"\n)\n# dowload tiles and compose raster (SpatRaster)\nnc_osmpos <- get_tiles(\n x = nc, provider = osmpos, crop = TRUE,\n cachedir = tempdir(), verbose = TRUE, retina = TRUE\n)\n#> Zoom: 7\n#> Source(s): © OpenStreetMap contributors © CARTO \n#> Cache directory: /tmp/Rtmpfvd4hn/CARTO.POSITRON\n#> 8 tiles\n#> The resulting raster uses high resolution tiles.\n# display map\nplot_tiles(nc_osmpos)\n# display credits\nmtext(text = get_credit(osmpos), side = 1, line = -1, adj = .99)\n```\n\n![](man/figures/README-example2-1.png)\n\nThe following figure shows mini maps for most of the tiles providers\navailable:\n\n![](man/figures/README-front.png)\n\n## Projection\n\nOriginal tiles use a projection known as “Web Mercator”, “WGS84 / Pseudo\nMercator”, “Google Mercator”, “EPSG:3857” or “EPSG:900913”. In most\ncases `get_tiles()` uses the projection of its `x` argument to reproject\nthe tiles. If you wish to avoid any deformation induced by the\nreprojection process, use “EPSG:3857” for `x` projection.\n\n## Attribution of map tiles\n\nAll maps available through `maptiles` are offered freely by various\nproviders. The only counterpart from the user is to properly display an\nattribution text on the maps. `get_credit()` displays a short\nattribution text to add on each map using the downloaded tiles.\n\n## Alternatives\n\nThere are many alternative packages that pursue the same objective as\n`maptiles`. Some focus on a specific map tiles provider (e.g. Mapbox,\nGoogle, OpenStreetMap) or on a specific graphics device (`ggplot2`). The\ngoal of `maptiles` is to be flexible enough to allow the use of\ndifferent providers and to have a minimal number of robust and modern\ndependencies. However, depending on the use case, one of following\npackages may better suit your needs:\n\n- [`ceramic`](https://github.com/hypertidy/ceramic) \n- [`ggmap`](https://github.com/dkahle/ggmap) (`ggplot2` focused)\n- [`ggspatial`](https://github.com/paleolimbot/ggspatial) (`ggplot2`\n focused, based on `rosm`)\n- [`mapboxapi`](https://github.com/walkerke/mapboxapi) (mapbox)\n- [`mapsapi`](https://github.com/michaeldorman/mapsapi/) (google, based\n on `RgoogleMaps`)\n- [`OpenStreetMap`](https://github.com/ifellows/ROSM) (requires Java)\n- [`RgoogleMaps`](https://github.com/markusloecher/rgooglemaps) (google)\n- [`rosm`](https://github.com/paleolimbot/rosm)\n- …\n\n## Note\n\nNot to be confused with\n[`tilemaps`](https://github.com/kaerosen/tilemaps), that “implements an\nalgorithm for generating maps, known as tile maps, in which each region\nis represented by a single tile of the same shape and size.”","jobInfo":{"package":"maptiles","version":"0.9.0","parsingStatus":"success","parserVersion":2,"parsedAt":"2025-02-04T11:30:00+0000"}}

Description

Usage

Arguments

Value

Examples