feltr

The goal of feltr is to read maps from Felt as simple feature or SpatRaster objects.

Package does not support the Felt API v2

This package does not support the Felt API and, as of December 2024, I have no specific timeline for when the package will be updated to restore functionality. Please use the feltr package (identical name but a different developer) for API access or follow this GitHub issue for updates.

Installation

You can install the development version of feltr like so:

pak::pkg_install("elipousson/feltr")

Example

library(feltr)

You can use read_felt_map() to create an sf object with features from a map URL.

url <- "https://felt.com/map/Site-Plan-Example-PGTipS2mT8CYBIVlyAm9BkD"

site_plan <- read_felt_map(url)

plot(site_plan)

get_felt_map() returns a list with basic information about a map (set read = TRUE to read map elements and layers at the same time):

get_felt_map(url)

You can also use read_felt_raster() (a wrapper for rasterpic::rasterpic_img()) to create a SpatRaster object from a “Image” type feature in Felt.

image_map <- read_felt_raster(
  "https://felt.com/map/feltr-sample-map-read-felt-raster-oiinodTbT79BEueYdGp1aND",
  "https://tile.loc.gov/image-services/iiif/service:gmd:gmd370:g3700:g3700:ct003955/full/pct:12.5/0/default.jpg"
)

image_map

For more information on the Felt Public API check out the guide to Getting Started with the Felt API or the Felt API reference.

Note, in July 2024, Felt announced the pricing for subscription plans that are expected to limit API access to paid accounts starting in January 2024. Educators can also apply for free accounts to retain API access after January 2024.

Related Projects

• {feltr}: A R package with the same name that provide very similar functionality to this package.
• felt-upload: A Python package to upload data to Felt.
• Add to Felt QGIS Plugin: A QGIS plugin for uploading data to Felt.
• feltpy: A lightweight Python package to interact with the public API of Felt.com.