Supporting Information

API Restrictions

The Agdir Satellite API enforces certain limits on polygon size, date ranges, and data availability to ensure reliable processing.

Restrictions Summary

Restriction Limit
Maximum polygon size 1,000 hectares
Maximum polygon size for daily vegetation index 50 hectares
Maximum time range per request 1 year (365 days)
Earliest available date 2018-01-01
Latest available date Yesterday (today's date minus 1 day)

Polygon Size Limits

Standard analyses support polygons up to 1,000 hectares. The daily vegetation index feature has a stricter limit of 50 hectares due to the computational intensity of ML-based gap filling.

Workaround: Split Into Multiple Polygons

If your field exceeds the size limit, split it into multiple smaller polygons that each fall within the limit. Register each polygon separately and run analyses on each one. You can then combine the results in your application.

Time Range Limits

Each analysis request can cover a maximum period of 1 year (365 days). The earliest date supported is 2018-01-01 (when Sentinel-2 data became reliably available). The latest date is always yesterday — you cannot request analyses for the current day or future dates.

Workaround: Split Into Multiple Requests

For multi-year analyses, submit separate requests for each year. For example, to analyze 2020–2023:

  • Request 1: startDate: "2020-01-01", endDate: "2020-12-31"
  • Request 2: startDate: "2021-01-01", endDate: "2021-12-31"
  • Request 3: startDate: "2022-01-01", endDate: "2022-12-31"
  • Request 4: startDate: "2023-01-01", endDate: "2023-12-31"

Tip: When splitting time ranges, you can submit all requests simultaneously. They will be processed in parallel through the pipeline.