Reference Google Earth Engine Image or Image Collection by ID or Name

Create references to a Google Earth Engine Image or Image Collection based on IDs or names, or combine Images into Image Collections.

gd_image_from_id(x)

gd_collection_from_name(x)

gd_collection_from_list(x)

gd_asset_id(filename, folder = NULL)

gd_list_assets(parent)

Arguments

x

character. id of Image, name of Image Collection, or a vector of Image id to create a new Image Collection

filename

File or Asset Name

folder

Optional: Project Name

parent

Full path to project folder (with or without "/assets" suffix)

Value

A geedim.image.ImageAccessor (for geedim >= 2.0.0) or geedim.MaskedImage (for geedim < 2.0.0) object, or try-error on error. See \link{geedim-versions} for more details.

A geedim.collection.ImageCollectionAccessor (for geedim >= 2.0.0) or geedim.MaskedCollection (for geedim < 2.0.0) object, or try-error on error. See \link{geedim-versions} for more details.

A geedim.collection.ImageCollectionAccessor (for geedim >= 2.0.0) or geedim.MaskedCollection (for geedim < 2.0.0) object, or try-error on error. See \link{geedim-versions} for more details.

Examples

# \donttest{
if (gd_is_initialized())
  gd_image_from_id('CSP/ERGo/1_0/Global/SRTM_topoDiversity')
#> <geedim.image.ImageAccessor object at 0x7f995b508f50>
# }
# \donttest{
if (gd_is_initialized())

  # Find 1m DEMs in arbitrary extent
  r <- gd_bbox(xmin = -121.4, xmax = -121.35, ymin = 37.55, ymax = 37.6)

  # collection of individual tiles of DEM
  x <- gd_collection_from_name("USGS/3DEP/1m")

  # search within region
  y <- gd_search(x, r)

  gd_properties(y)
#>                                                                        id
#> 1                  USGS/3DEP/1m/USGS_1M_10_x64y416_CA_SanJoaquin_2021_A21
#> 2 USGS/3DEP/1m/USGS_1M_10_x64y416_CA_UpperSouthAmerican_Eldorado_2019_B19
#> 3                  USGS/3DEP/1m/USGS_1M_10_x64y417_CA_SanJoaquin_2021_A21
#> 4 USGS/3DEP/1m/USGS_1M_10_x64y417_CA_UpperSouthAmerican_Eldorado_2019_B19
#> 5                  USGS/3DEP/1m/USGS_one_meter_x64y417_CA_Sacramento_2017
#>         date
#> 1 2006-01-01
#> 2 2006-01-01
#> 3 2006-01-01
#> 4 2006-01-01
#> 5 2006-01-01

# }
# \donttest{
if (gd_is_initialized())
  # Find 1m DEM in arbitrary extent
  r <- gd_bbox(xmin = -121.4, xmax = -121.35, ymin = 37.55, ymax = 37.6)

  # collection of individual tiles of DEM
  x <- gd_collection_from_name("USGS/3DEP/1m")

  # search within region
  y <- gd_search(x, r)

  # select images with some condition of interest
  z <- subset(gd_properties(y),
              grepl("UpperSouthAmerican_Eldorado_2019", id) > 0)

  # create encapsulated images from IDs returned by search
  l <- lapply(z$id, gd_image_from_id)

  # create a new collection from the list of images
  if (FALSE) { # \dontrun{
  l2 <- gd_collection_from_list(l)
  l2
  } # }

### download composite of custom collection
#  gd_download(gd_composite(l2),
#              filename = "test.tif",
#              region = r,
#              crs = "EPSG:5070",
#              scale = 30)

# }
if (FALSE) { # \dontrun{
if (gd_is_initialized())
  gd_asset_id("RGEEDIM_TEST", "rgeedim-demo")
} # }
if (FALSE) { # \dontrun{
if (gd_is_initialized())
  gd_list_assets("projects/rgeedim-demo")
} # }