Solar Radiation

By Location

This provides the total amount of solar radiation within a user-defined timespan at a specific location. The location is represented by a latitude/longitude pair.

GET /solar-radiation/{latitude}/{longitude}

Query String Parameters (Optional)

The default response contains results in Watts per square meter for 24 hours ending at the time of the request. [1]

Name Type Description Accepted Values / Range Example
start string UTC start time start of 2015 to 5 days in the future 2015-06-01T00:00:00Z
end string UTC end time start of 2015 to 5 days in the future 2015-06-02T00:00:00Z

Request Example

See Headers for request header details.

$ curl -n -X GET "https://agriculture.api.wdtinc.com/solar-radiation/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,
  "startTime": "2015-06-01T00:00:00Z",
  "endTime": "2015-06-02T00:00:00Z",
  "solarRadiation": 164.1,
  "unit": "Watts per square meter"
}

By Field

This provides the total amount of solar radiation within a user-defined timespan at the centroid of a field, along with the area-weighted arithmetic mean and range of solar radiation over that field.

GET /solar-radiation/{field-uuid}

Query String Parameters (Optional)

The default response contains results in Watts per square meter for 24 hours ending at the time of the request. [1]

Name Type Description Accepted Values / Range Example
start string UTC start time start of 2015 to 5 days in the future 2015-06-01T00:00:00Z
end string UTC end time start of 2015 to 5 days in the future 2015-06-02T00:00:00Z

Request Example

See Headers for request header details.

$ curl -n -X GET "https://agriculture.api.wdtinc.com/solar-radiation/fe68c33d-e718-4449-acae-351072ce7749" \
-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",
  "startTime": "2015-06-01T00:00:00Z",
  "endTime": "2015-06-02T00:00:00Z",
  "solarRadiation": 164.1,
  "fieldMean": 164.1,
  "fieldMaximum": 166.8,
  "fieldMinimum": 161.9,
  "unit": "Watts per square meter",
  "contours": "/solar-radiation/fe68c33d-e718-4449-acae-351072ce7749/contours?start=2015-06-01T00:00:00Z&end=2015-06-02T00:00:00Z"
}

Contours By Field

This provides a contoured representation (GeoJSON) of the total amount of solar radiation within a user-defined timespan, clipped to a field boundary.

GET /solar-radiation/{field-uuid}/contours

Query String Parameters (Optional)

The default response contains results in Watts per square meter for 24 hours ending at the time of the request. [1]

Name Type Description Accepted Values / Range Example
start string UTC start time start of 2015 to 5 days in the future 2015-06-01T00:00:00Z
end string UTC end time start of 2015 to 5 days in the future 2015-06-02T00:00:00Z

Request Example

See Headers for request header details.

$ curl -n -X GET "https://agriculture.api.wdtinc.com/solar-radiation/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",
  "startTime": "2015-06-01T00:00:00Z",
  "endTime": "2015-06-02T00:00:00Z",
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [-102.3555, 39.8420], [-99.8945, 39.8420], ... ]
        ]
      },
      "properties": {
        "solarRadiation": 160.0
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [-102.3555, 39.8420], [-99.8945, 39.8420], ... ]
        ]
      },
      "properties": {
        "solarRadiation": 162.0
      }
    }
  ],
  "unit": "Watts per square meter"
}
[1](1, 2, 3) Timespans less than 48 hours are based on hourly accumulations. Longer timespans and dates prior to 2015 use 24-hour accumulations. Start and end times are rounded accordingly, if needed, and shown in the response.