Даты снимков

GET /v1/fields/{id}/dates возвращает дни со снимками над полем в заданном окне. С его помощью выбирают дату для изображения или показывают шкалу времени перед запросом статистики.

Примеры на Python и JavaScript используют API, session, headers и id поля из быстрого старта.

Запрос

Параметр	Обязателен	Примечание
`from`	да	Первый день, `YYYY-MM-DD`.
`to`	да	Последний день, `YYYY-MM-DD`, не раньше `from` и не позже чем через 366 дней.
`source`	нет	`sentinel-2` (по умолчанию) или `planet`.

curl "https://api.agrosat.uz/v1/fields/cmgz7k2qv0004l8p3a9d1x6rt/dates?from=2026-04-01&to=2026-06-30" \
  -H "X-API-Key: $AGROSAT_API_KEY"

r = session.get(
    f"{API}/fields/{field_id}/dates",
    params={"from": "2026-04-01", "to": "2026-06-30"},
    timeout=60,
)
dates = r.json()["data"]["dates"]
clear = [d["date"] for d in dates if (d["scene_cloud_cover"] or 0) < 0.2]

const url = new URL(`${API}/fields/${fieldId}/dates`);
url.search = new URLSearchParams({ from: "2026-04-01", to: "2026-06-30" });
const { data } = await (await fetch(url, { headers })).json();
const clear = data.dates.filter((d) => (d.scene_cloud_cover ?? 0) < 0.2).map((d) => d.date);

Ответ

Даты идут от новых к старым:

{
  "success": true,
  "data": {
    "field_id": "cmgz7k2qv0004l8p3a9d1x6rt",
    "dates": [
      { "date": "2026-05-14", "scene_cloud_cover": 0.0213 },
      { "date": "2026-05-09", "scene_cloud_cover": 0.874 },
      { "date": "2026-05-04", "scene_cloud_cover": 0.0571 }
    ]
  }
}

scene_cloud_cover — облачность всей спутниковой сцены в долях от 0 до 1 или null, если поставщик её не сообщил. Сцена охватывает большую территорию, поэтому на облачной сцене поле может быть видно хорошо, а на ясной облако может висеть прямо над ним.

Стоимость

Каждый успешный запрос стоит 1 юнит независимо от длины окна. Ответ 202, пока данные готовятся, бесплатен; см. Готовность поля.

Что дальше

Изображения индексовПостройте изображение индекса на одну из этих дат.

Статистика индексовСтатистика сразу по всем датам окна.