Download Spatial Boundaries

download_boundaries(
  surveyNum = NULL,
  surveyId = NULL,
  countryId = NULL,
  method = "rgdal"
)

Arguments

surveyNum

Numeric for the survey number to be downloaded. Values for surveyNum can be found in the datasets or surveys endpoints in the DHS API that can be accessed using dhs_datasets and dhs_surveys. Default is NULL, which will cause the SurveyId to be used to find the survey.

surveyId

Numeric for the survey ID to be downloaded. Values for surveyId can be found in the datasets or surveys endpoints in the DHS API that can be accessed using dhs_datasets and dhs_surveys. Default is NULL, which will cause the SurveyNum to be used to find the survey.

countryId

2-letter DHS country code for the country of the survey being downloaded. Default = NULL, which will cause the countrycode to be looked up from the API.

method

Character for how the downloaded shape file is read in. Default = "rdgal", which reads the file using rgdal::readOGR. At current you can also specify sf, which uses sf::st_read. To just return the file paths for the files use method = "zip".

Value

Returns either the spatial file as a "SpatialPolygonsDataFrame" or a vector of the file paths of where the boundary was downloaded to.

Details

Downloads the spatial boundaries from the DHS spatial repository, which can be found at https://spatialdata.dhsprogram.com/home/.

Examples

if (FALSE) { # using the surveyNum res <- download_boundaries(surveyNum = 471, countryId = "AF") # using the surveyId and no countryID res <- download_boundaries(surveyId = "AF2010OTH") # using sf res <- download_boundaries(surveyNum = 471, countryId = "AF", method = "sf") }