get_aws_terrain function

Get a digital elevation model from the AWS Terrain Tiles

This function uses the AWS Terrain Tile service to retrieve an elevation raster from the geotiff service. It accepts a sf::st_bbox object as input and returns a single raster object covering that extent.

Source

Attribution: Mapzen terrain tiles contain 3DEP, SRTM, and GMTED2010 content courtesy of the U.S. Geological Survey and ETOPO1 content courtesy of U.S. National Oceanic and Atmospheric Administration. https://github.com/tilezen/joerd/tree/master/docs

get_aws_terrain(
  locations,
  z,
  prj,
  expand = NULL,
  ncpu = future::availableCores() - 1,
  serial = NULL,
  ...
)

Arguments

• locations: Either a data.frame of x (long) and y (lat), an sp, sf, or raster object as input.

• z: The zoom level to return. The zoom ranges from 1 to 14. Resolution of the resultant raster is determined by the zoom and latitude. For details on zoom and resolution see the documentation from Mapzen at https://github.com/tilezen/joerd/blob/master/docs/data-sources.md#what-is-the-ground-resolution

• prj: A valid input to st_crs If a sf

  object or a terra object is provided as the locations, the prj is optional and will be taken from locations. This argument is required for a data.frame of locations.

• expand: A numeric value of a distance, in map units, used to expand the bounding box that is used to fetch the terrain tiles. This can be used for features that fall close to the edge of a tile and additional area around the feature is desired. Default is NULL.

• ncpu: Number of CPU's to use when downloading aws tiles.

• serial: Logical to determine if API should be hit in serial or in parallel. TRUE will use purrr, FALSE will use furrr.

• ...: Extra configuration parameters to be passed to httr::GET. Common usage is to adjust timeout. This is done as config=timeout(x) where x is a numeric value in seconds. Multiple configuration functions may be passed as a vector.