Create GeoJSON Region from R Spatial Objects

Creates a suitable input for the region argument to gd_download(<Image>) or gd_search() for Image Collections.

gd_region_to_vect() is the inverse function of gd_region/gd_bbox; convert GeoJSON-like list to Well-Known Text(WKT)/SpatVector. This may be useful, for example. when gd_region()-output was derived from an Earth Engine asset rather than local R object.

gd_region(x)

gd_region_to_vect(x, crs = "OGC:CRS84", as_wkt = FALSE, ...)

Arguments

x

either a WKT string (character), a SpatRaster(Collection)/SpatVector(Collection)/SpatExtent, an sf object, an Spatial* object or a RasterLayer/RasterStack.

crs

character. Default for GeoJSON sources is "OGC:CRS84".

as_wkt

logical. Return Well-Known Text (WKT) string as character? Default: FALSE returns a 'terra' SpatRaster.

...

Additional arguments to gd_region_to_vect() are passed to terra::vect() when as_wkt=FALSE (default).

Value

list representing a GeoJSON extent

gd_region_to_vect(): a 'terra' SpatVector object, or character containing Well-Known Text.

Details

If x is an R spatial object, each vertex (possibly after converting object extent to vector) is used to create the GeoJSON object. Otherwise, the extent is determined and passed to gd_bbox().

See also

gd_bbox()

Examples

if (FALSE) { # gd_is_initialized() && !inherits(requireNamespace("terra", quietly = TRUE), "try-error")
# \donttest{
library(terra)

b <- terra::vect('POLYGON((-121.355 37.560, 
                           -121.355 37.555,
                           -121.350 37.555, 
                           -121.350 37.560,
                           -121.355 37.560))',
                 crs = "OGC:CRS84")

gd_region(b)
# }
}