Daily Precipitation

Overview

Provides daily precipitation from the start of 2015 up to 7 days in the future.

By Location

Provides the total amount of daily precipitation along with a daily time series within a user-defined timespan. The location is represented by a latitude/longitude pair.

GET /daily-precipitation/{latitude}/{longitude}

Query String Parameters (Optional)

The default response contains results in millimeters for up to the next 6 days.

Name Type Description Accepted Values / Range Example
start string start date start of 2015 to 7 days in the future 2015-06-01
end string end date start of 2015 to 7 days in the future 2015-06-03
unit string unit of measure inches, millimeters inches

Request Example

See Headers for request header details.

$ curl -X GET -G "https://insight.api.wdtinc.com/daily-precipitation/35.482/-97.535" \
  -d start="2015-06-01" \
  -d end="2015-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": "2015-06-01",
  "endDate": "2015-06-03",
  "precipitation": 22.5,
  "unit": {
    "description": "millimeters",
    "label": "mm"
  },
  "series": [
    {
      "validDate": "2015-06-01",
      "value": 11.25,
      "products": [
        "skywise-24hr-precipitation-analysis"
      ]
    },
    {
      "validDate": "2015-06-02",
      "value": 5.25,
      "products": [
        "skywise-24hr-precipitation-analysis"
      ]
    },
    {
      "validDate": "2015-06-03",
      "value": 6.0,
      "products": [
        "skywise-24hr-precipitation-analysis"
      ]
    }
  ]
}

By Asset

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

GET /daily-precipitation/{asset-uuid}

Query String Parameters (Optional)

The default response contains results in millimeters for up to the next 6 days.

Name Type Description Accepted Values / Range Example
start string start date start of 2015 to 7 days in the future 2015-06-01
end string end date start of 2015 to 7 days in the future 2015-06-03
unit string unit of measure inches, millimeters inches

Request Example

See Headers for request header details.

$ curl -X GET -G "https://insight.api.wdtinc.com/daily-precipitation/fe68c33d-e718-4449-acae-351072ce7749" \
  -d start="2015-06-01" \
  -d end="2015-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": "2015-06-01",
  "endDate": "2015-06-03",
  "precipitation": 22.5,
  "accumulationStatistics": {
     "mean": 21.5,
     "maximum": 27.6,
     "minimum": 19.4
  },
  "unit": {
    "description": "millimeters",
    "label": "mm"
  },
  "contours": "/daily-precipitation/fe68c33d-e718-4449-acae-351072ce7749/contours?start=2015-06-01&end=2015-06-03",
  "series": [
    {
      "validDate": "2015-06-01",
      "value": 11.25,
      "contours": "/daily-precipitation/fe68c33d-e718-4449-acae-351072ce7749/contours?start=2015-06-01&end=2015-06-01",
      "assetStatistics": {
        "mean": 10.2,
        "maximum": 11.5,
        "minimum": 9.6
      },
      "products": [
        "skywise-24hr-precipitation-analysis"
      ]
    },
    {
      "validDate": "2015-06-02",
      "value": 11.0,
      "contours": "/daily-precipitation/fe68c33d-e718-4449-acae-351072ce7749/contours?start=2015-06-02&end=2015-06-02",
      "assetStatistics": {
        "mean": 10.5,
        "maximum": 11.7,
        "minimum": 9.4
      },
      "products": [
        "skywise-24hr-precipitation-analysis"
      ]
    },
    {
      "validDate": "2015-06-03",
      "value": 10.0,
      "contours": "/daily-precipitation/fe68c33d-e718-4449-acae-351072ce7749/contours?start=2015-06-03&end=2015-06-03",
      "assetStatistics": {
        "mean": 10.6,
        "maximum": 12.5,
        "minimum": 8.6
      },
      "products": [
        "skywise-24hr-precipitation-analysis"
      ]
    }
  ]
}

Contours By Asset

Provides a contoured representation (GeoJSON) of the total amount of precipitation within a user-defined timespan, clipped to an asset boundary.

GET /daily-precipitation/{asset-uuid}/contours

Query String Parameters (Optional)

The default response contains results in millimeters for up to the next 6 days.

Name Type Description Accepted Values / Range Example
start string start date start of 2015 to 7 days in the future 2015-06-01
end string end date start of 2015 to 7 days in the future 2015-06-03
unit string unit of measure inches, millimeters inches

Request Example

See Headers for request header details.

$ curl -X GET -G "https://insight.api.wdtinc.com/daily-precipitation/fe68c33d-e718-4449-acae-351072ce7749/contours" \
  -d start="2015-06-01" \
  -d end="2015-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": "2015-06-01",
  "endDate": "2015-06-03",
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [-102.3555, 39.8420], [-99.8945, 39.8420], ... ]
        ]
      },
      "properties": {
        "precipitation": 20.0
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [ [-102.3555, 39.8420], [-99.8945, 39.8420], ... ]
        ]
      },
      "properties": {
        "precipitation": 15.0
      }
    }
  ],
  "unit": {
    "description": "millimeters",
    "label": "mm"
  }
}