Leisure Travel Index - Daypart - 15 Day

Overview

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

The Leisure Travel index provides indices of outdoor travel / sightseeing conditions due to weather.

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/travel/daypart/<duration>?geocode=33.74,-84.39&language=en-US&format=<json>&apiKey=yourApiKey

Aggregate Product Name

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

v2idxTravelDaypart15

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

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

Aggregate Product Name
https://api.weather.com/v2/indices/travel/daypart/15day?postalCode=94608&countryCode=US&format=json&language=en-US&apiKey=yourApiKey v2idxTravelDaypart15

Data Elements & Definitions

API Name Field Name Description Type Range Sample Nulls Allowed Usage
  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]   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
Atomic Indices              
Leisure Travel Index leisureTravelCategory Descriptive text of Leisure Travel Index [string]   Fair N Display As Provided
  leisureTravelIndex

Index of outdoor travel / sightseeing conditions due to weather.

1=Very Poor, 2-3=Poor, 4-5=Fair, 6-7=Good, 8-9=Very Good, 10=Excellent

[integer] 1-10 5 N Display As Provided
Repeating Elements: Unique to Forecast              

JSON Sample

JSON Sample - Hourly

{

"metadata": {},

"travelIndex1hour": {

"fcstValid": [],

"fcstValidLocal": [],

"num": [],

"dow": [],

"dayInd": [],

"leisureTravelIndex": [],

"leisureTravelCategory": []

}

}

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

JSON Sample - Daypart

{

"metadata": {},

"travelIndex12hour": {

"fcstValid": [],

"fcstValidLocal": [],

"dayInd": [],

"num": [],

"daypartName": [],

"leisureTravelIndex": [],

"leisureTravelCategory": []

}

}

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},

{//JSON payload},