Products

A product is a geospatial entity, such as global temperature or U.S. radar reflectivity, from a particular source. It can be discovered by its source, its content type, its aggregation period (such as 60-minute accumulation or 24-hour maximum), a time range of interest, and/or a location or area of interest.

Each product’s data is divided into frames. Some products have forecasts. Most products have styles and styleable layers.


Product List

GET /products

Optional Parameters

The default response contains all products for which the API account is authorized. Use any of the following parameters to filter the response.

Use start and end to exclude products with no frames in the time range of interest. Use coverage to exclude products that do not contain the location or area of interest.

Name Type Description Accepted Values / Range Example
contentType string content type any string reflectivity
source string source name any string wdssii
aggregation number aggregation period in minutes any nonnegative integer 60
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
coverage string location or area of interest WGS84 GeoJSON geometry %7B%22type%22%3A%22Point%22%2C%22coordinates%22%3A%5B-97.44%2C35.22%5D%7D

Request Examples

See Headers for request header details.

$ curl -n -X GET https://platform.api.wdtinc.com/products \
-H "Accept: application/vnd.wdt+json; version=1"

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
[
  {
    "id": "7d8f1c29-35cd-4028-b034-509fcf48cdf0",
    "name": "weatherops-24hr-high-temperature-forecast",
    "description": "WeatherOps 24-hour high temperature forecast",
    "contentType": "high-temperature",
    "source": "weatherops",
    "startTime": "2016-06-01T00:00:00Z",
    "endTime": "2016-12-01T00:00:00Z",
    "aggregationPeriodInMinutes": 1440,
    "coverage": {
      "type": "Feature",
      "geometry": {
        "type": "MultiPolygon",
        "coordinates": [
          [
            [[-180.0, -90.0], [180.0, -90.0], [180.0, 90.0], [-180.0, 90.0], [-180.0, -90.0]]
          ]
        ]
      }
    },
    "frames": null,
    "forecasts": "/products/7d8f1c29-35cd-4028-b034-509fcf48cdf0/forecasts",
    "styles": "/products/7d8f1c29-35cd-4028-b034-509fcf48cdf0/styles",
    "styleableLayers": [
      {
        "name": "temperature",
        "type": "raster",
        "unit": {
          "description": "degrees Celsius",
          "label": "°C"
        },
        "attributes": []
      }
    ]
  },
  {
    "id": "4a79aeab-84f0-4dde-ae39-a20b4ccee878",
    "name": "skywise-base-reflectivity",
    "description": "SkyWise WDSSII base reflectivity mosaic",
    "contentType": "reflectivity",
    "source": "wdssii",
    "startTime": "2016-05-31T00:00:00Z",
    "endTime": "2016-06-01T00:00:00Z",
    "aggregationPeriodInMinutes": 0,
    "coverage": {
      "type": "Feature",
      "geometry": {
        "type": "MultiPolygon",
        "coordinates": [
          [
            [[-120.49, 22.84], [-81.24, 20.09], [-60.83, 45.99], [-136.45, 52.46], [-120.49, 22.84]]
          ]
        ]
      }
    },
    "frames": "/products/4a79aeab-84f0-4dde-ae39-a20b4ccee878/frames",
    "forecasts": null,
    "styles": "/products/4a79aeab-84f0-4dde-ae39-a20b4ccee878/styles",
    "styleableLayers": [
      {
        "name": "reflectivity",
        "type": "raster",
        "unit": {
          "description": "decibels relative to Z",
          "label": "dBZ"
        },
        "attributes": []
      },
      {
        "name": "precip_mask",
        "type": "raster",
        "unit": null,
        "attributes": [
          {
            "name": "rain",
            "value": 1,
            "unit": null
          },
          {
            "name": "sleet",
            "value": 2,
            "unit": null
          },
          {
            "name": "freezing rain",
            "value": 4,
            "unit": null
          },
          {
            "name": "snow",
            "value": 8,
            "unit": null
          }
        ]
      }
    ]
  }
]

Product Information

GET /products/{product-id-or-name}

Request Examples

See Headers for request header details.

$ curl -n -X GET https://platform.api.wdtinc.com/products/4a79aeab-84f0-4dde-ae39-a20b4ccee878 \
-H "Accept: application/vnd.wdt+json; version=1"
$ curl -n -X GET https://platform.api.wdtinc.com/products/skywise-base-reflectivity \
-H "Accept: application/vnd.wdt+json; version=1"

Response Example

See Status Codes for response code details.

HTTP/1.1 200 OK
{
  "id": "4a79aeab-84f0-4dde-ae39-a20b4ccee878",
  "name": "skywise-base-reflectivity",
  "description": "SkyWise WDSSII base reflectivity mosaic",
  "contentType": "reflectivity",
  "source": "wdssii",
  "startTime": "2016-05-31T00:00:00Z",
  "endTime": "2016-06-01T00:00:00Z",
  "aggregationPeriodInMinutes": 0,
  "coverage": {
    "type": "Feature",
    "geometry": {
      "type": "MultiPolygon",
      "coordinates": [
        [
          [[-120.49, 22.84], [-81.24, 20.09], [-60.83, 45.99], [-136.45, 52.46], [-120.49, 22.84]]
        ]
      ]
    }
  },
  "frames": "/products/4a79aeab-84f0-4dde-ae39-a20b4ccee878/frames",
  "forecasts": null,
  "styles": "/products/4a79aeab-84f0-4dde-ae39-a20b4ccee878/styles",
  "styleableLayers": [
    {
      "name": "reflectivity",
      "type": "raster",
      "unit": {
        "description": "decibels relative to Z",
        "label": "dBZ"
      },
      "attributes": []
    },
    {
      "name": "precip_mask",
      "type": "raster",
      "unit": null,
      "attributes": [
        {
          "name": "rain",
          "value": 1,
          "unit": null
        },
        {
          "name": "sleet",
          "value": 2,
          "unit": null
        },
        {
          "name": "freezing rain",
          "value": 4,
          "unit": null
        },
        {
          "name": "snow",
          "value": 8,
          "unit": null
        }
      ]
    }
  ]
}