Growing Degree Days

By Location

This provides the growing degree days for a user-defined base temperature and date range at a specific location. The location is represented by a latitude/longitude pair.

GET /growing-degree-days/{latitude}/{longitude}

Query String Parameters (Optional)

The default response contains results starting and ending today, on a Celsius temperature scale, for a base temperature of 10 degrees.

Name Type Description Accepted Values / Range Example
base number base temperature any number 10.0
scale string temperature scale celsius, fahrenheit celsius
start string start date start of 2015 to 7 days in the future 2015-06-01
end string end date (inclusive) start of 2015 to 7 days in the future 2015-06-01

Request Example

See Headers for request header details.

$ curl -n -X GET "https://agriculture.api.wdtinc.com/growing-degree-days/35.482/-97.535" \
-H "Accept: application/vnd.wdt+json; version=1"

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "latitude": 35.482,
  "longitude": -97.535,
  "startDate": "2015-06-01",
  "endDate": "2015-06-01",
  "baseTemperature": 10.0,
  "scale": "Celsius",
  "degreeDays": 5.5
}

By Field

This provides the growing degree days for a user-defined base temperature and date range at the centroid of a field, along with the area-weighted arithmetic mean and range of growing degree days over that field.

GET /growing-degree-days/{field-uuid}

Query String Parameters (Optional)

The default response contains results starting and ending today, on a Celsius temperature scale, for a base temperature of 10 degrees.

Name Type Description Accepted Values / Range Example
base number base temperature any number 10.0
scale string temperature scale celsius, fahrenheit celsius
start string start date start of 2015 to 7 days in the future 2015-06-01
end string end date (inclusive) start of 2015 to 7 days in the future 2015-06-01

Request Example

See Headers for request header details.

$ curl -n -X GET "https://agriculture.api.wdtinc.com/growing-degree-days/fe68c33d-e718-4449-acae-351072ce7749?start=2015-06-01&end=2015-06-02" \
-H "Accept: application/vnd.wdt+json; version=1"

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "field": "/fields/fe68c33d-e718-4449-acae-351072ce7749",
  "startDate": "2015-06-01",
  "endDate": "2015-06-02",
  "baseTemperature": 10.0,
  "scale": "Celsius",
  "degreeDays": 11.7,
  "fieldMean": 11.6,
  "fieldMaximum": 12.1,
  "fieldMinimum": 11.1,
  "contours": "/growing-degree-days/fe68c33d-e718-4449-acae-351072ce7749/contours?start=2015-06-01&end=2015-06-02"
}

Contours By Field

This provides a contoured representation (GeoJSON) of growing degree days for a user-defined base temperature and date range, clipped to a field boundary.

GET /growing-degree-days/{field-uuid}/contours

Query String Parameters (Optional)

The default response contains results starting and ending today, on a Celsius temperature scale, for a base temperature of 10 degrees.

Name Type Description Accepted Values / Range Example
base number base temperature any number 10.0
scale string temperature scale celsius, fahrenheit celsius
start string start date start of 2015 to 7 days in the future 2015-06-01
end string end date (inclusive) start of 2015 to 7 days in the future 2015-06-01

Request Example

See Headers for request header details.

$ curl -n -X GET "https://agriculture.api.wdtinc.com/growing-degree-days/fe68c33d-e718-4449-acae-351072ce7749/contours" \
-H "Accept: application/vnd.wdt+json; version=1"

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "field": "/fields/fe68c33d-e718-4449-acae-351072ce7749",
  "startDate": "2015-06-01",
  "endDate": "2015-06-01",
  "baseTemperature": 10.0,
  "scale": "Celsius",
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [-102.3555, 39.8420], [-99.8945, 39.8420], ... ]
        ]
      },
      "properties": {
        "degreeDays": 4.0
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [-102.3555, 39.8420], [-99.8945, 39.8420], ... ]
        ]
      },
      "properties": {
        "degreeDays": 5.0
      }
    }
  ]
}