record_batch_reader {overturemapsr}

record_batch_reader

Description

This function retrieves a filtered dataset from the specified Overture dataset type, optionally within a bounding box, and converts it to an sf object.

Usage

record_batch_reader(overture_type, bbox = NULL)

Arguments

overture_type

Character. Required. The type of feature to select. Examples include 'building', 'place', etc. To learn more, run get_all_overture_types().

bbox

Numeric vector. Optional. A bounding box specified as c(xmin, ymin, xmax, ymax). It is recommended to use a bounding box to limit the dataset size and processing time. Without a bounding box, processing the entire dataset (e.g., buildings over 2 billion) can be time-consuming.

Value

An sf object containing the filtered dataset based on the bounding box.

Examples

# Example usage with a bounding box takes > 20 secs
sf_bbox <- c(-122.5, 37.7, -122.3, 37.8)
result <- record_batch_reader(overture_type = 'place', bbox = sf_bbox)
print(result)