Power Disruption Index

The Power® Disruption index provides indices indicating the potential for power disruptions due to weather.

Overview

  • Domain Portfolio: Forecast
  • Domain: Lifestyle - Indices
  • Usage Classification: Standard
  • Geography: Global
  • Attribution Required: n/a
  • Attribution Requirements: n/a

HTTP Headers and Data Lifetime - Caching and Expiration

For details on appropriate header values as well as caching and expiration definitions, please see The Weather Company Data | API Common Usage Guide.

URL Construction

Atomic API URL Examples:  

Request by Geocode (Latitude & Longitude): Required Parameters: geocode, language, format

https://api.weather.com/v2/indices/powerDisruption/daypart/<duration>?geocode=33.74,-84.39&language=en-US&format=<json>&apiKey=yourApiKey

Aggregate Product Name
https://api.weather.com/v2/indices/powerDisruption/daypart/15day?geocode=33.74,-84.39&language=en-US&format=json&apiKey=yourApiKey v2idxPowerDaypart15

Request by Postal Code: Required Parameters: postalCode, countryCode, language, format

https://api.weather.com/v2/indices/powerDisruption/daypart/<duration>?postalCode=94608&countryCode=US&format=<json>&language=en-US&apiKey=yourApiKey

Aggregate Product Name
https://api.weather.com/v2/indices/powerDisruption/daypart/15day?postalCode=94608&countryCode=US&format=json&language=en-US&apiKey=yourApiKey v2idxPowerDaypart15
Power Disruption Index - Daypart API  

Data Elements & Definitions

Table 1.
API Name Field Name Description Type Range Sample Nulls Allowed Usage
Repeating Elements: Unique to Forecast              
  fcstValid Time forecast is valid ... start of the forecast period, always 7am local time. [epoch]   1369306800 N Display As Provided
  fcstValidLocal Time forecast is valid ... start of the forecast period, always 7am local time. [ISO]   2013-05-23T07:00:00-0400 N Display As Provided
Repeating Elements: Common Per Time Segment              
  num

Daypart Segment (12hour) - Sequential daypart number, where 1 = daytime of Day 0

Long - Range - Sequential hour number, where 1 = first available hour of forecast, usually <= 1hr from “now”

[integer]   21 N Display As Provided
  dayInd Day / Night Indicator [string] D,N D N Display As Provided
  daypartName Name of 12hr daypart, not including day names in first 48hrs [string]   Tomorrow N Display As Provided
Atomic Indices              
Power Disruption Index powerDisruptionCategory Descriptive text of Power Disruption Index [string]   Low N Display As Provided
  powerDisruptionIndex

Index indicating the potential for power disruptions due to weather.

0=none, 1=low, 2=moderate, 3=high, 4=very high

[integer] 0-4 1 N Display As Provided

JSON Sample

JSON Sample - Daypart

{

"metadata": {},

"powerDisruptionIndex12hour": {

"fcstValid": [],

"fcstValidLocal": [],

"dayInd": [],

"num": [],

"daypartName": [],

"powerDisruptionIndex": [],

"powerDisruptionCategory": []

}

}

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},