Skip to content

Latest commit

 

History

History
executable file
·
88 lines (63 loc) · 6 KB

README.md

File metadata and controls

executable file
·
88 lines (63 loc) · 6 KB

rgeoboundaries

License: MIT

rgeoboundaries is an R client for the geoBoundaries API, providing country political administrative boundaries.

Installation

You can install the development version of rgeoboundaries using the remotes package:

# install.packages("remotes")
remotes::install_github("wmgeolab/rgeoboundaries")

Access administrative boundaries using rgeoboundaries

This is a basic example which shows you how get Mali and Senegal boundaries and plot it

library(rgeoboundaries)
library(sf)
mli_sen <- gb_adm0(c("mali", "senegal"), type = "sscgs")
plot(st_geometry(mli_sen))

We can also get the first administrative division of all countries in the world and use ISO3 code too

egy <- gb_adm1("EGY")
plot(st_geometry(egy),
     col = rgb(red = 1, green = 0, blue = 0, alpha = 0.5),
     axes = TRUE, graticule = TRUE)

In order to access the global administrative zones, you just need to skip the country argument (i.e set it to NULL) or specify type = "CGAZ".

world <- gb_adm1()
world_lambert <- st_transform(world, "+proj=laea +x_0=0 +y_0=0 +lon_0=0 +lat_0=0")
par(bty = "n")
plot(st_geometry(world_lambert),
     col = "#E39d57",
     graticule = TRUE, lwd = 0.3)

Finally, metadata for each country and administrative level are also available.

knitr::kable(gb_metadata(c("mali", "senegal"), "adm1"))
boundaryID boundaryISO boundaryYear boundaryType boundarySource.1 boundarySource.2 boundaryLicense licenseDetail licenseSource boundarySourceURL boundaryUpdate downloadURL gjDownloadURL imagePreview
MLI-ADM1-3_0_0-G348 MLI 2015.0 ADM1 DNCT - Direction Nationale des Colelctivités Territorielles, DNP - Direction Nationale de la Population United Nations Office for the Coordination of Humanitarian Affairs, Mali Creative Commons Attribution 4.0 International (CC BY 4.0) Noted in metadata tab https://data.humdata.org/dataset/mali-admin-boundaries-level-1-2-and-3-including-2017-population-desagregated-by-sexe https://data.humdata.org/dataset/mali-admin-boundaries-level-1-2-and-3-including-2017-population-desagregated-by-sexe 2020-05-25 https://geoboundaries.org/data/geoBoundaries-3_0_0/MLI/ADM1/geoBoundaries-3_0_0-MLI-ADM1-all.zip https://geoboundaries.org/data/geoBoundaries-3_0_0/MLI/ADM1/geoBoundaries-3_0_0-MLI-ADM1.geojson https://geoboundaries.org/data/geoBoundaries-3_0_0/MLI/ADM1/geoBoundariesPreview-3_0_0-MLI-ADM1.png
SEN-ADM1-3_0_0-G486 SEN 2017.0 ADM1 Government of Senegal United Nations Office for the Coordination of Humanitarian Affairs Regional Office for West and Central Africa (ROWCA) Other - Humanitarian Humanitarian use only - Noted in metadata tab https://data.humdata.org/dataset/senegal-administrative-boundaries https://data.humdata.org/dataset/senegal-administrative-boundaries 2020-05-25 https://geoboundaries.org/data/geoBoundaries-3_0_0/SEN/ADM1/geoBoundaries-3_0_0-SEN-ADM1-all.zip https://geoboundaries.org/data/geoBoundaries-3_0_0/SEN/ADM1/geoBoundaries-3_0_0-SEN-ADM1.geojson https://geoboundaries.org/data/geoBoundaries-3_0_0/SEN/ADM1/geoBoundariesPreview-3_0_0-SEN-ADM1.png

How to to cite

If you are using this package in your analysis, please cite the original geoBoundaries work:

Runfola D, Anderson A, Baier H, Crittenden M, Dowker E, Fuhrig S, et al. (2020) geoBoundaries: A global database of political administrative boundaries. PLoS ONE 15(4): e0231866. https://doi.org/10.1371/journal.pone.0231866