strview_search: strview_search

In streetscape: Collect and Investigate Street Views for Urban Science

strview_search

Description

strview_searchByGeo: Search for and download the meta information of street view images via Mapillary API (See detials) based on coordinates of a spatial point with a given distance or a bounding box.

strview_search_nnb: Search for the nearest (within 10m buffer) available street view images and download meta information via Mapillary API (See detials) given coordinates of a spatial point.

strview_search_osm: Search for street view images by sampling locations along the OSM road lines and download meta information via Mapillary API (See detials) given a bounding box.

strview_search_multi: Search for and download the meta information of street view images via Mapillary API (See detials) based on multiple coordinates

Usage

strview_searchByGeo(
  x,
  y,
  r,
  epsg,
  bbox,
  token = "",
  limit = 10,
  fields = c(),
  ...
)

strview_search_nnb(x, y, epsg, token = "", fields = c(), ...)

strview_search_osm(bbox, epsg, token, fields = c(), size, ...)

strview_search_multi(viewpoints, epsg, token, fields = c(), ...)

Arguments

x	numeric, indicating Longtitude degree of the center point.
y	numeric, indicating latitude degree of the center point.
r	numeric, indicating search distance (meter or feet) for LiDAR data.
epsg	numeric, the EPSG code specifying the coordinate reference system.
bbox	vector, a bounding box defining the geographical area for downloading data.
token	character, API token of Mapillary.
limit	numeric, indicating the number of returns. The maximum is 2000.
fields	vector, a vector of fields indicates the information of images to be retrieved (See details). 'is_pano', 'thumb_256_url', 'height', 'width', 'computed_geometry', 'computed_altitude', and 'detections' are retrieved as a default setting.
...	indicating filters (see details)
size	numeric, (approximate) number of locations sampled on OSM spatial lines (this is for strview_search_osm only).
viewpoints	sf or matrix, indicating multiple degress-based coordinates for searching available street views (this is for strview_search_multi only).

Details

strview_search

To request an API token of Mapillary, please create your access token at https://mapillary.com/developer. For 'fields', one can review all available fields in this package by calling streetscape::field_list().

Value

For strview_searchByGeo(), a StreetscapeDataFrame returned combining a dataframe of the image information.

For strview_search_nnb(), a StreetscapeDataFrame with one-row dataframe will be returned if there is any available images near to the given point

For strview_search_osm(), a StreetscapeDataFrame that combines the information of street views from all sampled points along the OSM lines within the specified bounding box.

For strview_search_multi(), a StreetscapeDataFrame that combines the information of street views based on the coordinates of multiple spatial points

Note

If there is no street view images within the search area, the function only returns an integer 0.

See Also

available_field() available_filter() see_streetscape_class()

Examples

bbox <- c(-83.751812,42.272984,-83.741255,42.279716)
if (isTRUE(file.exists("streetscape_token.sysdata"))) {
 data <- streetscape::strview_searchByGeo(bbox = bbox,
                                          epsg = 2253,
                                          token = "",
                                          is_pano = TRUE)
 data <- streetscape::strview_searchByGeo(x = -83.741289,
                                          y = 42.270146,
                                          r = 100,
                                          epsg = 2253,
                                          token = "",
                                          is_pano = TRUE)
}



if (isTRUE(file.exists("streetscape_token.sysdata"))) {
 data <- streetscape::strview_search_nnb(
         x = -83.743460634278,
         y = 42.277848830294,
         epsg = 2253,
         token = '')
}


bbox <- c(-83.752041,42.274896,-83.740711,42.281945)
if (isTRUE(file.exists("streetscape_token.sysdata"))) {
 data <- streetscape::strview_search_osm(
         bbox = bbox,
         epsg = 2253,
         token = '',
         size = 100)
}


x <- c(-83.752041, -83.740711)
y <- c(42.274896, 42.281945)
viewpoints <- cbind(x, y)
if (isTRUE(file.exists("streetscape_token.sysdata"))) {
 data <- streetscape::strview_search_multi(
         viewpoints = viewpoints,
         epsg = 2253,
         token = '')
}

streetscape documentation built on April 3, 2025, 8:49 p.m.