Usage

Satellite Data Download

Pre-download raw Sentinel satellite data for a polygon and date range. This primes the cache so that subsequent analysis requests process faster.

Overview

When you request an analysis, the system first needs to download the relevant satellite imagery. By pre-downloading data with processSatelliteDownload(), you can speed up analysis requests by ensuring the imagery is already available in the Agdir data store.

Process Satellite Download

GraphQL Mutation

mutation { processSatelliteDownload( polygonId: "abc123-def456-ghi789" startDate: "2025-06-01" endDate: "2025-08-31" satelliteDataType: "Optical" ) { Status Message Result { requestId } } }

Parameters

polygonId REQUIRED

The polygon to download data for.

startDate REQUIRED

Start of the date range (YYYY-MM-DD).

endDate REQUIRED

End of the date range (YYYY-MM-DD).

satelliteDataType REQUIRED

Type of data to download: "Optical" (Sentinel-2 multispectral) or "Radar" (Sentinel-1 SAR).

Check Availability

Use retrieveSatelliteDownload() to check which dates have available satellite imagery:

GraphQL Query

query { retrieveSatelliteDownload( polygonId: "abc123-def456-ghi789" startDate: "2025-06-01" endDate: "2025-08-31" ) { date classification satellite } }

Image Classifications

Classification	Description
`Available`	Cloud-free imagery is available and ready for analysis.
`Cloud Detected`	Imagery exists but cloud cover was detected over the polygon. May still produce partial results.
`Unavailable`	No satellite pass occurred over this polygon on the given date.
`Unknown`	Data has not yet been evaluated. May become available after download processing.

Tip: Pre-downloading satellite data is optional but recommended for batch processing workflows. If you request an analysis without pre-downloading, the system will download the data as part of the analysis pipeline.