Usage

Usage Overview

The Agdir Satellite API offers a comprehensive suite of satellite-based analytics organized into three categories: vegetation indices, Agdir services, and satellite data.

Vegetation Indices

Standard remote sensing indices calculated from satellite imagery. These are the foundation for understanding crop and soil conditions.

  • Plant Health (NDVI) — Normalized Difference Vegetation Index. Measures overall vegetation vigor and photosynthetic activity.
  • Water Stress (NDWI) — Normalized Difference Water Index. Detects moisture content in vegetation and soil.
  • Vegetation Indices — Access 9 different indices (NDVI, NDWI, MSAVI2, LAI, NDRE, EVI, EVI2, RVI, GNDVI) through a single flexible endpoint.
  • Daily Vegetation Estimates — ML-based gap filling that generates daily index values between satellite passes.

Agdir Services

Advanced analytics powered by machine learning models trained on field measurements and satellite data.

  • Crude Protein — Total protein content in plant material. Part of the Forage Grass analysis suite for livestock feed quality.
  • Dry Matter Content — Plant material remaining after moisture removal. Key indicator for harvest timing and feed quality.
  • Soil Organic Carbon — Organic carbon content in the top 10 cm of soil using AI neural networks.
  • Soil Moisture — Soil water status for irrigation management and early detection of water issues.
  • Biomass — Forage grass biomass estimation using Sentinel-2 imagery combined with ML and field measurements.
  • Nitrogen Zoning — Variable-rate application zones based on within-field variability. Supports 1, 3, or 5 zone segmentation.
  • Potato Analyses — Specialized suite for potato crops: yield prediction, starch content, disease prediction, and leaf nitrogen.

Satellite Data & Utilities

Direct access to satellite imagery and supporting tools.

  • Satellite Data Download — Pre-download raw Sentinel optical and radar data to accelerate analysis.
  • Prescription Files — Generate shapefile and ISOXML prescription files for variable-rate machinery.
  • Weather Information — Current conditions and daily forecasts based on polygon location.
  • Processing Units — Billing and usage tracking for premium services like daily vegetation estimates.

Common Pattern

Most services follow the same pattern:

  1. Call a process*() mutation to start the analysis.
  2. Monitor the request status until it reaches Success.
  3. Call the corresponding retrieve*() query to get results.

See the Getting Started guide for a complete walkthrough of this workflow.