Weather Central DataCloud API

Daily XML Format

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

Usage:

format=daily

Example Daily format data request:

http://datacloud.wxc.com/?datatype=forecast&vs=0.9&passkey=123456789&type=point&var=summary&lat=34.252&lon=-107.33&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
Description: 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
Description: 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


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 and Icon variables. For a full list of values please see the Weather 101 glossary.

Wind_Direction Example: summary=NE, SE, NW
Clouds Example: summary=cloudy, partlycloudy, mostlycloudy
Icon Example: summary=cloudylightrain

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, Icon, and the Clouds variables. For a full list of values please see the Weather 101 glossary.

Wind_Direction Example: description=Daily Wind Direction
Clouds Example: description=Cloudy, Partly Cloudy, Mostly Cloudy
Icon Example: description=Cloudy Light Rain