Hourly Relative Humidity

Overview

Provides hourly relative humidity from June 01, 2016 up to 7 days in the future.

Location

Provides an hourly time series of relative humidity within a user-defined timespan at a specific location. The location is represented by a latitude/longitude pair.

GET /hourly-relative-humidity/{latitude}/{longitude}

Query String Parameters (Optional)

The default response contains results as a percentage for up to the next 24 hours.

Name Type Description Accepted Values / Range Example
start string start time June 01, 2016 to 7 days in the future 2016-06-01T00:00:00Z
end string end time (inclusive) June 01, 2016 to 7 days in the future 2016-06-01T03:00:00Z

Request Example

See Headers for request header details.

$ curl -X GET -G "https://insight.api.wdtinc.com/hourly-relative-humidity/35.482/-97.535" \
  -d start="2016-06-01T00:00:00Z" \
  -d end="2016-06-01T03:00:00Z" \
  -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,
  "startTime": "2016-06-01T00:00:00Z",
  "endTime": "2016-06-01T03:00:00Z",
  "unit": {
    "description": "Percentage",
    "label": "%"
  },
  "series": [
    {
      "validTime": "2016-06-01T00:00:00Z",
      "value": 97.8,
      "products": [
        "skywise-1hr-relative-humidity-analysis"
      ]
    },
    {
      "validTime": "2016-06-01T01:00:00Z",
      "value": 99.0,
      "products": [
        "skywise-1hr-relative-humidity-analysis"
      ]
    },
    {
      "validTime": "2016-06-01T02:00:00Z",
      "value": 100.0,
      "products": [
        "skywise-1hr-relative-humidity-analysis"
      ]
    },
    {
      "validTime": "2016-06-01T03:00:00Z",
      "value": 96.5,
      "products": [
        "skywise-1hr-relative-humidity-analysis"
      ]
    }
  ]
}

Asset

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

GET /hourly-relative-humidity/{asset-uuid}

Query String Parameters (Optional)

The default response contains results as a percentage for up to the next 24 hours.

Name Type Description Accepted Values / Range Example
start string start time June 01, 2016 to 7 days in the future 2016-06-01T00:00:00Z
end string end time (inclusive) June 01, 2016 to 7 days in the future 2016-06-01T03:00:00Z

Request Example

See Headers for request header details.

$ curl -X GET -G "https://insight.api.wdtinc.com/hourly-relative-humidity/fe68c33d-e718-4449-acae-351072ce7749" \
  -d start="2016-06-01T00:00:00Z" \
  -d end="2016-06-01T03:00:00Z" \
  -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",
  "startTime": "2016-06-01T00:00:00Z",
  "endTime": "2016-06-01T03:00:00Z",
  "unit": {
    "description": "Percentage",
    "label": "%"
  },
  "timeSeriesStatistics": {
    "mean": 96.2,
    "minimum": 85.5,
    "maximum": 99.0
  },
  "series": [
    {
      "validTime": "2016-06-01T00:00:00Z",
      "value": 97.0,
      "contours": "/hourly-relative-humidity/fe68c33d-e718-4449-acae-351072ce7749/contours?validTime=2016-06-01T00:00:00Z",
      "assetStatistics": {
        "mean": 97.0,
        "minimum": 90.5,
        "maximum": 99.0
      },
      "products": [
        "skywise-1hr-relative-humidity-analysis"
      ]
    },
    {
      "validTime": "2016-06-01T01:00:00Z",
      "value": 96.7,
      "contours": "/hourly-relative-humidity/fe68c33d-e718-4449-acae-351072ce7749/contours?validTime=2016-06-01T01:00:00Z",
      "assetStatistics": {
        "mean": 98.0,
        "minimum": 92.5,
        "maximum": 99.0
      },
      "products": [
        "skywise-1hr-relative-humidity-analysis"
      ]
    },
    {
      "validTime": "2016-06-01T02:00:00Z",
      "value": 95.5,
      "contours": "/hourly-relative-humidity/fe68c33d-e718-4449-acae-351072ce7749/contours?validTime=2016-06-01T02:00:00Z",
      "assetStatistics": {
        "mean": 95.0,
        "minimum": 85.5,
        "maximum": 98.0
      },
      "products": [
        "skywise-1hr-relative-humidity-analysis"
      ]
    },
    {
      "validTime": "2016-06-01T03:00:00Z",
      "value": 93.5,
      "contours": "/hourly-relative-humidity/fe68c33d-e718-4449-acae-351072ce7749/contours?validTime=2016-06-01T03:00:00Z",
      "assetStatistics": {
        "mean": 94.9,
        "minimum": 90.5,
        "maximum": 99.0
      },
      "products": [
        "skywise-1hr-relative-humidity-analysis"
      ]
    }
  ]
}

Contours By Asset

Provides a contoured representation (GeoJSON) of hourly relative humidity at a particular valid time, clipped to an asset boundary

GET /hourly-dewpoint/{asset-uuid}/contours

Query String Parameters (Optional)

The default response contains results as a percentage for up to the next 24 hours.

Name Type Description Accepted Values / Range Example
validTime string valid time June 01, 2016 to 7 days in the future 2016-06-01T00:00:00Z

Request Example

See Headers for request header details.

$ curl -X GET -G "https://insight.api.wdtinc.com/hourly-relative-humidity/fe68c33d-e718-4449-acae-351072ce7749/contours" \
  -d validTime="2016-06-01T00:00:00Z" \
  -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",
  "validTime": "2016-06-01T00:00:00Z",
  "unit": {
    "description": "Percentage",
    "label": "%"
  },
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [-102.3555, 39.8420], [-99.8945, 39.8420], ... ]
        ]
      },
      "properties": {
        "relativeHumidity": 30.0
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [-102.3555, 39.8420], [-99.8945, 39.8420], ... ]
        ]
      },
      "properties": {
        "relativeHumidity": 25.0
      }
    }
  ]
}