Running Weather Index - Hourly

Overview

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

The Running Weather Index provides indices of outdoor running conditions due to weather - for short, and long runs.

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:
Running Weather Index - Hourly API
Request by Geocode (Latitude & Longitude): Required Parameters: geocode, language, format https://api.weather.com/v2/indices/runWeather/hourly/<duration>?geocode=33.74,-84.39&language=en-US&format=<json>&apiKey=yourApiKey	Aggregate Product Name
https://api.weather.com/v2/indices/runWeather/hourly/360hour?geocode=33.74,-84.39&language=en-US&format=json&apiKey=yourApiKey	v2idxRunHourly360
Request by Postal Code: Required Parameters: postalCode, countryCode, language, format https://api.weather.com/v2/indices/runWeather/hourly/<duration>?postalCode=94608&countryCode=US&format=<json>&language=en-US&apiKey=yourApiKey	Aggregate Product Name
https://api.weather.com/v2/indices/runWeather/hourly/360hour?postalCode=94608&countryCode=US&format=json&language=en-US&apiKey=yourApiKey	v2idxRunHourly360
Running Weather Index - Daypart API

Data Elements & Definitions

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
Unique to Hourly	dow	Forecast valid day of week	[string]	[string]	Wednesday	N	Display As Provided
	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
Unique to Daypart	daypartName	Name of 12hr daypart, not including day names in first 48hrs	[string]	Tomorrow		N	Display As Provided

Running Weather Index	longRunWeatherCategory	Descriptive text of Long Run Weather Index	[string]		Poor	N	Display As Provided
	longRunWeatherIndex	Index of outdoor running conditions due to weather - for long runs. 1-2=Very Poor, 3-4=Poor, 5-6=Fair, 7-8=Good, 9=Very Good, 10=Excellent	[integer]	1-10	3	N
shortRunWeatherCategory	shortRunWeatherCategory	Descriptive text of Short Run Weather Index	[string]		Good	N	Display As Provided
	shortRunWeatherIndex	Index of outdoor running conditions due to weather - for short runs. 1-2=Very Poor, 3-4=Poor, 5-6=Fair, 7-8=Good, 9=Very Good, 10=Excellent	[integer]	1-10	8	N	Display As Provided

JSON Sample

JSON Sample - Hourly

{

"metadata": {},

"runWeatherIndex1hour": {

"fcstValid": [],

"fcstValidLocal": [],

"num": [],

"dow": [],

"dayInd": [],

"longRunWeatherIndex": [],

"longRunWeatherCategory": [],

"shortRunWeatherIndex": [],

"shortRunWeatherCategory": []

}

{//JSON payload},

JSON Sample - Daypart

{