Fields & Plantings

You are here:
< All Topics
image_pdfDownload as PDF

Manage Field Locations and Planting Information

Fields are how you manage the locations for which you’re tracking weather, agronomics, models, and progress over growing seasons. By registering a field, you create a quick way to consistently reference locations across all our APIs, and allow our modeling APIs to better operate and tune to the conditions and status of each specific field. A Planting is the record of a crop’s season in a given field, and is where you tell the platform about what is planted there and when it was planted.

▶ Get a List of Fields or a Specific Field #

Use this API to retrieve the fields associated with your account, or if you know the specific field ID you can use it to get a single record. This API is referenced by most other APIs. | View Documentation 

GET /v2/fields
GET /v2/fields/{fieldId}

▶ Create a Field Location #

This API will register a field location in the aWhere platform. This is a one-time operation for each field. | View Documentation 

POST /v2/fields

▶ Update a Field Location #

You can update the field name and associated farm ID using this API. | View Documentation 

PATCH /v2/fields/{fieldId}

▶ Delete a Field Location #

Occasionally it is necessary to remove a field from your account, such as when you need to refine the geolocation. | View Documentation 

DELETE /v2/fields/{fieldId}

▶ Get a List of Plantings or Single Planting #

Use this API to retrieve all the plantings associated with your account or with a specific field. If you know the specific planting ID you can use it to get a single record. There is also a short cut to only retrieve the current planting for the field without knowing its ID. This API is used by the Agronomics and Modeling APIs. | View Documentation 

GET /v2/agronomics/plantings
GET /v2/agronomics/plantings/{plantingId}
GET /v2/agronomics/plantings/current
GET /v2/agronomics/fields/{fieldId}/plantings
GET /v2/agronomics/fields/{fieldId}/plantings/{plantingId}
GET /v2/agronomics/fields/{fieldId}/plantings/current

▶ Create a Planting #

Use this API to create a planting. Only one planting can be active for a field at any time. | View Documentation 

POST /v2/agronomics/plantings

▶ Update All or Part of a Planting #

Use this API to update a planting. This API supports both updating a whole planting or patching specific properties of the record. | View Documentation 

PUT /v2/agronomics/fields/{fieldId}/plantings/{plantingId}
PUT /v2/agronomics/fields/{fieldId}/plantings/current
PATCH /v2/agronomics/fields/{fieldId}/plantings/{plantingId}
PATCH /v2/agronomics/fields/{fieldId}/plantings/current

▶ Delete a Planting #

Use this API to delete a planting. | View Documentation 

DELETE /v2/agronomics/fields/{fieldId}/plantings/{plantingId}
DELETE /v2/agronomics/fields/{fieldId}/plantings/current

Was this article helpful?
4.5 out Of 5 Stars
5 Stars 0%
4 Stars 100%
3 Stars 0%
2 Stars 0%
1 Stars 0%
How can we improve this article?
Table of Contents