Usage

Prescription Files

Generate machine-readable prescription files (shapefile and ISOXML) for variable-rate application equipment based on existing vegetation index analyses.

Overview

Prescription files translate satellite analysis results into formats that can be loaded directly into precision agriculture equipment. The API generates two industry-standard formats:

  • Shapefile — A widely supported GIS format compatible with most farm management software.
  • ISOXML — The ISO 11783 standard format for direct import into ISOBUS-compatible machinery.

Prerequisite: A vegetation index analysis must already exist for the specified polygon and date before generating a prescription file. Run a vegetation index analysis first.

Process Prescription File

GraphQL Mutation
mutation { processPrescriptionFile( polygonId: "abc123-def456-ghi789" date: "2025-07-15" rate: 150 indexType: "NDVI" ) { Status Message Result { requestId } } }

Parameters

polygonId REQUIRED
The polygon to generate a prescription file for.
date REQUIRED
The specific date of the vegetation index analysis to use (YYYY-MM-DD).
rate REQUIRED
The target application rate (e.g., kg/ha of nitrogen).
indexType REQUIRED
The vegetation index the prescription is based on (e.g., "NDVI").

Retrieve Prescription File

GraphQL Query
query { retrievePrescriptionFile( polygonId: "abc123-def456-ghi789" startDate: "2025-07-01" endDate: "2025-07-31" ) { isoxml shapefile } }

Response Format

Field Description
isoxml URL to download the ISOXML prescription file for ISOBUS-compatible equipment.
shapefile URL to download the shapefile prescription for GIS software and farm management platforms.