Timeseries

By Variable

Provides a timeseries for a forecast by variable name for a specific location. The location is expressed as a latitude/longitude pair. The response includes basic statistics (maximum, minimum, mean, median, and mode) over the series.

GET /forecasts/{forecast-id}/variables/{variable-name}/timeseries/{latitude}/{longitude}

Optional Parameters

The default response contains all available valid times for the forecast variable.

Name Type Description Accepted Values / Range Example
start string UTC start time (ISO8601) any valid timestamp 2016-09-01T00:00:00Z
end string UTC end time (ISO8601) any valid timestamp 2016-09-01T12:00:00Z
limit number max number of results any positive integer 10

Request Example

See Headers for request header details.

$ curl -X GET http://model.api.wdtinc.com/forecasts/6b62039c-b4ee-45d4-b56a-ff1c211b5cec/variables/1hr-wind-speed/timeseries/35.482/-97.535

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "series": [
    {
      "validTime": "2016-09-01T00:00:00Z",
      "value": 16.2
    },
    {
      "validTime": "2016-09-01T03:00:00Z",
      "value": 17.4
    },
    {
      "validTime": "2016-09-01T06:00:00Z",
      "value": 18.0
    }
  ],
  "maximum": {
    "validTime": "2016-09-01T06:00:00Z",
    "value": 18.0
  },
  "minimum": {
    "validTime": "2016-09-01T00:00:00Z",
    "value": 16.1
  },
  "mean": 17.2,
  "median": 17.4,
  "mode": 16.2,
  "unit": {
    "description": "nautical miles per hour",
    "label": "kts"
  }
}