Daily XML Format

Daily
This will provide a simplified XML response that provides daily summary information for weather data.

Usage:

format=daily


Example Daily format data request:
http://datacloud.wxc.com/?datatype=forecast&vs=1.0&passkey=123456789&type=point&var=summary&lat=40.74&lon=-74.01&format=daily&time=all

Example Daily format data response:

DAILY FORMAT RETURN VALUES

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

source
This is an attribute of the dailysummary element that contains the data format 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=2010-02-04T12:00:00


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

Example:

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=45.33


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

Example:

lon=-93.24


day
This is the element that contains weather information for one particular day. The day element contains weather variables showing range information from midnight to midnight for that day. This is based on the local time of the offset you provide in the request. 

dayname
This is an attribute of the day element that tells what day the forecast is valid for.

Example:

dayname=Tuesday


start

This in an attribute of the day element that represents the first hour used in creating the summary for the day. Note: Today will be a summary of the remaining hours in the day. When there are less than 4 hours remaining, no daily summary will be issued for that day and the first day returned will be the following day.

Example:

start=2010-02-09T18:00


end

This in an attribute of the day element that represents the last hour used in creating the summary for the day. Note: In order to create a daily summary a full 24 hours of forecast information must be present.

Example:

end=2010-02-09T18: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>33</Temperature>


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 Weather 101.

Example:

unit=mph


min
This is the minimum value obtained by the variable on a midnight to midnight clock. This time is with respect to the local GMT offset value you have entered in the query.

Example:

min=17


max

This is the maximum value obtained by the variable on a midnight to midnight clock. This time is with respect to the local GMT offset value you have entered in the query.

Example:

max=35


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 element contains a daily average value for the Wind Direction, Clouds, and Icon 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 Forecast Variables.

Example:

Wind_Direction Example: summary=NE, SE, NW
Clouds Example: summary=mostlycloudy
Icon Example: summary=mostlycloudy
Phrase Example: summary=Mostly 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 Forecast Variables.

Example:

Wind_Direction Example: description=Daily Wind Direction
Clouds Example: description=Mostly
Cloudy Icon Example: description=Mostly 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.

Example:

Phrase Example: description=Temperatures will range from a high of 67 to a low of 58 degrees with mostly cloudy skies. Winds will range between 2 and 10 miles per hour from the southeast. Rain amounts of less than a tenth of an inch are expected.