Agriculture Croptype Lookup

Overview

The TWC Agriculture APIs provide a variety of business-ready forecast content for the agriculture markets, by generating it on-the-fly using proprietary wxmix technology from The Weather Company | An IBM® Business (TWC). Agriculture product includes reference and modeled evapotranspiration. The hourly forecast starts at top of current hour and extends through the entire length of available forecast output (currently 15 days, including the current day).

HTTP Headers and Data Lifetime - Caching and Expiration

For details on appropriate header values as well as caching and expiration definitions, please see The Weather Company Data | API Common Usage Guide.

Pre-Request Utility API Call

Prior to the primary request, the following call will first be made to expose the list of valid crop type parameters:

Atomic Request: Valid Crop Types: Required Parameters: apiKey

https://api.weather.com/v3/wx/forecast/agriculture/croptype?format=json&apiKey=yourApiKey

URL Construction

Atomic API URL Examples:

Atomic Request by Geocode: Required Parameters: geocode, format, units, apiKey | Optional Parameters: soilDepth, crop, elevation

https://api.weather.com/v3/wx/forecast/hourly/agriculture/15day?geocode=33.74,-84.39&format=json&units=e&apiKey=yourApiKey

Parameter Definitions

Valid Crop Type Parameters and Utility API

Common crop types include:

• cacao
• coffee
• corn
• cotton
• soybeans
• sugarcane
• wheat

A full list of valid crop type values can be found by calling the croptype utility API, which will return a full list of valid crop type parameter values:

Atomic Request: Valid Crop Types: Required Parameters: apiKey

https://api.weather.com/v3/wx/forecast/agriculture/croptype?format=json&apiKey=yourApiKey

Data Elements & Definitions

Note: The table below does not represent the sort order of the API response.

JSON Sample

// Response Collapsed for Presentation Purposes
{
    "metadata": {
        "procTime": 1560965651,
        "units": "m",
        "serviceTime": 0.01315416,
        "latitude": 39.6300,
        "longitude": -105.0100,
        "initTimeUtc": 1560963600,
        "elevation": 1622.70,
        "landuse": 1,
        "resource": "agriculture",
        "version": "v1",
        "requestId": 1042340000000056,
        "soilDepth": 120.000,
        "crop": "soybeans:75"
    },
    "forecasts1Hour": {
        "validTimeUtc": [1560963600,...],
        "soilMoisture": [0.256,...],
        "soilTemperature": [284.3,...],
        "temperatureInversion": [-6.61,...],
        "evapotranspirationRef": [0.570,... ],
        "evapotranspirationModel": [0.228,...],
        "evapotranspirationCrop": [0.656,...],
    }
}

Units for Metric and English Request and Response