Batch load or save data for an area, street, or intersection
Description
This batch loading/saving function is less flexible than
get_area_data() can reduce the need for repetitive calls to get_area_data()
when gathering area-level data for mapping.
Usage
get_data_batch(
get = NULL,
area = NULL,
label = get,
adj = list(dist = 15, diag_ratio = NULL, asp = "6:4"),
fn = NULL,
batch = NULL,
crop = TRUE,
trim = FALSE,
load = TRUE,
cache = FALSE,
save = FALSE,
filetype = "geojson",
crs = pkgconfig::get_config("mapbaltimore.crs", 2804),
...
)
get_area_batch(
get = NULL,
area = NULL,
label = get,
adj = list(dist = 15, diag_ratio = NULL, asp = "6:4"),
fn = NULL,
batch = c("neighborhood", "council district", "csa", "tract"),
trim = FALSE,
load = TRUE,
save = FALSE,
cache = FALSE,
filetype = "geojson",
crs = pkgconfig::get_config("mapbaltimore.crs", 2804),
...
)
get_data_batch(
get = NULL,
area = NULL,
label = get,
adj = list(dist = 15, diag_ratio = NULL, asp = "6:4"),
fn = NULL,
batch = NULL,
crop = TRUE,
trim = FALSE,
load = TRUE,
cache = FALSE,
save = FALSE,
filetype = "geojson",
crs = pkgconfig::get_config("mapbaltimore.crs", 2804),
...
)
get_area_batch(
get = NULL,
area = NULL,
label = get,
adj = list(dist = 15, diag_ratio = NULL, asp = "6:4"),
fn = NULL,
batch = c("neighborhood", "council district", "csa", "tract"),
trim = FALSE,
load = TRUE,
save = FALSE,
cache = FALSE,
filetype = "geojson",
crs = pkgconfig::get_config("mapbaltimore.crs", 2804),
...
)
Arguments
get |
Type of geography to use in setting the area of data to load or
save. Supported values area "area", "street", or "intersection". Default: NULL
|
area |
An sf object to use instead of getting an area,
street, or intersection. Only used if get is NULL.
|
label |
Label to use for the loaded objects or saved files, Defaults to
the same as the get parameter.
|
adj |
Named list with parameters used by adjust_bbox() to create a
bounding box for the area, street, or intersection. Set to NULL if to use
the area as is (or to use another sf object with the other_area parameter)
Default: list(dist = 15, diag_ratio = NULL, asp = "6:4").
|
fn |
Function to apply to area after returning it. Useful for applying a
buffer to a street or creating a walking distance isochrone to use as the
bounding box for an intersection.
|
batch |
A character string or named list.
-
If using get_area_batch(), batch must be a character vector or list with
the type(s) of area supported by get_area(). Any area intersecting with the
area or adjusted area is returned. Default: "neighborhood", "council
district", "csa", "tract"
-
If using get_data_batch(), batch must be a character vector matching one of
the spatial datasets included with the mapbaltimore package or cached in
advance. "osm_buildings" is a special supported parameter that calls
get_area_osm_buildings() to return all building footprints in the bounding
box. Default: c("streets", "parks", "zoning", "hmt_2017", "mta_bus_lines",
"mta_bus_stops", "trees", "vegetated_area", "unimproved_property"). A named
list where list items are sf objects, supported character strings, or valid
URLs for ArcGIS FeatureServer or MapServer layers is also supported. Default: NULL
|
crop |
If FALSE, return data that intersects with the bounding box of
the area, street, or intersection but do not crop to the bounding box. This
parameter is not supported for get_area_batch(). Default: TRUE.
|
trim |
If TRUE (and if adj is NULL), trim the data to the area, street,
or intersection. Default: FALSE.
|
load |
If TRUE, load the datasets to the global environment,
Default: TRUE
|
cache |
If TRUE, cache the datasets to the package cache folder with
cache_baltimore_data(). Default FALSE.
|
save |
If TRUE, save the selected areas and datasets locally as a file
(using the filetype parameter as a file extension)., Default: FALSE
|
filetype |
File extension supported by sf::write_sf(), Default:
'geojson'
|
crs |
Coordinate reference system
|
... |
Parameters passed to get_area(), get_streets(), or
get_intersection() depending on the value of the get parameter.
|
Examples
## Not run:
if (interactive()) {
# Load streets and cached edge of pavement data for the Harwood neighborhood
get_data_batch(
get = "area",
label = "harwood",
type = "neighborhood",
area_name = "Harwood",
batch = c("streets", "edge_of_pavement"),
load = TRUE,
save = FALSE
)
# Save parks, trees, and vegetated area w/in 800 meters
# of the intersection of E. Pratt and Light Sts. to GeoJSON files
get_data_batch(
get = "intersection",
street_names = "E PRATT ST & LIGHT ST",
adj = list(dist = 0, diag_ratio = NULL, asp = "1:1"),
dist = 800,
batch = c("parks", "trees", "vegetated_area")
)
}
## End(Not run)
if (interactive()) {
get_data_batch(
get = "area",
label = "harwood",
type = "neighborhood",
area_name = "Harwood",
batch = c("streets", "edge_of_pavement"),
load = TRUE,
save = FALSE
)
get_data_batch(
get = "intersection",
street_names = "E PRATT ST & LIGHT ST",
adj = list(dist = 0, diag_ratio = NULL, asp = "1:1"),
dist = 800,
batch = c("parks", "trees", "vegetated_area")
)
}
![[Deprecated]](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB3aWR0aD0iMTI0IiBoZWlnaHQ9IjIwIj48bGluZWFyR3JhZGllbnQgaWQ9ImIiIHgyPSIwIiB5Mj0iMTAwJSI+PHN0b3Agb2Zmc2V0PSIwIiBzdG9wLWNvbG9yPSIjYmJiIiBzdG9wLW9wYWNpdHk9Ii4xIi8+PHN0b3Agb2Zmc2V0PSIxIiBzdG9wLW9wYWNpdHk9Ii4xIi8+PC9saW5lYXJHcmFkaWVudD48Y2xpcFBhdGggaWQ9ImEiPjxyZWN0IHdpZHRoPSIxMjQiIGhlaWdodD0iMjAiIHJ4PSIzIiBmaWxsPSIjZmZmIi8+PC9jbGlwUGF0aD48ZyBjbGlwLXBhdGg9InVybCgjYSkiPjxwYXRoIGZpbGw9IiM1NTUiIGQ9Ik0wIDBoNTN2MjBIMHoiLz48cGF0aCBmaWxsPSIjZmU3ZDM3IiBkPSJNNTMgMGg3MXYyMEg1M3oiLz48cGF0aCBmaWxsPSJ1cmwoI2IpIiBkPSJNMCAwaDEyNHYyMEgweiIvPjwvZz48ZyBmaWxsPSIjZmZmIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBmb250LWZhbWlseT0iRGVqYVZ1IFNhbnMsVmVyZGFuYSxHZW5ldmEsc2Fucy1zZXJpZiIgZm9udC1zaXplPSIxMTAiPjx0ZXh0IHg9IjI3NSIgeT0iMTUwIiBmaWxsPSIjMDEwMTAxIiBmaWxsLW9wYWNpdHk9Ii4zIiB0cmFuc2Zvcm09InNjYWxlKC4xKSIgdGV4dExlbmd0aD0iNDMwIj5saWZlY3ljbGU8L3RleHQ+PHRleHQgeD0iMjc1IiB5PSIxNDAiIHRyYW5zZm9ybT0ic2NhbGUoLjEpIiB0ZXh0TGVuZ3RoPSI0MzAiPmxpZmVjeWNsZTwvdGV4dD48dGV4dCB4PSI4NzUiIHk9IjE1MCIgZmlsbD0iIzAxMDEwMSIgZmlsbC1vcGFjaXR5PSIuMyIgdHJhbnNmb3JtPSJzY2FsZSguMSkiIHRleHRMZW5ndGg9IjYxMCI+ZGVwcmVjYXRlZDwvdGV4dD48dGV4dCB4PSI4NzUiIHk9IjE0MCIgdHJhbnNmb3JtPSJzY2FsZSguMSkiIHRleHRMZW5ndGg9IjYxMCI+ZGVwcmVjYXRlZDwvdGV4dD48L2c+IDwvc3ZnPg==)