https://github.com/christopherkenny/feltr

Access the Felt API
https://github.com/christopherkenny/feltr

Last synced: 11 days ago
JSON representation

Access the Felt API

• Host: GitHub
• URL: https://github.com/christopherkenny/feltr
• Owner: christopherkenny
• License: other
• Created: 2023-06-22T01:31:20.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-10T23:44:05.000Z (5 months ago)
• Last Synced: 2024-10-12T12:18:35.752Z (27 days ago)
• Language: R
• Homepage: http://christophertkenny.com/feltr/
• Size: 1.26 MB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.Rmd
  • License: LICENSE

Awesome Lists containing this project

README

        
---

output: github_document

---

```{r, include = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "man/figures/README-",

  out.width = "100%"

)

```

# feltr 

[![R-CMD-check](https://github.com/christopherkenny/feltr/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/christopherkenny/feltr/actions/workflows/R-CMD-check.yaml)

`feltr` offers an R interface to the [Felt API](https://feltmaps.notion.site/Felt-Public-API-reference-c01e0e6b0d954a678c608131b894e8e1). 

You can create new maps, edit existing maps, and extract data.

`feltr` includes tools for working with layers, which represent geographic data, 

and elements, which are interactive annotations. Spatial data accessed from the API 

is transformed to work with 'sf'.

## Installation

You can install the stable version of `feltr` from [CRAN](https://cran.r-project.org/package=feltr) with:

```r

install.package('feltr')

```

You can install the development version of `feltr` from [GitHub](https://github.com/christopherkenny/feltr) with:

``` r

remotes::install_github('christopherkenny/feltr')

```

## API Key

An API key can be obtained by signing into your Felt account and looking under Account Settings at the Integrations tab.

Once obtained, it can be loaded for persistent use with `feltr::set_felt_key('YOUR KEY', install = TRUE, r_env = file.path(Sys.getenv('HOME'), '.Renviron'))`.

## Example

We can create a map, add some data to it, and even delete it.

```{r example}

library(feltr)

## create a map

map <- felt_create_map(title = 'feltr README')

```

Then we can add some data to it from a URL.

```{r}

felt_add_map_layers_url(

  map_id = map$id, 

  url = 'https://www.rocklandgis.com/portal/sharing/rest/content/items/73fc78cb0fb04580b4788937fe5ee697/data',

  name = 'Parks'

)

```

Finally, we can even delete the map from R.

```{r}

felt_delete_map(map_id = map$id)

```

This returns a 204 on success.

## Related Packages

- [feltr](https://elipousson.github.io/feltr/): There is another R package by Eli Pousson with the same name available on [GitHub](https://github.com/elipousson/feltr).