Обзор AgroSat API

AgroSat API отдаёт вашему приложению спутниковые данные по полям, с которыми оно работает: в какие дни над полем есть снимки, как индекс вегетации, например NDVI, меняется за сезон, и карту этого индекса на любую из этих дат.

API рассчитан на компании, которые разрабатывают ПО для сельского хозяйства и хотят показывать состояние посевов в своём продукте, не строя собственную спутниковую обработку. Вы один раз передаёте границу поля, а AgroSat находит снимки, маскирует облака, считает статистику и строит изображения.

Что можно делать

Регистрировать поля

Передайте границу в GeoJSON и свой идентификатор external_id. AgroSat сразу начинает готовить историю поля.

Получать даты снимков

Узнавайте, в какие дни спутник снял поле и какой была облачность каждой сцены.

Читать статистику индексов

Среднее, медиана, процентили, доля чистых и облачных пикселей на каждую дату по 11 индексам вегетации.

Скачивать изображения индексов

Цветной PNG для карты или GeoTIFF float32 со значениями индекса для собственного анализа.

Как это работает

1. Владелец вашей организации в AgroSat создаёт API-ключ в веб-приложении, в разделе Настройки → API-ключи.

2. Ваш бэкенд регистрирует каждое поле запросом POST /v1/fields.

3. AgroSat готовит снимки и статистику начиная с 1 января прошлого года. Пока поле не готово, запросы данных возвращают 202 data_pending, и это бесплатно.

4. Ваш бэкенд получает даты, статистику и изображения. Каждый успешный спутниковый ответ сообщает израсходованные юниты в заголовке X-AgroSat-Units.

Источники данных

Источник	Значение source	Кому доступен
Sentinel-2 (Copernicus)	sentinel-2 (по умолчанию)	Любой организации с доступом к API
PlanetScope	planet	Организациям с отдельным договором на Planet

Соглашения

• Базовый URL: https://api.agrosat.uz/v1.
• Каждый запрос передаёт ключ в заголовке X-API-Key.
• JSON-ответы имеют вид {"success": true, "data": …}, а при ошибке {"success": false, "error": {"code": …, "message": …}}. Изображения приходят как файл.
• Даты в формате YYYY-MM-DD. Координаты в WGS84, порядок: долгота, широта.
• API видит только поля, зарегистрированные через API. Поля, которые ваша команда рисует в веб- или мобильном приложении AgroSat, здесь не появляются.

Вызывайте API со своего сервера

API предназначен для обмена между серверами. Браузер может обращаться к нему только с этого сайта документации, а ключ, встроенный в веб-страницу или мобильное приложение, может скопировать любой, у кого оно есть.

Что дальше

Быстрый стартПервый запрос и NDVI по полю за несколько минут.

Аутентификация и API-ключиСоздание, хранение, замена и отзыв ключей.

Статистика индексовДинамика индекса и значение каждого поля ответа.

Справочник APIВсе эндпоинты, параметры и ответы (на английском).