Query a STAC API and return the item collection.

Searches the collection with a GET request, falling back to POST when the API rejects GET, and fetches every page of results via rstac::items_fetch().

Usage

stac_query(bbox, stac_source, collection, start_date, end_date, limit = 999)

Arguments

bbox

Length-4 numeric, EPSG:4326 (xmin, ymin, xmax, ymax).

stac_source

STAC API root URL.

collection

Collection id.

start_date, end_date

Search bounds, both inclusive: Dates, POSIXcts, or strings as.POSIXct() parses in UTC (such as "2023-06-01" or "2023-06-01 12:00:00"). A date without a time covers that whole day, so end_date = "2023-12-31" includes acquisitions made on the 31st.

limit

Page size requested from the API.

Value

An rstac doc_items object.

See also

stac_sign_mpc(), stac_sources(), and lazy_dataset() as the usual next steps.

Other stac helpers: stac_drop_duplicates(), stac_filter_assets(), stac_filter_cloud(), stac_filter_coverage(), stac_filter_orbit(), stac_gti_index(), stac_merge(), stac_rename_assets(), stac_sign_mpc(), stac_sources(), stac_time_slices()