Timespan XML Format

Time Span
This is will provide a simplified XML response that provides summary information for weather data spanning a specified time range.

Usage:

format=timespan

Example Time Span format data request:
http://datacloud.wxc.com/?datatype=forecast&vs=1.0&passkey=123456789&type=point&var=summary&lat=34.252&lon=-107.33&format=timespan&time=2011-04-14T00:00:00,2011-04-14T06:00:00
Note:  Start and end times must be in the future for the example link to work.  Start and end times are given in the format YYYY-MM-DDTHH:MM:SS and separated by a comma.  Example (from above):  time=2011-04-14T00:00:00,2011-04-14T06:00:00
asdf

Example Time Span format data response:

TIME SPAN FORMAT RETURN VALUES

timespan
This is an element that contains a number of georeferenced point elements containing weather data in a timespan format.

source
This is an attribute of the timespan element that contains the weather datatype of the weather data you are accessing.

Example:

source=Forecast

starttime
This is an attribute of the hourly query that contains the last update time of the forecast information in GMT, in the format YYYY-MM-DDTHH:MM:SS.  For forecast variables this occurs four times a day.  For non-forecast variables this will read 1970-01-01T00:00:00.

Example:

starttime=2011-04-13T12:00:00

title 
Description: This is an element that contains a summary description of the data returned

Example:

title=Weather Central Dataserver API

type 
This is an attribute of the title element that describes the format of the data in the return

Example:

type=text

rights 
This is the data copyright info.

Example:

Copyright (c) 2010, Weather Central LP

location
This is the element that contains a number of ranges of weather information for one particular geo-location that you have requested
lat
This is an attribute of the location element in decimal format containing the latitude. South is represented by the negative sign.

Example:

lat=43.252

lon
This is an attribute of the location element in decimal format containing the longitude. West is represented by the negative sign.

Example:

lon=-90.33

period
This is the element that contains weather information for one particular forecast period. This will contain elements for weather variables providing information for the forecast period requested. This is based on the start and end times, as well as the time offset you provide in the request. 

start
This is an attribute of the period element that represents the first hour used in creating the summary for the forecast period. Note: If the start time provided is in the past, the forecast that is issued will begin with the most recent forecast hour, so long as the end time is not in the past, as well.

Example:

start=2011-04-14T00:00:00

end
This is an attribute of the period element that represents the last hour used in creating the summary for the forecast period.

Example:

end=2011-04-14T06:00:00

ranges
The ranges element will contain a list of variables that contain minimum and maximum ranges of the variable for a particular 24 hour period (midnight to midnight):

<var>
Within each ranges element you will have an element specific to the variable you are requesting that  contains the ranges of the variable for that day.

Example:

<Temperature unit=”F” min=”46” max=”60” />

There may be multiple <var> elements within each step if you are requesting more than one variable.

Example:

unit
This is an attribute within the <var> element that defines the unit the variable is in. For an index of unit types please visit Unit Explanations.

Example:

unit=mph

min
This is the minimum value obtained by the variable within the requested forecast period. This respects the local GMT offset value you have entered in the query.

Example:

min=20

max
This is the maximum value obtained by the variable within the requested forecast period. This respects the local GMT offset value you have entered in the query.

Example:

max=50

mintime
This is the time at which the minimum value of the variable range is forecast to occur. This time is with respect to the local GMT offset value you have entered in the query.

Example:

mintime=2011-04-14T08:00:00

maxtime
This is the time at which the maximum value of the variable range is forecast to occur. This time is with respect to the local GMT offset value you have entered in the query.

Example:

maxtime=2011-04-14T19:00:00

summaries
This contains period-averaged value for the Wind Direction, Clouds, and Icon value based on logic Weather Central uses to evaluate the most prevalent or impactful weather event of the day.
<var>
Within each summaries element you will have an element specific to the variable you are requesting that contains the summary of the variable for that day.

Example:

<Icon>Partly Cloudy</Icon>

unit
This is an attribute within the <var> element that defines the unit the variable is in. For an index of unit types please visit Unit Explanations.

Example:

unit=mph

summary
This is an attribute within the <var> element that defines a string value to a numeric value. This is used specifically in the Wind direction, Clouds, Icon and Phrase variables. For a full list of values please see the Forecast Variables glossary.

Example:

Wind_Direction Example: summary=NE, SE, NW
Clouds Example: summary=partlycloudy
Icon Example: summary=partlycloudy
Phrase Example: summary=Partly Cloudy

description
This is an attribute within the <var> element that defines a human-readable string value to a numeric value. This is used specifically in the Wind direction, Clouds, Icon and Phrase variables. For a full list of values please see the Forecast Variables glossary.

Example:

Wind_Direction Example: description=Daily Wind Direction
Clouds Example: description=Partly Cloudy
Icon Example: description=Partly Cloudy

The description for the phrase variable contains information about the high and low temperatures, sky condition, wind speeds and direction, and precipitation type and amounts (where applicable). This information is given in a short paragraph comprised of 3 sentences: the first sentence provides temperature and sky condition information, the second sentence provides wind information, and the third sentence provides precipitation information.

Phrase Example: description=Temperatures will range from 66 to 72 degrees with partly cloudy skies. Winds will range between 2 and 11 miles per hour from the north. No precipitation is expected.