TerraClim API Documentation

Endpoint Detail: Point

This page provides detailed information about the /point endpoint. This is used to query data from a point location on a raster layer.

The TerraClim layers can be queried by providing a point WKT string in WGS84 format. Multiple points should be separated by ; (semicolon), while queries are limited to a maximum of 10 points each.

The valid dataTypes are listed below, along with the available sub data types per variable, what dates are available, what date range to use, and the available extent for a variable,

Data type Sub data type Date range & format Extent
temp
  • min
  • max
  • mean
  • Daily
  • Daily
  • Daily
TerraClim extent
gdd
  • apples
  • citrus
  • grapes
  • Annual
  • Annual
  • Annual
TerraClim extent
chill
  • ucu
  • ucui
  • dpcu
  • dpcui
  • Annual
  • Annual
  • Annual
  • Annual
TerraClim extent
frost - Monthly TerraClim extent
rain (long term layers) monthly_median - monthly_median: 12 long term layers (1 to 12 representing each month) SA extent
windspeed 20, 50, 100, 150 Single layer per height (not dated) SA extent


Point GDD Request

      POST https://api.terraclim.co.za/api/point/
        {
          "dataType": "gdd",
          "options": {
            "subDataType": "apples",
            "timeScale": "annual",
            "dataExtent": "tc"
          },
          "wkts": "POINT(19.014587 -33.642063)",
          "startDate": "2016",
          "endDate": "2017"
        }

Point GDD Response

      Status: OK (200)
        Content-Type: application/json

        {
          "POINT(19.014587 -33.642063)": {
            "2016": 2643.92822265625,
            "2017": 2435.8935546875
          }
        }

Point Temp Mean Request

      
        POST https://api.terraclim.co.za/api/point/
        {
          "dataType": "temp",
          "options": {
            "subDataType": "mean",
            "timeScale": "daily",
            "dataExtent": "tc"
          },
          "wkts": "POINT(19.014587 -33.642063);POINT(19.123755 -33.342063)",
          "startDate": "2016-01-01",
          "endDate": "2016-01-04"
        }

Point Temp Mean Response

      
        Status: OK (200)
        Content-Type: application/json

        {
          "POINT(19.014587 -33.642063)": {
            "2016-01-01": 26.61680030822754,
            "2016-01-02": 26.679847717285156,
            "2016-01-03": 28.179224014282227,
            "2016-01-04": 29.097129821777344
          },
          "POINT(19.123755 -33.342063)": {
            "2016-01-01": 27.90815544128418,
            "2016-01-02": 27.686288833618164,
            "2016-01-03": 29.220434188842773,
            "2016-01-04": 29.34918212890625
          }
        }