Frequently Asked Questions

General

I want to send/retrieve data using an API that is not listed in the documentation. What should I do?

Please reach out to your Climate Corporation business team at partner@climate.com to discuss options.

Do you provide ongoing customer support once my implementation is live?

Yes absolutely! Partner and customer support will be handled by The Climate Corporation’s support team. More information about The Climate Corporation support team can be obtained at support.climate.com

Why should I sign up to be a partner with the Climate FieldView platform?

The Climate FieldView platform is one of the largest digital agriculture platforms in the world with more than 120 million acres and more than 100,000 farmers. Partners get the following benefits by creating new value by being on the platform.

 

  1. Gives partner solutions new applications & higher value
  2. Gets partner solutions in front of growers
  3. Powers partner tools with unique data collection capabilities
  4. Reduces redundant infrastructure investment
How does my company become a Climate FieldView™ platform partner?

Becoming a Climate FieldView platform partner is a simple 3 step process.

  1. Tell us more about your business and understand value creation on the platform.
  2. Talk to your Climate representative and agree on partner terms.
  3. Build and deploy

Just fill out the partner information form to get started

Do I have to pay to get a developer account on the platform?

You do not have to pay to get a developer account on the platform.

Where can I find documentation for current APIs?

You can find API documentation on the dev portal under the “Technical Docs” section.

What are The Climate Corporation’s business terms to access Climate FieldView data?

Please work with your Climate Corporation business team member to discuss terms. You can reach your Climate business team at partner@climate.com

I am concerned about my customer’s data. What data privacy protections do you provide?

The Climate Corporation takes customer data privacy very seriously. Please refer to The Climate Corporation’s existing policy at https://climate.com/legal/privacy-policy.

What kind of technical support do you provide when I am building against your APIs?

We want to make sure our partners have a great experience building against our APIs. We will provide technical support during the implementation process.

Agronomic Data APIs

Why am I not getting all the agronomic data after a specific date?

There could be many reasons why you are not able to see the expected data. Some of them are listed below:

  • The grower has not shared the operation with you.
  • There is more than one page of data and you are probably not fetching all the pages of the data.
  • The filter applied on the data is not matching any records.
  • You have already paged through all the records using x-next-token and there is no record left in the result set.
How do I know when new harvest/planting data is available?

You can use periodic polling to know when new planting or harvesting data is available. Once all results for a given query are fetched, an HTTP 304 response code is returned along with x-next-token. You can use the last x-next-token to poll periodically; if new results are available they will be returned.

How do I get agronomic data for a specific grower who has shared operation with me?

The agronomic data API takes resourceOwnerId as an optional parameter. This parameter represents a unique grower in Climate FieldView application. When this parameter is present, data for that grower is returned.

When I call the contents endpoint with a range larger than the total length, why am I getting a 206 response code instead of 200?

The current implementation can return 206 or 200 response code whether there is more data or not. You should look for 304 response code as an indicator that no more data is available. Alternatively, the agronomic activity result set returns the length of each activity. You can use the length of the activity to page through the contents of the activity.

What are the different steps to download agronomic data?

The following diagram shows high-level steps for downloading the agronomic data.

Upload APIs

Is there a way to name a non-satellite imagery that we are uploading?

Currently, there is no way to name the image you are uploading.

It seems that we can only upload one image for a given date/time. How can I upload multiple images?

You have the ability to upload multiple images to a given field for a given date/time as long as the contentType is different.

I have a few uploads for a grower that are showing success when sending to Climate, but are not showing for the grower?

When a file is successfully uploaded using the upload API, the file is only uploaded to a file store and processing is done later asynchronously. There could be many reasons why an upload is not showing up for a grower, some of them are listed below.

  • The image did not auto import and landed in the grower’s inbox. The grower will need to log into their account and import the image explicitly.
  • The image is uploaded successfully but failed during the processing phase. You can use the /v4/uploads/{uploadId}/status endpoint to check the status of the upload.
How does auto import for non-satellite imagery work?

The following are high-level details of how auto import works.

  1. If the image bounds match one existing field with overlap area greater than the threshold (currently set at 70%), the image is auto-imported.
  2. If the image bounds match one existing field with overlap area less than the threshold, the image will be in Data Inbox and the user will receive a notification email. The user would have to check Data Inbox and import the image.
  3. If the image bounds do not match any fields, a new field with the name new-field-<uuid> will be created and the image will be auto-imported.
  4. If the image bounds match multiple fields, the image will be in Data Inbox and the user will receive a notification email. The user would have to check Data Inbox, assign the appropriate field and import the image.