Forecasts

A forecast is a series of frames progressing forward in time for a particular product.

The time at which a forecast’s initial conditions are valid is called its initialization time. This helps distinguish one forecast from another.


Forecast List

GET /v2/products/{product-id-or-name}/forecasts.json

Optional Parameters

A product may have hundreds of forecasts. The default response contains the 3 latest forecasts for the product in ascending order.

Use the start, end, or limit parameter to obtain a different number of results. When start and end are both specified, limit has no effect–the response contains all available forecasts in the time range.

Name Type Description Accepted Values / Range Example
start string start of time range of interest any ISO8601 timestamp 2016-06-01T00:00:00Z
end string end of time range of interest any ISO8601 timestamp 2016-06-02T00:00:00Z
limit number max number of results any positive integer 3
sort string sort order asc, desc asc

Request Examples

See Headers for request header details.

$ curl -n https://skywise-tiles.api.wdtinc.com/v2/products/17082fec-e9fe-11e4-b02c-1681e6b88ec1/forecasts.json
$ curl -n https://skywise-tiles.api.wdtinc.com/v2/products/weatherops-24hr-high-temperature-forecast/forecasts.json

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
[
  {
    "id": "9318fe5c-2ea8-4c5c-b930-4ae81a89776f",
    "initTime": "2016-06-01T00:00:00Z",
    "creationTime": "2016-06-01T00:01:35Z",
    "expirationTime": "2016-06-09T00:00:00Z",
    "frames": "/v2/forecasts/9318fe5c-2ea8-4c5c-b930-4ae81a89776f/frames.json",
    "productId": "17082fec-e9fe-11e4-b02c-1681e6b88ec1"
  },
  {
    "id": "92267afc-1e72-4408-a94b-62b40881ea4e",
    "initTime": "2016-06-01T06:00:00Z",
    "creationTime": "2016-06-01T06:01:32Z",
    "expirationTime": "2016-06-09T06:00:00Z",
    "frames": "/v2/forecasts/92267afc-1e72-4408-a94b-62b40881ea4e/frames.json",
    "productId": "17082fec-e9fe-11e4-b02c-1681e6b88ec1"
  }
]

Forecast Information

GET /v2/forecasts/{forecast-id}.json

Request Examples

See Headers for request header details.

$ curl -n https://skywise-tiles.api.wdtinc.com/v2/forecasts/9318fe5c-2ea8-4c5c-b930-4ae81a89776f.json

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "id": "9318fe5c-2ea8-4c5c-b930-4ae81a89776f",
  "initTime": "2016-06-01T00:00:00Z",
  "creationTime": "2016-06-01T00:01:35Z",
  "expirationTime": "2016-06-09T00:00:00Z",
  "frames": "/v2/forecasts/9318fe5c-2ea8-4c5c-b930-4ae81a89776f/frames.json",
  "productId": "17082fec-e9fe-11e4-b02c-1681e6b88ec1"
}