This package provides functions to interact with OvertureMaps datasets. It includes utilities for fetching data from S3 and converting it to sf objects for spatial analysis.
Overture Maps provides free and open geospatial map data, from many different sources and normalized to a common schema. This tool helps to download Overture data within a region of interest and converts it to a few different file formats.
To install this package, you need to have the necessary dependencies installed. You can install the package using the following commands:
# install.packages("devtools")
::install_github("denironyx/overturemapsr") devtools
This is a basic example which shows you how to solve a common problem:
library(overturemapsr)
## basic example code
You’ll still need to render README.Rmd
regularly, to
keep README.md
up-to-date.
devtools::build_readme()
is handy for this.
In that case, don’t forget to commit and push the resulting figure files, so they display on GitHub and CRAN.
library(arrow)
#>
#> Attaching package: 'arrow'
#> The following object is masked from 'package:utils':
#>
#> timestamp
library(dplyr)
#>
#> Attaching package: 'dplyr'
#> The following objects are masked from 'package:stats':
#>
#> filter, lag
#> The following objects are masked from 'package:base':
#>
#> intersect, setdiff, setequal, union
library(sf)
#> Linking to GEOS 3.12.1, GDAL 3.8.4, PROJ 9.3.1; sf_use_s2() is TRUE
library(overturemapsr)
# Bounding box of lisbon city
<- c(-9.181056,38.696137,-9.095569,38.750243)
ls_bbox
# Fetching overture building data
<- record_batch_reader('building', bbox = ls_bbox) ls_building
get_all_overture_types
: This function returns all
available OvertureMaps theme types.dataset_path
: This function returns the S3 path for the
specified Overture dataset type.record_batch_reader
: This function retrieves a filtered
dataset from the specified Overture dataset type, optionally within a
bounding box, and converts it to an sf object.Bounding Box Tool from Klokantech: Use this tool to find and specify bounding boxes of interest for your data queries.
This package was inspired and based on the OvertureMaps Python Repository. The functionality are similar and I will ensure to make the package stay updated.
Another inspiration for this package was based on the blog post by Kyle Walker. Kudos!!!