stac_time_series
Extract time series of satellite band data for an area over a date range, returning per-date artifact references for change monitoring.
Instructions
Extract a time series of band data over an area.
Searches for all scenes in the date range, downloads the requested bands for each, and returns references to the full temporal stack.
Args: bbox: Area of interest [west, south, east, north] bands: Bands to extract (e.g., ["red", "nir"]) date_range: Date range "YYYY-MM-DD/YYYY-MM-DD" collection: STAC collection (default: sentinel-2-l2a) max_cloud_cover: Maximum cloud cover 0-100 (default: 20) max_items: Maximum scenes to include (default: 50) catalog: Catalog name (default: earth_search) output_mode: Response format - "json" (default) or "text"
Returns: JSON with per-date artifact references
Tips for LLMs: - Use for monitoring change over time (vegetation growth, flood extent, urban expansion) - Pair with stac_compute_index on each date's artifact for temporal index analysis (e.g., NDVI over a growing season) - Keep bbox small — each date downloads full band data - Use max_cloud_cover=10 for cleaner optical time series - For a single cloud-free image from a date range, use stac_temporal_composite with method="median" instead - max_items limits the number of dates; set higher for dense temporal sampling or lower to reduce download volume - Cloud cover filter is automatically skipped for non-optical collections (sentinel-1-grd, cop-dem-glo-30)
Example: ts = await stac_time_series( bbox=[0.85, 51.85, 0.95, 51.92], bands=["red", "nir"], date_range="2024-01-01/2024-12-31", max_cloud_cover=10 )
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbox | Yes | ||
| bands | Yes | ||
| catalog | No | ||
| max_items | No | ||
| collection | No | ||
| date_range | Yes | ||
| output_mode | No | json | |
| max_cloud_cover | No |