Daily High Temperature

Location

Provides a daily climatological high temperature time series within a user-defined timespan at a specific location. The location is represented by a latitude/longitude pair.

GET /climatology/daily-high-temperature/{latitude}/{longitude}

Query String Parameters (Optional)

The default response contains results on a Celsius temperature scale for 30 year climatological results based on the current day.

Name Type Description Accepted Values / Range Example
unit string temperature unit celsius, fahrenheit celsius
start string start date a valid ISO 8601 month and day 06-01
end string end date (inclusive) a valid ISO 8601 month and day 06-03
years number number of years for aggregation 10 or 30 30

Request Example

See Headers for request header details.

$ curl -X GET -G "https://insight.api.wdtinc.com/climatology/daily-high-temperature/35.482/-97.535" \
  -d start="06-01" \
  -d end="06-03" \
  -H "Accept: application/vnd.wdt+json; version=1" \
  --user <username>:<password>

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "latitude": 35.482,
  "longitude": -97.535,
  "startDate": "06-01",
  "endDate": "06-03",
  "unit": {
    "description": "degrees celsius",
    "label": "°C"
  },
  "series": [
    {
      "validDate": "06-01",
      "value": 34.2,
      "products": [
        "skywise-global-30yr-daily-temperature-max"
      ]
    },
    {
      "validDate": "06-02",
      "value": 35.1,
      "products": [
        "skywise-global-30yr-daily-temperature-max"
      ]
    },
    {
      "validDate": "06-03",
      "value": 36.2,
      "products": [
        "skywise-global-30yr-daily-temperature-max"
      ]
    }
  ]
}

Asset

Provides a daily climatological time series for high temperature within a user-defined timespan at the centroid of an asset, along with the area-weighted arithmetic mean and range of temperature over that asset. Time series values are for the centroid of the asset.

GET /climatology/daily-high-temperature/{asset-uuid}

Query String Parameters (Optional)

The default response contains results on a Celsius temperature scale for 30 year climatological results based on the current day.

Name Type Description Accepted Values / Range Example
unit string temperature unit celsius, fahrenheit celsius
start string start date a valid ISO 8601 month and day 06-01
end string end date (inclusive) a valid ISO 8601 month and day 06-03
years number number of years for aggregation 10 or 30 30

Request Example

See Headers for request header details.

$ curl -X GET -G "https://insight.api.wdtinc.com/climatology/daily-high-temperature/fe68c33d-e718-4449-acae-351072ce7749" \
  -d start="06-01" \
  -d end="06-03" \
  -H "Accept: application/vnd.wdt+json; version=1" \
  --user <username>:<password>

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "asset": "/assets/fe68c33d-e718-4449-acae-351072ce7749",
  "startDate": "06-01",
  "endDate": "06-03",
  "contours": "/climatology/daily-high-temperature/fe68c33d-e718-4449-acae-351072ce7749/contours?start=06-01&end=06-03",
  "unit": {
    "description": "degrees celsius",
    "label": "°C"
  },
  "timeSeriesStatistics": {
    "mean": 34.3,
    "minimum": 31.0,
    "maximum": 37.0
  },
  "series": [
    {
      "validDate": "06-01",
      "value": 34.4,
      "contours": "/climatology/daily-high-temperature/fe68c33d-e718-4449-acae-351072ce7749/contours?start=06-01&end=06-01",
      "assetStatistics": {
        "mean": 34.3,
        "maximum": 35.0,
        "minimum": 32.0
      },
      "products": [
        "skywise-global-30yr-daily-temperature-max"
      ]
    },
    {
      "validDate": "06-02",
      "value": 33.2,
      "contours": "/climatology/daily-high-temperature/fe68c33d-e718-4449-acae-351072ce7749/contours?start=06-02&end=06-02",
      "assetStatistics": {
        "mean": 34.5,
        "maximum": 34.9,
        "minimum": 31.0
      },
      "products": [
        "skywise-global-30yr-daily-temperature-max"
      ]
    },
    {
      "validDate": "06-03",
      "value": 33.5,
      "contours": "/climatology/daily-high-temperature/fe68c33d-e718-4449-acae-351072ce7749/contours?start=06-03&end=06-03",
      "assetStatistics": {
        "mean": 34.3,
        "maximum": 37.0,
        "minimum": 32.0
      },
      "products": [
        "skywise-global-30yr-daily-temperature-max"
      ]
    }
  ]
}

Contours By Asset

Provides a contoured representation (GeoJSON) of climatological high temperatures over a date range, clipped to an asset boundary.

GET /climatology/daily-high-temperature/{asset-uuid}/contours

Query String Parameters (Optional)

The default response contains results on a Celsius temperature scale for climatological results based on the current day.

Name Type Description Accepted Values / Range Example
unit string temperature unit celsius, fahrenheit celsius
start string start date a valid ISO 8601 month and day 06-01
end string end date (inclusive) a valid ISO 8601 month and day 06-03
years number number of years for aggregation 10 or 30 30

Request Example

See Headers for request header details.

$ curl -X GET -G "https://insight.api.wdtinc.com/climatology/daily-high-temperature/fe68c33d-e718-4449-acae-351072ce7749/contours" \
  -d start="06-01" \
  -d end="06-03" \
  -H "Accept: application/vnd.wdt+json; version=1" \
  --user <username>:<password>

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "asset": "/assets/fe68c33d-e718-4449-acae-351072ce7749",
  "startDate": "06-01",
  "endDate": "06-03",
  "unit": {
    "description": "degrees celsius",
    "label": "°C"
  },
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [-102.3555, 39.8420], [-99.8945, 39.8420], ... ]
        ]
      },
      "properties": {
        "highTemperature": 37.0
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [-102.3555, 39.8420], [-99.8945, 39.8420], ... ]
        ]
      },
      "properties": {
        "highTemperature": 34.0
      }
    }
  ]
}