Юниты и гектары

Оплата API идёт по договору и счёту: карта не привязывается, автоматических списаний нет. Договор учитывает использование в юнитах, в гектарах или и в том и в другом:

Режим договора	Что ограничено
Юниты	Спутниковые запросы расходуют юниты из месячной квоты.
Гектары	Зарегистрированные поля расходуют площадь из гектаров по договору.
Оба	Действуют оба ограничения.

Режим и лимиты устанавливает ваш контакт в AgroSat. Текущее использование владелец видит в веб-приложении.

Юниты

Каждый успешный спутниковый ответ расходует юниты и сообщает их число в заголовке X-AgroSat-Units. С коэффициентами по умолчанию:

Запрос	Юниты
GET /v1/fields/{id}/image	ceil(area_ha)
GET /v1/fields/{id}/statistics	ceil(area_ha × число_дат / 10)
GET /v1/fields/{id}/dates	1
Запросы к полям и GET /v1/ping	0

Каждый успешный спутниковый запрос стоит не меньше 1 юнита, кроме ответа статистики без дат: он стоит 0. Договор может задавать другие коэффициенты; заголовок всегда показывает фактическое списание.

Для поля площадью 42,3 га:

• одно изображение, PNG или GeoTIFF, стоит ceil(42,3) = 43 юнита;
• статистика за 6 дат стоит ceil(42,3 × 6 / 10) = 26 юнитов;
• один запрос дат стоит 1 юнит.

Что никогда не оплачивается

• Ответы 202 data_pending.
• Любые ошибки: 4xx и 5xx, включая 429 rate_limited.
• Ответ статистики без дат в data.

Месячная квота

В режимах «юниты» и «оба» юниты считаются за календарный месяц по UTC. Когда юниты за текущий месяц достигают квоты, спутниковые запросы получают 403 quota_exceeded до первого числа следующего месяца или пока AgroSat не увеличит квоту. Запросы, которые уже выполнялись в момент достижения квоты, могут её немного превысить. Запросы к полям продолжают работать.

Гектары

В режимах «гектары» и «оба» каждая регистрация списывает площадь поля из гектаров текущего периода договора.

Гектары не возвращаются

Удаление поля не возвращает его площадь, уменьшение тоже. Если поле потом увеличить, списывается только прирост сверх наибольшей площади, которая у него когда-либо была. Израсходованные гектары обнуляются, только когда AgroSat начинает новый период договора.

Например, при 1000 гектаров по договору:

1. Вы регистрируете поле на 500 га: израсходовано 500 га, осталось 500 га.
2. Вы удаляете его: израсходовано по-прежнему 500 га.
3. Вы регистрируете поле на 30 га: израсходовано 530 га, осталось 470 га.

Регистрация, которая не помещается в остаток гектаров, завершается ошибкой 403 quota_exceeded, и поле не создаётся. Поля, которые ваша организация ведёт в веб-приложении AgroSat, учитываются в том же объёме.

Лимиты договора

Лимит	По умолчанию	Ошибка при превышении
Юниты в месяц	Задаётся в договоре	403 quota_exceeded
Гектары по договору	Задаётся в договоре	403 quota_exceeded при регистрации
Площадь одного поля	5000 га	400 field_too_large
Запросов в минуту на ключ	60	429 rate_limited
Действующих API-ключей	2	Веб-приложение не даст создать ключ
Самая ранняя дата истории	Задаётся в договоре	400 date_out_of_range

Что дальше

Использование в порталеГде смотреть юниты, гектары и лимиты.

Лимиты частотыЧастота запросов на ключ и ответ 429.