https://github.com/ambarja/geoidep

📥 Download geographic data on various topics provided and managed by the Spatial Data Infrastructure of Peru 🌎🌐.

https://github.com/ambarja/geoidep

Keywords

Repository

📥 Download geographic data on various topics provided and managed by the Spatial Data Infrastructure of Peru 🌎🌐.

README.Rmd

---
output: github_document
---



```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/fig-",
  out.width = "100%",
  dpi = 300
)
```


# geoidep: Download Geographic Data Managed by Peru's Spatial Data Infrastructure

[![R-CMD-check](https://github.com/ambarja/geoidep/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/ambarja/geoidep/actions/workflows/R-CMD-check.yaml)
[![Codecov test coverage](https://codecov.io/gh/ambarja/geoidep/graph/badge.svg)](https://app.codecov.io/gh/ambarja/geoidep)
[![CircleCI build status](https://circleci.com/gh/ambarja/geoidep.svg?style=svg)](https://circleci.com/gh/ambarja/geoidep)
[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)


The goal of geoidep📦 is to offers R users an easy and accessible way to obtain official cartographic data on various topics, such as society🏛️, transport🚗, environment🌱, agriculture🌾, climate⛅️,among others.This includes information provided by regional government entities and technical-scientific institutions, managed by the Spatial Data Infrastructure of Peru. 
*⚠️ The package accesses these datasets dynamically from official public servers, without redistributing data locally.*

The package is currently available in **R** and Python (coming soon).
 


## Installation R

You can install the development version of geoidep like so:

```r
install.packages('pak')
pak::pkg_install('ambarja/geoidep')
```

or also the official version available on CRAN:

```r
install.packages('geoidep')
```


## Example 01: Introduction

```{r, message=TRUE}
library(geoidep)
```

```r
── Welcome to geoidep ─────────────────────────────────────────────────────────────────
ℹ geoidep is a wrapper that enables you to download cartographic data for Peru directly from R.
ℹ Currently, `geoidep` supports data from the following providers:
• Geobosque
• INAIGEM
• INEI
• Midagri
• and more!
ℹ For more information, please use the `get_data_sources()` function.
```



In this example, we can identify the list of providers available in geoidep and the layers they present.

```{r}
get_data_sources() |> 
  head()
```
In summary the suppliers and the number of available layers

```{r}
get_providers() 
```

## Example 02: Download official INEI administrative boundaries

This is a simple example of how to download Peru's official administrative boundaries:

```{r}
dep <- get_departaments(show_progress = FALSE)
```

The first 10 rows of the original data are displayed here:
```{r}
head(dep)
```

Owner

GitHub Events

Committers

Last synced: 10 months ago

Issues and Pull Requests

Last synced: 11 months ago