Currents XML Format

Currents

This format will provide a simplified XML response that provides a summary of weather data available for the nearest observation point.

Usage:

format=currents
datatype=currents
var=summary

Example Currents format data request:

http://datacloud.wxc.com/?datatype=currents&vs=1.0&passkey=123456789&type=point&var=summary&lat=34.252&lon=-107.33&format=currents&time=now

Note: Currents requests must use only one latitude and longitude, and time=now.

Example Currents format data response:

CURRENTS FORMAT RETURN VALUES

current-conditions
This is an element that contains a number of georeferenced point elements containing weather data from the nearest observation.

gmt
This is an attribute of the current-conditions element that is reserved for future use.

Example:

gmt=1305581580

gmt-offset
This is an attribute of the current-conditions element that is reserved for future use.

Example:

gmt-offset=0

date
This is an element that contains the month, day of the month and day of the week.

Example:

date=Monday, May 16

dateabbr
This is an element that contains the date in MM/DD/YYYY format.

Example:

date=5/16/2011

time 
This is an element that contains the time the observation was recorded.  It is in GMT.

Example:

time=20:53 GMT

reporting station
This is the element that contains the a number of weather variables that were recorded by the weather reporting station.

code
This is an attribute of the recording station element that provides the ICAO (International Civil Aviation Organization) code of the airport reporting station.  This is a 4-letter unique identifier for all airports worldwide where weather observations are typically measured.

Example:

code=KMEM

city
This element contains the city name where the observation occurred.

Example:

<city>Memphis</city>

state
This element contains the state name where the observation occurred.

Example:

<state>Tennessee</state>


state-abbr
This element contains the state postal code where the observation occurred.

Example:

<state-abbr>TN</state-abbr>

temperature
This element contains the temperature of the observation in degrees Fahrenheit. 

Example:

<temperature>64</temperature>

dew-point
This element contains the temperature of the observation in degrees Fahrenheit. 

Example:

<dew-point>48</dew-point>

relative-humidity
This element contains the relative humidity of the observation.  Relative humidity is a pure measure of how much moisture is in the atmosphere vs. how much moisture the atmosphere can sustain. It is defined as a percentage from 0-100%. 

Example:

<relative-humidity>56</relative-humidity>

wind-chill
his element contains the wind chill of the observation in degrees Fahrenheit. The wind chill combines the temperature and the wind speed to account for how cool the air feels on the skin.

Example:

<wind-chill>63</wind-chill>

heat-index
This element contains the heat index of the observation in degrees Fahrenheit. The heat index combines the temperature and the humidity to account for how warm the air feels on the skin.

Example:

<heat-index>98</heat-index>

wind-direction
This element contains the wind direction.  This is the direction the wind is coming from, so if you were facing this direction the wind would be in your face.  There are 16 possible values (N, NNE, NE, ENE, E, ESE, SE, SSE, S, SSW, SW, WSW, W, WNW, NW, and NNW).

Example:

<wind-direction>N</wind-direction>

wind-direction-degrees
This element contains the wind direction of the observation as a compass value.  This is the direction the wind is coming from, so if you were facing this direction the wind would be in your face.  This is in degrees so an East wind would be measured as 90.

Example:

<wind-direction-degrees>010</wind-direction-degrees>

wind-speed
This element contains the wind speed of the observation, measured in mph.

Example:

<wind-speed>13</wind-speed>

wind-gusts
This element contains the wind gusts recorded at the observation site measured in mph. 

Example:

<wind-gusts>25</wind-gusts>

pressure
This element contains the pressure recorded at the observation site, measured in millibars and rounded to the nearest tenth of a millibar.

Example:

<pressure>1013.1</pressure>

high-today
This element contains the high temperature that has occurred since local midnight at the observation station, in degrees Fahrenheit.

Example:

<high-today>64</high-today>

low-today
This element contains the low temperature that has occurred since local midnight at the observation station, in degrees Fahrenheit.

Example:

<low-today>50</low-today>

precip-today
This element contains the rainfall or water equivalency of the snowfall amount that has occurred since local midnight at the observation station, in inches rounded to the nearest hundredth.

Example:

<precip-today>0.01<precip-today>

snow-depth
This element contains the depth of snow currently on the ground at the observation station, measured in inches rounded to the nearest hundredth.

Example:

<snow-depth>2.50</snow-depth>

visibility
This element contains the visibility that is recorded at the observation station in miles to the nearest tenth of an inch.  Visibility is a measurement of the distance at which an object can be clearly discerned.

Example:

<visibility>10.00</visibility>

ceiling
This element contains the ceiling that is recorded at the observation station in feet.  Ceiling is the height level of the lowest non broken cloud deck.

Example:

<ceiling>21000</ceiling>

pressure-tendency
This element contains the air pressure tendency that is recorded at the observation station.  This value can be F (Falling), S (Steady), or R (Rising).

Example:

<pressure-tendancy>F</pressure-tendancy>

altimeter
This element contains the altimeter reading that is recorded at the observation station in inches of mercury rounded to the nearest hundredth of an inch.

Example:

<altimeter>29.92</altimeter>

highyesterday
This element contains the high temperature that was recorded on the previous day at the observation station in degrees Fahrenheit.

Example:

<highyesterday>63</highyesterday>

lowyesterday
This element contains the low temperature that was recorded on the previous day at the observation station in degrees Fahrenheit.

Example:

<lowyesterday>54</lowyessterday>

sky-conditions
This element contains a text string that defines what type of precipitation is occurring and what the cloudiness is.  A table of values can be found here.

Example:

<sky-conditions>Partly Cloudy</sky-conditions>

icon-select
This element contains a number value that defines what type of precipitation is occurring and what the cloudiness is to help define an icon.  A table of values can be found here.

Example:

<icon-select>3</icon-select>

feels-like
This element contains the air temperature as it would feel on your skin.  It is calculated for you based on the wind-chill and heat-index values, and is measured in degrees Fahrenheit.

Example:

<feels-like>64</feels-like>

sunrise
This element contains the time of  the sunrise for today.  For North American sites it is measured in local time, for international locations it is measured in GMT.

Example:

<sunrise>4:56 AM CST</sunrise>

sunset
This element contains the time of  the sunset for today.  For North American sites it is measured in local time, for international locations it is measured in GMT.

Example:

<sunset>6:56 PM CST</sunset>

daylight
This element is reserved for future use.

Example:

<daylight>1</daylight>