Read Protected areas intersecting an area of interest
Source:R/protected_areas.R
protected_areas.RdReturns the protected-area polygons that fall within the bounding box of
aoi. By default it reads the global World Database on Protected Areas
(WDPA) via wdpa_areas() (see there for the source), so the overlap works
anywhere in the world. For offline use, point src to a local protected-area
file (.shp, .gpkg, .geojson) instead; it is then filtered to the AOI
bounding box and standardised to the same columns.
Arguments
- aoi
An
sf/sfcpolygon or point set (any CRS) defining the area of interest, e.g. an EOO hull, the union of AOO cells, or the occurrence points.- src
Optional path/URL to a local protected-area vector file. When supplied WDPA is not queried and the file is filtered to the AOI bounding box.
- cache, cache_dir
Cache the WDPA result on disk (default
TRUE; foldermappingAS_pa_cacheundertempdir()).- quiet
Passed to
sf::st_read()(defaultTRUE).
Value
An sf of protected-area polygons in EPSG:4326 (possibly with zero
rows when none intersects the AOI), or NULL if the source could not be
read.
Details
The result carries three standardised columns: pa_name, pa_category and
pa_group, plus all original attributes.
Examples
# \donttest{
occ <- read_occurrences(system.file("extdata", "example_occurrences.csv",
package = "mappingAS"))
sp1 <- occ[occ$species == occ$species[1], ]
pas <- protected_areas(calc_eoo(sp1)$hull) # reads WDPA over the web
unique(pas$pa_name)
#> [1] "Parque Nacional Da Serra Dos Órgãos"
#> [2] "Reserva Biológica De Araras"
#> [3] "Área De Proteção Ambiental Da Região Serrana De Petrópolis"
#> [4] "Reserva Biológica Do Tinguá"
#> [5] "Área De Proteção Ambiental De Macaé De Cima"
#> [6] "Área De Proteção Ambiental Da Bacia Do Rio São João - Mico-Leão-Dourado"
#> [7] "Área De Proteção Ambiental Da Bacia Do Rio Dos Frades"
#> [8] "Área De Proteção Ambiental Da Bacia Do Rio Macacu"
#> [9] "Parque Natural Municipal De Petrópolis"
#> [10] "Reserva Particular Do Patrimônio Natural Fazenda Miosótis"
#> [11] "Monumento Natural Municipal Da Pedra Do Colégio"
#> [12] "Reserva Particular Do Patrimônio Natural Caldeirão"
#> [13] "Reserva Particular Do Patrimônio Natural Lençóis"
#> [14] "Reserva Particular Do Patrimônio Natural Olho Dágua"
#> [15] "Reserva Particular Do Patrimônio Natural Duas Pedras"
#> [16] "Reserva Particular Do Patrimônio Natural Soledade"
#> [17] "Reserva Particular Do Patrimônio Natural Nêga Fulô"
#> [18] "Parque Natural Municipal Montanhas De Teresópolis"
#> [19] "Reserva Particular Do Patrimônio Natural Pedra Branca"
#> [20] "Reserva Particular Do Patrimônio Natural Córrego Frio"
#> [21] "Reserva Particular Do Patrimônio Natural Reserva Ecológica De Guapiaçu"
#> [22] "Reserva Particular Do Patrimônio Natural Woodstock"
#> [23] "Reserva Particular Do Patrimônio Natural Sítio Serra Negra"
#> [24] "Reserva Particular Do Patrimônio Natural Canto Dos Pássaros Ii"
#> [25] "Reserva Particular Do Patrimônio Natural Fazenda Suspiro"
#> [26] "Reserva Particular Do Patrimônio Natural Canto Dos Pássaros"
#> [27] "Reserva Particular Do Patrimônio Natural Reserva Serra Do Caramandu"
#> [28] "Reserva Particular Do Patrimônio Natural Pilões"
#> [29] "Reserva Particular Do Patrimônio Natural Rildo De Oliveira Gomes Ii"
#> [30] "Reserva Particular Do Patrimônio Natural Alto Da Boa Vista - Resgate Viii"
#> [31] "Reserva Particular Do Patrimônio Natural Reserva Ecológica De Guapiaçu 2"
#> [32] "Reserva Particular Do Patrimônio Natural Mico Leão Dourado"
#> [33] "Reserva Particular Do Patrimônio Natural Rogério Marinho"
#> [34] "Reserva Particular Do Patrimônio Natural Graziela Maciel Barroso"
#> [35] "Reserva Particular Do Patrimônio Natural Regina Clara"
#> [36] "Reserva Particular Do Patrimônio Natural Regina"
#> [37] "Reserva Particular Do Patrimônio Natural Nossa Senhora Aparecida"
#> [38] "Reserva Particular Do Patrimônio Natural Jacutinga"
#> [39] "Refúgio De Vida Silvestre Estadual Do Médio Paraíba"
#> [40] "Área De Proteção Ambiental Bemposta"
#> [41] "Estação Ecológica Monte Das Flores"
#> [42] "Reserva Particular Do Patrimônio Natural Pastos Dos Bois E Pedregulhos"
#> [43] "Reserva Particular Do Patrimônio Natural Reserva Ecológica De Guapiaçu 3"
#> [44] "Reserva Particular Do Patrimônio Natural Rildo De Oliveira Gomes I"
#> [45] "Área De Proteção Ambiental Santa Fé"
#> [46] "Área De Proteção Ambiental Vale Do Morro Da Torre"
#> [47] "Reserva Particular Do Patrimônio Natural Floresta Alta"
#> [48] "Parque Estadual Dos Três Picos"
#> [49] "Monumento Natural Municipal Da Concórdia"
#> [50] "Refúgio Da Vida Silvestre Do Sucavão"
#> [51] "Área De Proteção Ambiental Vale Do Piabanha"
#> [52] "Área De Proteção Ambiental Vale Fagundes"
#> [53] "Área De Proteção Ambiental Vale Lagoa Do Morro Grande."
#> [54] "Monumento Natural Municipal Pico Do Cambote"
#> [55] "Parque Natural Municipal José Franklin Dos Santos Vaz"
#> [56] "Parque Natural Municipal Odette De Lima Soares"
#> [57] "Reserva Particular Do Patrimônio Natural Regua Iv"
#> [58] "Reserva Particular Do Patrimônio Natural Regua V"
#> [59] "Reserva Particular Do Patrimônio Natural Caiuá"
#> [60] "Reserva Particular Do Patrimônio Natural Toca Da Onça"
#> [61] "Área De Proteção Ambiental Maravilha"
#> [62] "Parque Natural Municipal Da Araponga"
#> [63] "Área De Proteção Ambiental De Nossa Senhora De Santana"
#> [64] "Monumento Natural Estadual Da Serra Da Maria Comprida"
#> [65] "Área De Proteção Ambiental De Três Picos"
#> [66] "Parque Natural Municipal Da Colina Do Conde"
#> [67] "Refúgio De Vida Silvestre De Macacu"
#> [68] "Reserva Biologica Do Dindi"
#> [69] "Monuimento Natural Pedra Das Flores"
#> [70] "Parque Natural Municipal Fazenda Das Laranjeiras"
#> [71] "Refúgio De Vida Silvestre De Santa Fé"
#> [72] "Reserva Particular Do Patrimônio Natural El Shammah"
#> [73] "Área De Proteção Ambiental De Nossa Senhora Aparecida"
#> [74] "Área De Proteção Ambiental Grotão"
#> [75] "Área De Proteção Ambiental Fábrica"
#> [76] "Reserva Particular Do Patrimônio Natural Fazenda Colomi"
# }