CustomWeather Documentation

INTRODUCTION

The CustomWeather API is a consistent source of reliable weather forecasts and data for millions of locations worldwide, available in over 80 languages.

Key features include:

• Ability to search by location name, latitude/longitude coordinate, postal codes and ID.
• Data can be requested in either JSON or XML format (default).
• Locations are geocoded with latitude, longitude, time zone, state, province, and country information.
• Ability to refine forecasts down to 100 meter resolution worldwide.
• Ability to request data in multiple languages.
• Ability to request data via HTTPS for secure data encryption.
• Products can be combined into one request to economize the number of requests.

Access to the CustomWeather API requires a username and password. If you would like to request access, click here.  CustomWeather offers competitive, flexible pricing plans. For more information, contact us.

DOCUMENTATION

Before you start using the CustomWeather API, please remember:

• Access to the CustomWeather API requires a username and password.
• API requests are made over HTTP or HTTPS. Data is returned in XML (default), JSON using the "format=json" parameter, or JSON using  the Accept: application/json HTTP Header.
• To economize your requests, multiple API products can be combined into a single request.

1. Search

The search product returns a list of the requested location.

1.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=search&version=2.0

1.2 Request Parameters

1.3 Response Object

Field	Description
size	The number of locations available.
search_type	Not used.
id	The location's ID code.
name	The location name.
state	The state code of the reporting station.
state_name	The state name of the reporting station.
country	The country code of the reporting station.
country_name	The country name of the reporting station.
lat	Latitude Coordinates in Decimal Degrees
long	Longitude Coordinates in Decimal Degrees
population	The population of the location.
timezone	Time zone offset from UTC of the location.
timezone_code	The time zone abbreviation.
timezone_id	IANA (Internet Assigned Numbers Authority) time zone database identifier.
timezone_offset	Time zone offset from UTC of the location in seconds.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
region	The region name (defunct).
iso_cc	The ISO country code.

1.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=search&search=London&version=2.0

1.5 Example Response(XML)

<cw_citylist size="36" search_type="city"><city id="gn2643741" name="City of London" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.51279" long="-0.09184" population="7556900" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="EGRB" iso_cc="GB"/><city id="gn2643743" name="London" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.50853" long="-0.12574" population="7556900" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="W03770" iso_cc="GB"/><city id="gn6058560" name="London" state="ON" state_name="null" country="CA" country_name="Canada" lat="42.98339" long="-81.23304" population="346765" timezone="-5" timezone_code="EDT" timezone_id="America/Toronto" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="" weather_id="54211" iso_cc="CA"/><city id="gn4517009" name="London" state="OH" state_name="Ohio" country="US" country_name="United States" lat="39.88645" long="-83.44825" population="9904" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="26250" iso_cc="US"/><city id="gn2643744" name="The City" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.51334" long="-0.08901" population="8000" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="EGRB" iso_cc="GB"/><city id="gn4298960" name="London" state="KY" state_name="Kentucky" country="US" country_name="United States" lat="37.12898" long="-84.08326" population="7993" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="18256" iso_cc="US"/><city id="gn5367815" name="London" state="CA" state_name="California" country="US" country_name="United States" lat="36.47606" long="-119.44318" population="1869" timezone="-8" timezone_code="PDT" timezone_id="America/Los_Angeles" timezone_offset="-28800" localtime="Thu, 05 Oct 2017 12:21:21 PDT" region="southwest" weather_id="11913" iso_cc="US"/><city id="gn4030939" name="London Village" state="L" state_name="Line Islands" country="KR" country_name="Kiribati" lat="1.98487" long="-157.47502" population="1829" timezone="14" timezone_code="LINT" timezone_id="Pacific/Kiritimati" timezone_offset="50400" localtime="Fri, 06 Oct 2017 09:21:21 LINT" region="SouthPacific" weather_id="PLCH" iso_cc="KI"/><city id="gn4119617" name="London" state="AR" state_name="Arkansas" country="US" country_name="United States" lat="35.32897" long="-93.25296" population="1039" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="11244" iso_cc="US"/><city id="gn3581797" name="London" state="OW" state_name="Orange Walk" country="BH" country_name="Belize" lat="17.98333" long="-88.43333" population="0" timezone="-6" timezone_code="CST" timezone_id="America/Belize" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 13:21:21 CST" region="CentralAmerica" weather_id="51239" iso_cc="BZ"/><city id="gn1705729" name="London" state="BUK" state_name="Soccsksargen" country="RP" country_name="Philippines" lat="6.00972" long="125.12944" population="0" timezone="8" timezone_code="PHT" timezone_id="Asia/Manila" timezone_offset="28800" localtime="Fri, 06 Oct 2017 03:21:21 PHT" region="Indonesia" weather_id="RPWB" iso_cc="PH"/><city id="gn4812926" name="London" state="WV" state_name="West Virginia" country="US" country_name="United States" lat="38.19455" long="-81.36872" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="32636" iso_cc="US"/><city id="gn4637795" name="London" state="TN" state_name="Tennessee" country="US" country_name="United States" lat="35.86982" long="-83.00209" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="southeast" weather_id="29954" iso_cc="US"/><city id="gn4707415" name="London" state="TX" state_name="Texas" country="US" country_name="United States" lat="32.23099" long="-94.94438" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="30862" iso_cc="US"/><city id="gn5260737" name="London" state="WI" state_name="Wisconsin" country="US" country_name="United States" lat="43.04778" long="-89.01289" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="32848" iso_cc="US"/><city id="gn5035441" name="London" state="MN" state_name="Minnesota" country="US" country_name="United States" lat="47.2027" long="-91.56962" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="KBFW" iso_cc="US"/><city id="gn4707414" name="London" state="TX" state_name="Texas" country="US" country_name="United States" lat="30.67685" long="-99.57645" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="KJCT" iso_cc="US"/><city id="gn2406961" name="London" state="E" state_name="Eastern Province" country="SL" country_name="Sierra Leone" lat="8.31068" long="-10.78731" population="0" timezone="0" timezone_code="GMT" timezone_id="Africa/Freetown" timezone_offset="0" localtime="Thu, 05 Oct 2017 19:21:21 GMT" region="Africa" weather_id="75289" iso_cc="SL"/><city id="gn982299" name="London" state="MP" state_name="Mpumalanga" country="SF" country_name="South Africa" lat="-24.76667" long="30.86667" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="77048" iso_cc="ZA"/><city id="gn982298" name="London" state="MP" state_name="Mpumalanga" country="SF" country_name="South Africa" lat="-24.81927" long="31.04765" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="77064" iso_cc="ZA"/><city id="gn5035439" name="London" state="MN" state_name="Minnesota" country="US" country_name="United States" lat="43.52607" long="-93.0627" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="20708" iso_cc="US"/><city id="gn4999913" name="London" state="MI" state_name="Michigan" country="US" country_name="United States" lat="42.02004" long="-83.61327" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/Detroit" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northcentral" weather_id="19913" iso_cc="US"/><city id="gn982300" name="London" state="LP" state_name="Limpopo" country="SF" country_name="South Africa" lat="-24.30262" long="30.5725" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="FAHS" iso_cc="ZA"/><city id="gn5056033" name="London" state="MO" state_name="Missouri" country="US" country_name="United States" lat="40.445" long="-95.23498" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="22276" iso_cc="US"/><city id="gn3803838" name="London" state="M" state_name="Miranda" country="VE" country_name="Venezuela" lat="10.36093" long="-66.73159" population="0" timezone="-4" timezone_code="VET" timezone_id="America/Caracas" timezone_offset="-16200" localtime="Thu, 05 Oct 2017 14:51:21 VET" region="SouthAmerica" weather_id="800433" iso_cc="VE"/><city id="gn2308696" name="London" state="00" state_name="" country="EK" country_name="Equatorial Guinea" lat="2.26815" long="9.78934" population="0" timezone="1" timezone_code="WAT" timezone_id="Africa/Malabo" timezone_offset="3600" localtime="Thu, 05 Oct 2017 20:21:21 WAT" region="Africa" weather_id="FGBT" iso_cc="GQ"/><city id="gn9876172" name="London" state="S" state_name="Southern Province" country="SL" country_name="Sierra Leone" lat="7.65137" long="-12.00293" population="0" timezone="0" timezone_code="GMT" timezone_id="Africa/Freetown" timezone_offset="0" localtime="Thu, 05 Oct 2017 19:21:21 GMT" region="Africa" weather_id="75284" iso_cc="SL"/><city id="gn1313003" name="Lonton" state="11" state_name="Kachin" country="BM" country_name="Myanmar [Burma]" lat="25.09229" long="96.28854" population="0" timezone="6" timezone_code="MMT" timezone_id="Asia/Rangoon" timezone_offset="23400" localtime="Fri, 06 Oct 2017 01:51:21 MMT" region="CentralAsia" weather_id="XZKT" iso_cc="MM"/><city id="gn5737562" name="London" state="OR" state_name="Oregon" country="US" country_name="United States" lat="43.63457" long="-123.09285" population="0" timezone="-8" timezone_code="PDT" timezone_id="America/Los_Angeles" timezone_offset="-28800" localtime="Thu, 05 Oct 2017 12:21:21 PDT" region="northwest" weather_id="27686" iso_cc="US"/><city id="gn5198788" name="London" state="PA" state_name="Pennsylvania" country="US" country_name="United States" lat="41.14367" long="-80.14867" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="28141" iso_cc="US"/><city id="gn4073570" name="London" state="AL" state_name="Alabama" country="US" country_name="United States" lat="31.29767" long="-87.08775" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southeast" weather_id="10069" iso_cc="US"/><city id="gn4073571" name="London" state="AL" state_name="Alabama" country="US" country_name="United States" lat="32.2732" long="-86.05024" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southeast" weather_id="10392" iso_cc="US"/><city id="gn4260673" name="London" state="IN" state_name="Indiana" country="US" country_name="United States" lat="39.6256" long="-85.92026" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/Indiana/Indianapolis" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="15993" iso_cc="US"/><city id="gn1489797" name="Tel’manskiy" state="ALT" state_name="Altayskiy" country="RS" country_name="Russia" lat="52.8" long="79.55" population="0" timezone="6" timezone_code="OMST" timezone_id="Asia/Omsk" timezone_offset="21600" localtime="Fri, 06 Oct 2017 01:21:21 OMST" region="Russia" weather_id="73947" iso_cc="RU"/><city id="gn2331921" name="London" state="DE" state_name="Delta State" country="NI" country_name="Nigeria" lat="5.72257" long="5.78787" population="0" timezone="1" timezone_code="WAT" timezone_id="Africa/Lagos" timezone_offset="3600" localtime="Thu, 05 Oct 2017 20:21:21 WAT" region="Africa" weather_id="70936" iso_cc="NG"/><city id="gn5161176" name="London" state="OH" state_name="Ohio" country="US" country_name="United States" lat="40.91033" long="-82.62934" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="26605" iso_cc="US"/></cw_citylist><cw_citylist size="36" search_type="city"^
<city id="gn2643741" name="City of London" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.51279" long="-0.09184" population="7556900" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="EGRB" iso_cc="GB"/^
<city id="gn2643743" name="London" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.50853" long="-0.12574" population="7556900" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="W03770" iso_cc="GB"/^
<city id="gn6058560" name="London" state="ON" state_name="null" country="CA" country_name="Canada" lat="42.98339" long="-81.23304" population="346765" timezone="-5" timezone_code="EDT" timezone_id="America/Toronto" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="" weather_id="54211" iso_cc="CA"/^
<city id="gn4517009" name="London" state="OH" state_name="Ohio" country="US" country_name="United States" lat="39.88645" long="-83.44825" population="9904" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="26250" iso_cc="US"/^
<city id="gn2643744" name="The City" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.51334" long="-0.08901" population="8000" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="EGRB" iso_cc="GB"/^
<city id="gn4298960" name="London" state="KY" state_name="Kentucky" country="US" country_name="United States" lat="37.12898" long="-84.08326" population="7993" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="18256" iso_cc="US"/^
<city id="gn5367815" name="London" state="CA" state_name="California" country="US" country_name="United States" lat="36.47606" long="-119.44318" population="1869" timezone="-8" timezone_code="PDT" timezone_id="America/Los_Angeles" timezone_offset="-28800" localtime="Thu, 05 Oct 2017 12:21:21 PDT" region="southwest" weather_id="11913" iso_cc="US"/^
<city id="gn4030939" name="London Village" state="L" state_name="Line Islands" country="KR" country_name="Kiribati" lat="1.98487" long="-157.47502" population="1829" timezone="14" timezone_code="LINT" timezone_id="Pacific/Kiritimati" timezone_offset="50400" localtime="Fri, 06 Oct 2017 09:21:21 LINT" region="SouthPacific" weather_id="PLCH" iso_cc="KI"/^
<city id="gn4119617" name="London" state="AR" state_name="Arkansas" country="US" country_name="United States" lat="35.32897" long="-93.25296" population="1039" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="11244" iso_cc="US"/^
<city id="gn3581797" name="London" state="OW" state_name="Orange Walk" country="BH" country_name="Belize" lat="17.98333" long="-88.43333" population="0" timezone="-6" timezone_code="CST" timezone_id="America/Belize" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 13:21:21 CST" region="CentralAmerica" weather_id="51239" iso_cc="BZ"/^
<city id="gn1705729" name="London" state="BUK" state_name="Soccsksargen" country="RP" country_name="Philippines" lat="6.00972" long="125.12944" population="0" timezone="8" timezone_code="PHT" timezone_id="Asia/Manila" timezone_offset="28800" localtime="Fri, 06 Oct 2017 03:21:21 PHT" region="Indonesia" weather_id="RPWB" iso_cc="PH"/^
<city id="gn4812926" name="London" state="WV" state_name="West Virginia" country="US" country_name="United States" lat="38.19455" long="-81.36872" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="32636" iso_cc="US"/^
<city id="gn4637795" name="London" state="TN" state_name="Tennessee" country="US" country_name="United States" lat="35.86982" long="-83.00209" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="southeast" weather_id="29954" iso_cc="US"/^
<city id="gn4707415" name="London" state="TX" state_name="Texas" country="US" country_name="United States" lat="32.23099" long="-94.94438" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="30862" iso_cc="US"/^
<city id="gn5260737" name="London" state="WI" state_name="Wisconsin" country="US" country_name="United States" lat="43.04778" long="-89.01289" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="32848" iso_cc="US"/^
<city id="gn5035441" name="London" state="MN" state_name="Minnesota" country="US" country_name="United States" lat="47.2027" long="-91.56962" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="KBFW" iso_cc="US"/^
<city id="gn4707414" name="London" state="TX" state_name="Texas" country="US" country_name="United States" lat="30.67685" long="-99.57645" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="KJCT" iso_cc="US"/^
<city id="gn2406961" name="London" state="E" state_name="Eastern Province" country="SL" country_name="Sierra Leone" lat="8.31068" long="-10.78731" population="0" timezone="0" timezone_code="GMT" timezone_id="Africa/Freetown" timezone_offset="0" localtime="Thu, 05 Oct 2017 19:21:21 GMT" region="Africa" weather_id="75289" iso_cc="SL"/^
<city id="gn982299" name="London" state="MP" state_name="Mpumalanga" country="SF" country_name="South Africa" lat="-24.76667" long="30.86667" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="77048" iso_cc="ZA"/^
<city id="gn982298" name="London" state="MP" state_name="Mpumalanga" country="SF" country_name="South Africa" lat="-24.81927" long="31.04765" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="77064" iso_cc="ZA"/^
<city id="gn5035439" name="London" state="MN" state_name="Minnesota" country="US" country_name="United States" lat="43.52607" long="-93.0627" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="20708" iso_cc="US"/^
<city id="gn4999913" name="London" state="MI" state_name="Michigan" country="US" country_name="United States" lat="42.02004" long="-83.61327" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/Detroit" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northcentral" weather_id="19913" iso_cc="US"/^
<city id="gn982300" name="London" state="LP" state_name="Limpopo" country="SF" country_name="South Africa" lat="-24.30262" long="30.5725" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="FAHS" iso_cc="ZA"/^
<city id="gn5056033" name="London" state="MO" state_name="Missouri" country="US" country_name="United States" lat="40.445" long="-95.23498" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="22276" iso_cc="US"/^
<city id="gn3803838" name="London" state="M" state_name="Miranda" country="VE" country_name="Venezuela" lat="10.36093" long="-66.73159" population="0" timezone="-4" timezone_code="VET" timezone_id="America/Caracas" timezone_offset="-16200" localtime="Thu, 05 Oct 2017 14:51:21 VET" region="SouthAmerica" weather_id="800433" iso_cc="VE"/^
<city id="gn2308696" name="London" state="00" state_name="" country="EK" country_name="Equatorial Guinea" lat="2.26815" long="9.78934" population="0" timezone="1" timezone_code="WAT" timezone_id="Africa/Malabo" timezone_offset="3600" localtime="Thu, 05 Oct 2017 20:21:21 WAT" region="Africa" weather_id="FGBT" iso_cc="GQ"/^
<city id="gn9876172" name="London" state="S" state_name="Southern Province" country="SL" country_name="Sierra Leone" lat="7.65137" long="-12.00293" population="0" timezone="0" timezone_code="GMT" timezone_id="Africa/Freetown" timezone_offset="0" localtime="Thu, 05 Oct 2017 19:21:21 GMT" region="Africa" weather_id="75284" iso_cc="SL"/^
<city id="gn1313003" name="Lonton" state="11" state_name="Kachin" country="BM" country_name="Myanmar [Burma]" lat="25.09229" long="96.28854" population="0" timezone="6" timezone_code="MMT" timezone_id="Asia/Rangoon" timezone_offset="23400" localtime="Fri, 06 Oct 2017 01:51:21 MMT" region="CentralAsia" weather_id="XZKT" iso_cc="MM"/^
<city id="gn5737562" name="London" state="OR" state_name="Oregon" country="US" country_name="United States" lat="43.63457" long="-123.09285" population="0" timezone="-8" timezone_code="PDT" timezone_id="America/Los_Angeles" timezone_offset="-28800" localtime="Thu, 05 Oct 2017 12:21:21 PDT" region="northwest" weather_id="27686" iso_cc="US"/^
<city id="gn5198788" name="London" state="PA" state_name="Pennsylvania" country="US" country_name="United States" lat="41.14367" long="-80.14867" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="28141" iso_cc="US"/^
<city id="gn4073570" name="London" state="AL" state_name="Alabama" country="US" country_name="United States" lat="31.29767" long="-87.08775" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southeast" weather_id="10069" iso_cc="US"/^
<city id="gn4073571" name="London" state="AL" state_name="Alabama" country="US" country_name="United States" lat="32.2732" long="-86.05024" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southeast" weather_id="10392" iso_cc="US"/^
<city id="gn4260673" name="London" state="IN" state_name="Indiana" country="US" country_name="United States" lat="39.6256" long="-85.92026" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/Indiana/Indianapolis" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="15993" iso_cc="US"/^
<city id="gn1489797" name="Tel’manskiy" state="ALT" state_name="Altayskiy" country="RS" country_name="Russia" lat="52.8" long="79.55" population="0" timezone="6" timezone_code="OMST" timezone_id="Asia/Omsk" timezone_offset="21600" localtime="Fri, 06 Oct 2017 01:21:21 OMST" region="Russia" weather_id="73947" iso_cc="RU"/^
<city id="gn2331921" name="London" state="DE" state_name="Delta State" country="NI" country_name="Nigeria" lat="5.72257" long="5.78787" population="0" timezone="1" timezone_code="WAT" timezone_id="Africa/Lagos" timezone_offset="3600" localtime="Thu, 05 Oct 2017 20:21:21 WAT" region="Africa" weather_id="70936" iso_cc="NG"/^
<city id="gn5161176" name="London" state="OH" state_name="Ohio" country="US" country_name="United States" lat="40.91033" long="-82.62934" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="26605" iso_cc="US"/^
</cw_citylist^

1.6 Notes

The "id" parameter is not required to request the data.

2. Current Conditions

The current_conditons product returns available weather data from nearby weather stations. The estimated_conditions returns estimated conditions based on nearby reporting stations and model data.

2.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=current_conditions

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=estimated_conditions

2.2 Request Parameters

2.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
city_name	The location name.
location	The name of the reporting station.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the reporting station in meters or feet.
state	The state code of the reporting station.
state_name	The state name of the reporting station.
country	The country code of the reporting station.
iso_cc	The ISO country code of the reporting station.
country_name	The country name of the reporting station.
daylight	Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
sky_desc	The sky descriptor integer.
sky	The sky descriptor text.
precip_desc	The precipitation descriptor integer.
precip	The precipitation descriptor text.
temp_desc	The temperature descriptor integer.
temp	The temperature descriptor text.
air_desc	The air descriptor integer.
air	The air descriptor text.
description	The text summary of all the descriptors.
temperature	The temperature in Celsius or Fahrenheit.
wind_speed	The wind speed in kilometers per mile or miles per hour.
wind_dir	The wind direction in compass degrees.
wind_short	The cardinal and intercardinal wind direction initials.
wind_long	The cardinal and intercardinal wind direction.
humidity	The humidity in percentage.
dew_point	The dew point temperature in Celsius or Fahrenheit.
comfort	The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
baro_pressure	The barometric pressure in millibars or inches of Mercury.
baro_tendency	The barometric pressure tendency initials.
barometer	The barometric pressure tendency text.
visibility	The visibility in kilometers or miles.
icon	The weather icon integer.
icon_name	The weather icon name.
iso8601	The date and time of the report in ISO 8601 format.

2.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=current_conditions&id=12156

2.5 Example Response(XML)

<report gmt_date="0711232016" unix_date="1479884664.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Tue, 22 Nov 2016 23:13:54 PST" localupdatetime="Tue, 22 Nov 2016 23:04:24 PST" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="current_conditions">
<observation city="KSFO" city_name="San Francisco" location="San Francisco International Airport" latitude="37.6188" longitude="-122.3754" elevation="5.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="18" sky="Overcast" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Overcast. Cool." temperature="14.39" wind_speed="16.68" wind_dir="150" wind_short="SE" wind_long="Southeast" humidity="72" dew_point="9.39" comfort="13.18" baro_pressure="1019.60" baro_tendency="*" barometer="" visibility="16.09" icon="17" icon_name="cloudy" iso8601="2016-11-22T22:56:00.00-08:00"/>
<observation city="KOAK" city_name="Oakland" location="Metro Oakland International Airport" latitude="37.7213" longitude="-122.2207" elevation="6.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="16" sky="Mostly cloudy" precip_desc="7" precip="Light rain" temp_desc="6" temp="Cool" air_desc="*" air="" description="Light rain. Mostly cloudy. Cool." temperature="12.78" wind_speed="22.24" wind_dir="130" wind_short="SE" wind_long="Southeast" humidity="83" dew_point="10.00" comfort="10.71" baro_pressure="1019.70" baro_tendency="*" barometer="" visibility="16.09" icon="34" icon_name="night_sprinkles" iso8601="2016-11-22T22:53:00.00-08:00"/>
</report>

2.6 Notes

The products will return conditions for up to ten nearby locations.

3. Expanded Forecast

The expanded forecast products return daily forecast data for 7 days, 15 days or just for the current day. The times returned are the location's time zone.

3.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=expanded_forecast

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=15day_expanded_forecast

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=day1_forecast

3.2 Request Parameters

3.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
city_name	The location name.
location	The name of the forecast location.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the forecast location in meters or feet.
state	The state code of the forecast location.
state_name	The state name of the forecast location.
country	The country code of the forecast location.
iso_cc	The ISO country code of the forecast location.
country_name	The country name of the forecast location.
distance	The distance to the forecast location in kilometers or miles.
day_sequence	The day sequence in location node (1 through 7).
day_of_week	The day of the week integer (1 = Sunday).
weekday	The day of the week name.
daylight	Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
date	The date of the forecast day in MMDDYY format.
iso8601	The date and time of the forecast day in ISO 8601 format.
high_temp	The forecasted high temperature in Celsius or Fahrenheit.
low_temp	The forecasted low temperature in Celsius or Fahrenheit.
sky_desc	The sky descriptor integer.
sky	The sky descriptor text.
precip_desc	The precipitation descriptor integer.
precip	The precipitation descriptor text.
temp_desc	The temperature descriptor integer.
temp	The temperature descriptor text.
air_desc	The air descriptor integer.
air	The air descriptor text.
description	The text summary of all the descriptors.
uv_index	The UV index integer.
uv	The UV index text.
wind_speed	The wind speed in kilometers per mile or miles per hour.
wind_dir	The wind direction in compass degrees.
wind_short	The cardinal and intercardinal wind direction initials.
wind_long	The cardinal and intercardinal wind direction.
humidity	The relative humidity percentage.
dew_point	The dew point temperature in Celsius or Fahrenheit.
comfort	The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
rainfall	The forecasted rainfall amount in centimeters or inches.
snowfall	The forecasted snowfall amount in centimeters or inches.
precip_prob	The propability of precipitation percentage.
icon	The weather icon integer.
icon_name	The weather icon name.
beaufort	The beaufort scale integer.
beaufort_desc	The beaufort scale text descriptor.
baro_pressure	The barometric pressure in millibars or inches of Mercury.
iso8601	The date and time of the report in ISO 8601 format.

3.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=expanded_forecast&id=22256&metric=false

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=expanded_forecast&id=22256&metric=false&format=json

3.5 Example Response(XML)

<report gmt_date="0011242016" unix_date="1479948644.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 23 Nov 2016 20:23:15 PST" localupdatetime="Wed, 23 Nov 2016 16:50:44 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="expanded_forecast">
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast day_sequence="1" day_of_week="5" weekday="Thursday" daylight="D" date="112416" iso8601="2016-11-24T00:00:00.00-08:00" high_temp="57.92" low_temp="46.22" sky_desc="3" sky="Mostly sunny" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Mostly sunny. Cool." uv_index="0" uv="Minimal" wind_speed="4.91" wind_dir="256" wind_short="W" wind_long="West" humidity="60" dew_point="42.39" comfort="55.63" rainfall="*" snowfall="*" precip_prob="5" icon="2" icon_name="mostly_sunny" beaufort="2" beaufort_desc="Light breeze" baro_pressure="30.37"/>
<forecast day_sequence="2" day_of_week="6" weekday="Friday" daylight="D" date="112516" iso8601="2016-11-25T00:00:00.00-08:00" high_temp="60.08" low_temp="50.18" sky_desc="17" sky="Cloudy" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Cloudy. Cool." uv_index="0" uv="Minimal" wind_speed="12.37" wind_dir="161" wind_short="S" wind_long="South" humidity="67" dew_point="48.27" comfort="57.18" rainfall="*" snowfall="*" precip_prob="19" icon="7" icon_name="cloudy" beaufort="4" beaufort_desc="Moderate breeze" baro_pressure="30.21"/>
<forecast day_sequence="3" day_of_week="7" weekday="Saturday" daylight="D" date="112616" iso8601="2016-11-26T00:00:00.00-08:00" high_temp="58.28" low_temp="53.96" sky_desc="18" sky="Overcast" precip_desc="9" precip="Rain" temp_desc="6" temp="Cool" air_desc="*" air="" description="Rain. Overcast. Cool." uv_index="0" uv="Minimal" wind_speed="14.48" wind_dir="227" wind_short="SW" wind_long="Southwest" humidity="68" dew_point="46.92" comfort="54.37" rainfall="0.50" snowfall="*" precip_prob="98" icon="19" icon_name="rain" beaufort="4" beaufort_desc="Moderate breeze" baro_pressure="29.99"/>

</location>
</report>

4. Conditions & Expanded Forecast

The Conditions and Expanded Forecast product returns a combination of the current_conditions and expanded_forecast product.

4.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=current_one

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=current_extended

4.2 Request Parameters

4.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
city_name	The location name.
location	The name of the reporting station.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the reporting station in meters or feet.
state	The state code of the reporting station.
state_name	The state name of the reporting station.
country	The country code of the reporting station.
iso_cc	The ISO country code of the reporting station.
country_name	The country name of the reporting station.
daylight	Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
sky_desc	The sky descriptor integer.
sky	The sky descriptor text.
precip_desc	The precipitation descriptor integer.
precip	The precipitation descriptor text.
temp_desc	The temperature descriptor integer.
temp	The temperature descriptor text.
air_desc	The air descriptor integer.
air	The air descriptor text.
description	The text summary of all the descriptors.
temperature	The temperature in Celsius or Fahrenheit.
wind_speed	The wind speed in kilometers per mile or miles per hour.
wind_dir	The wind direction in compass degrees.
wind_short	The cardinal and intercardinal wind direction initials.
wind_long	The cardinal and intercardinal wind direction.
humidity	The humidity in percentage.
dew_point	The dew point temperature in Celsius or Fahrenheit.
comfort	The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
baro_pressure	The barometric pressure in millibars or inches of Mercury.
baro_tendency	The barometric pressure tendency initials.
barometer	The barometric pressure tendency text.
visibility	The visibility in kilometers or miles.
icon	The weather icon integer.
icon_name	The weather icon name.
iso8601	The date and time of the report in ISO 8601 format.
city	The location's ID code.
city_name	The location name.
location	The name of the forecast location.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the forecast location in meters or feet.
state	The state code of the forecast location.
state_name	The state name of the forecast location.
country	The country code of the forecast location.
iso_cc	The ISO country code of the forecast location.
country_name	The country name of the forecast location.
distance	The distance to the forecast location in kilometers or miles.
day_sequence	The day sequence in location node (1 through 7).
day_of_week	The day of the week integer 1 = Sunday).
weekday	The day of the week name.
daylight	Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
date	The date of the forecast day in MMDDYY format.
iso8601	The date and time of the forecast day in ISO 8601 format.
high_temp	The forecasted high temperature in Celsius and Fahrenheit.
low_temp	The forecasted low temperature in Celsius and Fahrenheit.
sky_desc	The sky descriptor integer.
sky	The sky descriptor text.
precip_desc	The precipitation descriptor integer.
precip	The precipitation descriptor text.
temp_desc	The temperature descriptor integer.
temp	The temperature descriptor text.
air_desc	The air descriptor integer.
air	The air descriptor text.
description	The text summary of all the descriptors.
uv_index	The UV index integer.
uv	The UV index text.
wind_speed	The wind speed in kilometers per mile or miles per hour.
wind_dir	The wind direction in compass degrees.
wind_short	The cardinal and intercardinal wind direction initials.
wind_long	The cardinal and intercardinal wind direction.
humidity	The relative humidity percentage.
dew_point	The dew point temperature in Celsius or Fahrenheit.
comfort	The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
rainfall	The forecasted rainfall amount in centimeters or inches.
snowfall	The forecasted snowfall amount in centimeters or inches.
precip_prob	The propability of precipitation percentage.
icon	The weather icon integer.
icon_name	The weather icon name.
beaufort	The beaufort scale integer.
beaufort_desc	The beaufort scale text descriptor.
baro_pressure	The barometric pressure in millibars or inches of Mercury.
iso8601	The date and time of the report in ISO 8601 format.

4.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=current_one&id=22257&metric=false

4.5 Example Response(XML)

<report gmt_date="0711242017" unix_date="1479971070.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 23 Nov 2017 23:13:43 PST" localupdatetime="Wed, 23 Nov 2017 23:04:20 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="current_conditions">
<observation city="KOAK" city_name="Oakland" location="Metro Oakland International Airport" latitude="37.7213" longitude="-122.2207" elevation="7.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="7" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="47.90" wind_speed="4.59" wind_dir="90" wind_short="E" wind_long="East" humidity="87" dew_point="43.00" comfort="44.82" baro_pressure="30.37" baro_tendency="*" barometer="" visibility="10.00" icon="13" icon_name="night_clear" iso8701="2017-11-23T22:53:00.00-08:00"/>
<observation city="KSFO" city_name="San Francisco" location="San Francisco International Airport" latitude="37.7188" longitude="-122.3754" elevation="5.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="7" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="51.10" wind_speed="5.75" wind_dir="270" wind_short="W" wind_long="West" humidity="74" dew_point="43.00" comfort="49.08" baro_pressure="30.37" baro_tendency="*" barometer="" visibility="10.00" icon="13" icon_name="night_clear" iso8701="2017-11-23T22:57:00.00-08:00"/>
<observation city="KHWD" city_name="Hayward" location="Hayward Air Terminal" latitude="37.7592" longitude="-122.1218" elevation="14.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="7" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="47.90" wind_speed="7.89" wind_dir="70" wind_short="NE" wind_long="Northeast" humidity="74" dew_point="39.00" comfort="43.47" baro_pressure="30.40" baro_tendency="*" barometer="" visibility="10.00" icon="13" icon_name="night_clear" iso8701="2017-11-23T22:54:00.00-08:00"/>
<observation city="KSQL" city_name="San Carlos Airport" location="San Carlos Airport" latitude="37.5100" longitude="-122.2500" elevation="2.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="7" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="50.00" wind_speed="0.00" wind_dir="0" wind_short="N" wind_long="North" humidity="82" dew_point="44.70" comfort="50.00" baro_pressure="30.39" baro_tendency="*" barometer="" visibility="10.00" icon="13" icon_name="night_clear" iso8701="2017-11-23T22:50:00.00-08:00"/>
<observation city="KCCR" city_name="Concord" location="Buchanan Field" latitude="37.9897" longitude="-122.0579" elevation="7.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="5" temp="Quite cool" air_desc="*" air="" description="Clear. Quite cool." temperature="44.10" wind_speed="0.00" wind_dir="0" wind_short="N" wind_long="North" humidity="82" dew_point="39.00" comfort="44.10" baro_pressure="30.34" baro_tendency="*" barometer="" visibility="10.00" icon="13" icon_name="night_clear" iso8701="2017-11-23T22:53:00.00-08:00"/>
</report>

4.6 Notes

The current_one product will return just the day one of the 7-day forecast.

5. Detailed Forecast

The detailed forecast product returns a rolling forecast broken down into four segments per day (Morning, Afternoon, Evening, Overnight) for the next 48 hours or 5 days.

5.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_forecast

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_forecast_5day

5.2 Request Parameters

5.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
city_name	The location name.
location	The name of the forecast location.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the forecast location in meters or feet.
state	The state code of the forecast location.
state_name	The state name of the forecast location.
country	The country code of the forecast location.
iso_cc	The ISO country code of the forecast location.
country_name	The country name of the forecast location.
distance	The distance to the forecast location in kilometers or miles.
segment	The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_segment	The time segment of the day text.
day_of_week	The day of the week integer 1 = Sunday).
weekday	The day of the week name.
daylight	Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
date	The date of the forecast day in MMDDYY format.
iso8601	The date and time of the forecast day in ISO 8601 format.
high_temp	The forecasted high temperature in Celsius and Fahrenheit.
low_temp	The forecasted low temperature in Celsius and Fahrenheit.
sky_desc	The sky descriptor integer.
sky	The sky descriptor text.
precip_desc	The precipitation descriptor integer.
precip	The precipitation descriptor text.
temp_desc	The temperature descriptor integer.
temp	The temperature descriptor text.
air_desc	The air descriptor integer.
air	The air descriptor text.
description	The text summary of all the descriptors.
wind_speed	The wind speed in kilometers per mile or miles per hour.
wind_dir	The wind direction in compass degrees.
wind_short	The cardinal and intercardinal wind direction initials.
wind_long	The cardinal and intercardinal wind direction.
humidity	The relative humidity percentage.
dew_point	The dew point temperature in Celsius or Fahrenheit.
comfort	The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
rainfall	The forecasted rainfall amount in centimeters or inches.
snowfall	The forecasted snowfall amount in centimeters or inches.
precip_prob	The propability of precipitation percentage.
icon	The weather icon integer.
icon_name	The weather icon name.
beaufort	The beaufort scale integer.
beaufort_desc	The beaufort scale text descriptor.
iso8601	The date and time of the report in ISO 8601 format.

5.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_forecast&id=22256&format=json

5.5 Example Response(XML)

<report gmt_date="0011242016" unix_date="1479948644.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 23 Nov 2016 21:04:26 PST" localupdatetime="Wed, 23 Nov 2016 16:50:44 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="detailed_forecast">
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast segment="E" day_segment="Evening" day_of_week="4" weekday="Wednesday" iso8601="2016-11-23T18:00:00.00-08:00" daylight="N" sky_desc="4" sky="Mostly clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Mostly clear. Cool." temperature="52.52" wind_speed="8.70" beaufort="3" beaufort_desc="Gentle breeze" wind_dir="333" wind_short="NW" wind_long="Northwest" dew_point="43.88" humidity="73" comfort="49.55" visibility="7.56" rainfall="*" snowfall="*" precip_prob="1" icon="14" icon_name="night_mostly_clear"/>
<forecast segment="N" day_segment="Night" day_of_week="4" weekday="Wednesday" iso8601="2016-11-24T00:00:00.00-08:00" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="47.30" wind_speed="5.80" beaufort="2" beaufort_desc="Light breeze" wind_dir="349" wind_short="N" wind_long="North" dew_point="42.80" humidity="84" comfort="44.53" visibility="7.01" rainfall="*" snowfall="*" precip_prob="1" icon="13" icon_name="night_clear"/>
<forecast segment="M" day_segment="Morning" day_of_week="5" weekday="Thursday" iso8601="2016-11-24T06:00:00.00-08:00" daylight="D" sky_desc="3" sky="Mostly sunny" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Mostly sunny. Cool." temperature="46.22" wind_speed="5.36" beaufort="2" beaufort_desc="Light breeze" wind_dir="71" wind_short="E" wind_long="East" dew_point="42.98" humidity="89" comfort="43.52" visibility="7.42" rainfall="*" snowfall="*" precip_prob="0" icon="2" icon_name="mostly_sunny"/>
<forecast segment="A" day_segment="Afternoon" day_of_week="5" weekday="Thursday" iso8601="2016-11-24T12:00:00.00-08:00" daylight="D" sky_desc="3" sky="Mostly sunny" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Mostly sunny. Cool." temperature="57.92" wind_speed="5.13" beaufort="2" beaufort_desc="Light breeze" wind_dir="322" wind_short="NW" wind_long="Northwest" dew_point="42.26" humidity="56" comfort="57.43" visibility="8.47" rainfall="*" snowfall="*" precip_prob="0" icon="2" icon_name="mostly_sunny"/>
<forecast segment="E" day_segment="Evening" day_of_week="5" weekday="Thursday" iso8601="2016-11-24T18:00:00.00-08:00" daylight="N" sky_desc="4" sky="Mostly clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Mostly clear. Cool." temperature="48.56" wind_speed="3.57" beaufort="1" beaufort_desc="Light air" wind_dir="236" wind_short="SW" wind_long="Southwest" dew_point="42.80" humidity="81" comfort="47.52" visibility="7.06" rainfall="*" snowfall="*" precip_prob="2" icon="14" icon_name="night_mostly_clear"/>
</location>
</report>

6. Astronomy Data

The astronomy data product returns the moonrise/moonset and sunrise/sunset times for the current day or the next 5 days.

6.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=astronomy_forecast

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=astronomy_forecast_ext

6.2 Request Parameters

6.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
city_name	The location name.
location	The name of the forecast location.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
sunrise	The location's time of sunrise in h:mm%z format.
sunset	The location's time of sunset in h:mm%z format.
moonrise	The location's time of moonrise in h:mm%z format.
moonset	The location's time of moonset in h:mm%z format.
moon_phase	The moon phase expressed as floating point number between -1 and 1.
moon_phase_desc	The moon phase text.
icon_name	The weather icon name.
iso8601	The date and time of the forecast day in ISO 8601 format.

6.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=astronomy_forecast&id=22256&metric=false

6.5 Example Response(XML)

<report gmt_date="0811232016" unix_date="1479888302.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 23 Nov 2016 21:19:28 PST" localupdatetime="Wed, 23 Nov 2016 00:05:02 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="astronomy_forecast">
<forecast city="12156" city_name="San Francisco" location="San Francisco" latitude="37.77" longitude="-122.42" sunrise="6:59AM" sunset="4:53PM" moonrise="1:33AM" moonset="2:07PM" moon_phase="-0.338" moon_phase_desc="Waning crescent" icon_name="cw_waning_crescent" iso8601="2016-11-23T00:00:00.00-08:00"/>
</report>

7. Detailed Marine

The detailed marine products returns a rolling forecast broken down into four segments per day (Morning, Afternoon, Evening, Overnight) for the next 48 hours or 7 days for the open ocean and 5 days for the Mediterranean daily.

7.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=one_detailed_marine

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_marine_7day

7.2 Request Parameters

7.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
city_name	The location name.
location	The name of the forecast location.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the forecast location in meters or feet.
state	The state code of the forecast location.
state_name	The state name of the forecast location.
country	The country code of the forecast location.
iso_cc	The ISO country code of the forecast location.
country_name	The country name of the forecast location.
distance	The distance to the forecast location in kilometers or miles.
segment	The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_segment	The time segment of the day text.
day_of_week	The day of the week integer 1 = Sunday).
weekday	The day of the week name.
wind_desc	The wind descriptor integer.
wind	The wind descriptor text.
sea_state_desc	The sea state integer.
sea_state	The sea state text.
wave_desc	The wave descriptor integer.
wave	The wave descriptor text.
surf_desc	The surf descriptor integer.
surf	The surf descriptor text.
wind_speed	The wind speed in kilometers per mile or miles per hour.
wind_gusts	The wind gusts in kilometers per mile or miles per hour.
wind_direction	The wind direction in compass degrees.
wind_dir	The wind direction in compass degrees.
wind_short	The cardinal and intercardinal wind direction initials.
wind_long	The cardinal and intercardinal wind direction.
wave_height	The wave height in meters or feet.
mean_wave_direction	The mean wave direction in compass degrees.
mean_wave_direction_short	The cardinal and intercardinal mean wave direction initials.
mean_wave_direction_long	The cardinal and intercardinal mean wave direction.
mean_wave_period	The mean wave period is in seconds.
wind_wave_direction	The wind wave direction in compass degrees.
wind_wave_direction_short	The cardinal and intercardinal wind wave direction initials.
wind_wave_direction_long	The cardinal and intercardinal wind wave direction.
wind_wave_period	The wind wave period is in seconds.
peak_wave_direction	The peak wave direction in compass degrees.
peak_wave_direction_short	The cardinal and intercardinal peak wave direction initials.
peak_wave_direction_long	The cardinal and intercardinal peak wave direction.
peak_wave_period	The peak wave period is in seconds.
sea_surface_temp	The sea surface temperature in Celsius or Fahrenheit.
iso8601	The date and time of the forecast day in ISO 8601 format.

7.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=one_detailed_marine&id=12156&metric=false

7.5 Example Response(XML)

<report gmt_date="0211242016" unix_date="1479954274.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 23 Nov 2016 21:31:55 PST" localupdatetime="Wed, 23 Nov 2016 18:24:34 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="detailed_marine">
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast segment="E" day_segment="Evening" day_of_week="4" weekday="Wednesday" wind_desc="2" wind="Light winds" sea_state_desc="6" sea_state="Rough" wave_desc="5" wave="Big waves" surf_desc="8" surf="Double-overhead waves" wind_speed="8.70" wind_gusts="13.80" wind_direction="356.23" beaufort="3" beaufort_desc="Gentle breeze" wind_dir="356.23" wind_short="N" wind_long="North" wave_height="12.70" mean_wave_direction="296.29" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="12.84" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="297.29" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="14.93" sea_surface_temp="58.32" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_calm" baro_pressure="30.09" iso8601="2016-11-23T18:00:00.00-08:00"/>
<forecast segment="N" day_segment="Night" day_of_week="4" weekday="Wednesday" wind_desc="2" wind="Light winds" sea_state_desc="6" sea_state="Rough" wave_desc="5" wave="Big waves" surf_desc="8" surf="Double-overhead waves" wind_speed="8.12" wind_gusts="12.88" wind_direction="356.20" beaufort="3" beaufort_desc="Gentle breeze" wind_dir="356.20" wind_short="N" wind_long="North" wave_height="12.21" mean_wave_direction="296.87" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="12.87" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="297.59" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="14.83" sea_surface_temp="58.32" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_calm" baro_pressure="30.10" iso8601="2016-11-24T00:00:00.00-08:00"/>
<forecast segment="M" day_segment="Morning" day_of_week="5" weekday="Thursday" wind_desc="2" wind="Light winds" sea_state_desc="6" sea_state="Rough" wave_desc="4" wave="Large waves" surf_desc="7" surf="Overhead waves" wind_speed="7.14" wind_gusts="11.33" wind_direction="16.28" beaufort="3" beaufort_desc="Gentle breeze" wind_dir="16.28" wind_short="N" wind_long="North" wave_height="10.89" mean_wave_direction="297.68" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="12.56" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="298.62" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="14.43" sea_surface_temp="58.32" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_calm" baro_pressure="30.11" iso8601="2016-11-24T06:00:00.00-08:00"/>
</location>
</report>

8. Extended Marine

The extended marine product returns open ocean 7-day and Mediterranean Sea 5-day daily marine forecast data.

8.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=one_extended_marine

8.2 Request Parameters

8.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
city_name	The location name.
location	The name of the forecast location.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the forecast location in meters or feet.
state	The state code of the forecast location.
state_name	The state name of the forecast location.
country	The country code of the forecast location.
iso_cc	The ISO country code of the forecast location.
country_name	The country name of the forecast location.
distance	The distance to the forecast location in kilometers or miles.
day_sequence	The day sequence in location node (1 through 7).
day_of_week	The day of the week integer 1 = Sunday).
weekday	The day of the week name.
wind_desc	The wind descriptor integer.
wind	The wind descriptor text.
sea_state_desc	The sea state integer.
sea_state	The sea state text.
wave_desc	The wave descriptor integer.
wave	The wave descriptor text.
surf_desc	The surf descriptor integer.
surf	The surf descriptor text.
wind_speed	The wind speed in kilometers per mile or miles per hour.
wind_gusts	The wind gusts in kilometers per mile or miles per hour.
wind_direction	The wind direction in compass degrees.
wind_dir	The wind direction in compass degrees.
wind_short	The cardinal and intercardinal wind direction initials.
wind_long	The cardinal and intercardinal wind direction.
wave_height	The wave height in meters or feet.
mean_wave_direction	The mean wave direction in compass degrees.
mean_wave_direction_short	The cardinal and intercardinal mean wave direction initials.
mean_wave_direction_long	The cardinal and intercardinal mean wave direction.
mean_wave_period	The mean wave period is in seconds.
wind_wave_direction	The wind wave direction in compass degrees.
wind_wave_direction_short	The cardinal and intercardinal wind wave direction initials.
wind_wave_direction_long	The cardinal and intercardinal wind wave direction.
wind_wave_period	The wind wave period is in seconds.
peak_wave_direction	The peak wave direction in compass degrees.
peak_wave_direction_short	The cardinal and intercardinal peak wave direction initials.
peak_wave_direction_long	The cardinal and intercardinal peak wave direction.
peak_wave_period	The peak wave period is in seconds.
sea_surface_temp	The sea surface temperature in Celsius or Fahrenheit.
baro_pressure	The barometric pressure in millibars or inches of Mercury.
iso8601	The date and time of the forecast day in ISO 8601 format.

8.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=one_extended_marine&id=22256&metric=false

8.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1410202017" unix_date="1508509529.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Fri, 20 Oct 2017 10:30:26 PDT" localupdatetime="Fri, 20 Oct 2017 07:25:29 PDT" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="extended_marine" >
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast day_sequence="1" day_of_week="6" weekday="Friday" wind_desc="3" wind="Breezy conditions" sea_state_desc="6" sea_state="Rough" wave_desc="5" wave="Big waves" surf_desc="8" surf="Double-overhead waves" wind_speed="19.40" wind_gusts="30.79" wind_direction="307.75" beaufort="4" beaufort_desc="Moderate breeze" wind_dir="307.75" wind_short="NW" wind_long="Northwest" wave_height="4.59" mean_wave_direction="299.88" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="13.58" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="300.9" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="15.91" sea_surface_temp="14.57" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_light" baro_pressure="1017.96" iso8601="2017-10-20T00:00:00.00-07:00" />
<forecast day_sequence="2" day_of_week="7" weekday="Saturday" wind_desc="3" wind="Breezy conditions" sea_state_desc="6" sea_state="Rough" wave_desc="4" wave="Large waves" surf_desc="7" surf="Overhead waves" wind_speed="18.26" wind_gusts="28.98" wind_direction="324.45" beaufort="4" beaufort_desc="Moderate breeze" wind_dir="324.45" wind_short="NW" wind_long="Northwest" wave_height="3.03" mean_wave_direction="300.92" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="11.77" wind_wave_direction="340.63" wind_wave_direction_short="N" wind_wave_direction_long="North" wind_wave_period="4.01" peak_wave_direction="301.68" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="13.52" sea_surface_temp="14.57" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_light" baro_pressure="1018.29" iso8601="2017-10-21T00:00:00.00-07:00" />
<forecast day_sequence="3" day_of_week="1" weekday="Sunday" wind_desc="4" wind="Windy conditions" sea_state_desc="4" sea_state="Moderate Chop" wave_desc="4" wave="Large waves" surf_desc="7" surf="Overhead waves" wind_speed="29.27" wind_gusts="46.45" wind_direction="334.43" beaufort="5" beaufort_desc="Fresh breeze" wind_dir="334.43" wind_short="NW" wind_long="Northwest" wave_height="2.92" mean_wave_direction="302.03" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="10.72" wind_wave_direction="318.26" wind_wave_direction_short="NW" wind_wave_direction_long="Northwest" wind_wave_period="7.0" peak_wave_direction="301.3" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="12.36" sea_surface_temp="14.57" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_light" baro_pressure="1018.62" iso8601="2017-10-22T00:00:00.00-07:00" />
<forecast day_sequence="4" day_of_week="2" weekday="Monday" wind_desc="3" wind="Breezy conditions" sea_state_desc="6" sea_state="Rough" wave_desc="4" wave="Large waves" surf_desc="7" surf="Overhead waves" wind_speed="18.57" wind_gusts="29.47" wind_direction="339.65" beaufort="4" beaufort_desc="Moderate breeze" wind_dir="339.65" wind_short="N" wind_long="North" wave_height="3.00" mean_wave_direction="296.86" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="12.18" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="293.31" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="15.39" sea_surface_temp="14.57" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_light" baro_pressure="1018.96" iso8601="2017-10-23T00:00:00.00-07:00" />
<forecast day_sequence="5" day_of_week="3" weekday="Tuesday" wind_desc="3" wind="Breezy conditions" sea_state_desc="3" sea_state="Light Chop" wave_desc="4" wave="Large waves" surf_desc="7" surf="Overhead waves" wind_speed="17.93" wind_gusts="28.45" wind_direction="334.91" beaufort="3" beaufort_desc="Gentle breeze" wind_dir="334.91" wind_short="NW" wind_long="Northwest" wave_height="2.42" mean_wave_direction="296.02" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="11.64" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="286.47" peak_wave_direction_short="W" peak_wave_direction_long="West" peak_wave_period="14.71" sea_surface_temp="14.57" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_light" baro_pressure="1019.29" iso8601="2017-10-24T00:00:00.00-07:00" />
</location>
</report>

9. Hourly Forecast

The hourly forecast product returns hourly forecasts for 12 hours, 48 hours, 7 days or 15 days.

9.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=hourly_forecast

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=hourly_forecast_12hr

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=hourly_forecast_48hr

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=15day_hourly_forecast

9.2 Request Parameters

9.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
city_name	The location name.
location	The name of the forecast location.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the forecast location in meters or feet.
state	The state code of the forecast location.
state_name	The state name of the forecast location.
country	The country code of the forecast location.
iso_cc	The ISO country code of the forecast location.
country_name	The country name of the forecast location.
distance	The distance to the forecast location in kilometers or miles.
id	The location's ID code.
utc_time	The GMT time and date of the forecast hour in HHMMDDYYYY format.
local_time	The local time and date of the forecast hour in HHMMDDYYYY format.
date_format	Format of utc_time and local_time.
day_of_week_utc	The GMT day of the week integer (1 = Sunday).
day_of_week_local	The local day of the week integer (1 = Sunday).
weekday_utc	The GMT day of the week name.
weekday_local	The local day of the week name.
daylight	Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
sky_desc	The sky descriptor integer.
sky	The sky descriptor text.
precip_desc	The precipitation descriptor integer.
precip	The precipitation descriptor text.
temp_desc	The temperature descriptor integer.
temp	The temperature descriptor text.
air_desc	The air descriptor integer.
air	The air descriptor text.
description	The text summary of all the descriptors.
temperature	The temperature in Celsius or Fahrenheit.
wind_speed	The wind speed in kilometers per mile or miles per hour.
wind_dir	The wind direction in compass degrees.
wind_short	The cardinal and intercardinal wind direction initials.
wind_long	The cardinal and intercardinal wind direction.
humidity	The humidity in percentage.
dew_point	The dew point temperature in Celsius or Fahrenheit.
comfort	The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
visibility	The visibility in kilometers or miles.
precip_prob	The propability of precipitation percentage.
icon	The weather icon integer.
icon_name	The weather icon name.
iso8601	The date and time of the forecast in ISO 8601 format.

9.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=hourly_forecast&id=12156&format=json

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=hourly_forecast&latitude=38.529&longitude=-121.286

9.5 Example Response(XML)

<report gmt_date="0811242016" unix_date="1489985836.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Thu, 24 Nov 2016 00:54:35 PST" localupdatetime="Thu, 24 Nov 2016 00:22:16 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="38.88" tzinfo="America/Los_Angeles" elevation="10.00" name="hourly_forecast">
<location city="12156" city_name="San Francisco" latitude="38.88" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast id="12156" utc_time="0811242016" local_time="2311232016" date_format="HHMMddyyyy" day_of_week_utc="5" day_of_week_local="4" weekday_utc="Thursday" weekday_local="Wednesday" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="51.08" wind_speed="9.82" wind_dir="354" wind_short="N" wind_long="North" dew_point="41.90" humidity="81" comfort="48.41" visibility="8.48" rainfall="*" snowfall="*" precip_prob="0" icon="13" icon_name="night_clear" iso8601="2016-11-23T23:00:00.00-08:00"/>
<forecast id="12156" utc_time="0811242016" local_time="0011242016" date_format="HHMMddyyyy" day_of_week_utc="5" day_of_week_local="5" weekday_utc="Thursday" weekday_local="Thursday" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="50.36" wind_speed="10.04" wind_dir="6" wind_short="N" wind_long="North" dew_point="41.54" humidity="82" comfort="46.44" visibility="8.98" rainfall="*" snowfall="*" precip_prob="0" icon="13" icon_name="night_clear" iso8601="2016-11-24T00:00:00.00-08:00"/>
<forecast id="12156" utc_time="0911242016" local_time="0111242016" date_format="HHMMddyyyy" day_of_week_utc="5" day_of_week_local="5" weekday_utc="Thursday" weekday_local="Thursday" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="49.28" wind_speed="8.80" wind_dir="28" wind_short="NE" wind_long="Northeast" dew_point="41.54" humidity="85" comfort="45.58" visibility="8.53" rainfall="*" snowfall="*" precip_prob="0" icon="13" icon_name="night_clear" iso8601="2016-11-24T01:00:00.00-08:00"/>
<forecast id="12156" utc_time="1011242016" local_time="0211242016" date_format="HHMMddyyyy" day_of_week_utc="5" day_of_week_local="5" weekday_utc="Thursday" weekday_local="Thursday" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="48.02" wind_speed="8.48" wind_dir="35" wind_short="NE" wind_long="Northeast" dew_point="41.36" humidity="88" comfort="44.11" visibility="8.03" rainfall="*" snowfall="*" precip_prob="0" icon="13" icon_name="night_clear" iso8601="2016-11-24T02:00:00.00-08:00"/>
</location>
</report>

10. Buoy Data

The buoy data product returns buoy data from available worldwide stations.

10.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=buoy_report

10.2 Request Parameters

10.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
buoy_Id	The buoy's ID code.
buoy_name	The buoy name.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
date	The date and time of the data in MMDDHH format.
air_temperature	The air temperature in Celsius or Fahrenheit.
dew_point	The dew point temperature in Celsius or Fahrenheit.
wind_speed	The wind speed in kilometers per mile or miles per hour.
wind_gusts	The wind gusts in kilometers per mile or miles per hour.
wind_direction	The wind direction in compass degrees.
wind_short	The cardinal and intercardinal wind direction initials.
wind_long	The cardinal and intercardinal wind direction.
humidity	The humidity in percentage.
beaufort_desc	The beaufort scale text descriptor.
baro_pressure	The barometric pressure in millibars or inches of Mercury.
baro_pressure	The barometric pressure in millibars or inches of Mercury.
baro_tendency	The barometric pressure tendency initials.
barometer	The barometric pressure tendency text.
visibility	The visibility in kilometers or miles.
water_temperature	The water temperature in Celsius or Fahrenheit.
wave_height	The wave height in meters or feet.
wave_period	The wave period in seconds.
iso8601	The date and time of the report in ISO 8601 format.

10.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=buoy_report&id=12156&metric=false

10.5 Example Response(XML)

<report gmt_date="0911242016" unix_date="1479977703.000000" timezone="-9" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Thu, 24 Nov 2016 01:26:14 PST" localupdatetime="Thu, 24 Nov 2016 00:55:03 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="buoy_report">
<observation buoy_id="bRTYC1" buoy_name="Redwood City" latitude="37.51" longitude="-122.21" date="112409" air_temperature="47.70" dew_point="*" wind_speed="2.30" wind_gusts="*" wind_direction="190" beaufort="1" beaufort_desc="Light air" wind_short="S" wind_long="South" baro_pressure="30.36" baro_tendency="*" barometer="Rising" visibility="*" water_temperature="59.29" wave_height="*" wave_period="*"/>
<observation buoy_id="b46026" buoy_name="San Francisco" latitude="37.76" longitude="-122.93" date="112409" air_temperature="54.50" dew_point="*" wind_speed="9.04" wind_gusts="*" wind_direction="340" beaufort="3" beaufort_desc="Gentle breeze" wind_short="N" wind_long="North" baro_pressure="30.36" baro_tendency="0.0" barometer="Steady" visibility="*" water_temperature="56.66" wave_height="10.17" wave_period="4.0"/>
<observation buoy_id="bPCOC1" buoy_name="Port Chicago" latitude="39.06" longitude="-122.04" date="112409" air_temperature="46.90" dew_point="*" wind_speed="9.19" wind_gusts="*" wind_direction="190" beaufort="3" beaufort_desc="Gentle breeze" wind_short="S" wind_long="South" baro_pressure="30.35" baro_tendency="*" barometer="Rising" visibility="*" water_temperature="59.46" wave_height="*" wave_period="*"/>
<observation buoy_id="b46012" buoy_name="Half Moon Bay" latitude="37.39" longitude="-122.72" date="112409" air_temperature="55.90" dew_point="*" wind_speed="9.04" wind_gusts="*" wind_direction="350" beaufort="3" beaufort_desc="Gentle breeze" wind_short="N" wind_long="North" baro_pressure="30.34" baro_tendency="0.0" barometer="Steady" visibility="*" water_temperature="59.10" wave_height="14.76" wave_period="4.0"/>
<observation buoy_id="b46013" buoy_name="Bodega" latitude="39.22" longitude="-123.33" date="112409" air_temperature="54.70" dew_point="45.10" wind_speed="9.04" wind_gusts="*" wind_direction="350" beaufort="3" beaufort_desc="Gentle breeze" wind_short="N" wind_long="North" baro_pressure="30.39" baro_tendency="*" barometer="Rising" visibility="*" water_temperature="57.56" wave_height="*" wave_period="*"/>
<observation buoy_id="b46042" buoy_name="Monterey" latitude="36.75" longitude="-122.42" date="112409" air_temperature="55.90" dew_point="*" wind_speed="*" wind_gusts="*" wind_direction="*" beaufort="0" beaufort_desc="Calm" wind_short="" wind_long="" baro_pressure="30.35" baro_tendency="0.3" barometer="Rising" visibility="*" water_temperature="57.20" wave_height="15.09" wave_period="6.0"/>
<observation buoy_id="b46114" buoy_name="West Monterey Bay" latitude="36.71" longitude="-122.342" date="112409" air_temperature="*" dew_point="*" wind_speed="*" wind_gusts="*" wind_direction="*" beaufort="0" beaufort_desc="Calm" wind_short="" wind_long="" baro_pressure="*" baro_tendency="*" barometer="Rising" visibility="*" water_temperature="57.02" wave_height="14.76" wave_period="11.3"/>
</report>

11. Detailed Fire Danger

The fire danger product returns the probability of fire danger for specific areas based on soil moisture and weather conditions broken down into four segments per day (Morning, Afternoon, Evening, Overnight) for the next 48 hours. Indicates the reason for probability, for example, high winds.

11.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_fire_danger

11.2 Request Parameters

11.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
city_name	The location name.
location	The name of the forecast location.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the forecast location in meters or feet.
state	The state code of the forecast location.
state_name	The state name of the forecast location.
country	The country code of the forecast location.
iso_cc	The ISO country code of the forecast location.
country_name	The country name of the forecast location.
distance	The distance to the forecast location in kilometers or miles.
segment	The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_segment	The time segment of the day text.
day_of_week	The day of the week integer 1 = Sunday).
weekday	The day of the week name.
danger_level	The fire danger level integer (0-4).
level	The fire danger text.
danger_reason	The fire danger reason integer (0-8).
reason	The fire danger reason text.
upper_soil_moisture	The upper soil moisture in mm or inches.
lower_soil_moisture	The lower soil moisture in mm or inches.
icon_name	The weather icon name.
iso8601	The date and time of the forecast in ISO 8601 format.

11.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_fire_danger&id=12156&metric=false

11.5 Example Response(XML)

<report gmt_date="0611242016" unix_date="147101067511.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Thu, 24 Nov 2016 01:310:16 PST" localupdatetime="Wed, 23 Nov 2016 22:05:11 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="detailed_fire_danger">
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast segment="N" day_segment="Night" day_of_week="4" weekday="Wednesday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T00:00:00.00-08:00"/>
<forecast segment="M" day_segment="Morning" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T06:00:00.00-08:00"/>
<forecast segment="A" day_segment="Afternoon" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T12:00:00.00-08:00"/>
<forecast segment="E" day_segment="Evening" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T18:00:00.00-08:00"/>
<forecast segment="N" day_segment="Night" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T00:00:00.00-08:00"/>
<forecast segment="M" day_segment="Morning" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T06:00:00.00-08:00"/>
<forecast segment="A" day_segment="Afternoon" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T12:00:00.00-08:00"/>
<forecast segment="E" day_segment="Evening" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T18:00:00.00-08:00"/>
</location>
</report>

12. Extended Fire Danger

The fire danger product returns the probability of fire danger for specific areas based on soil moisture and weather conditions for the next 5 days. Indicates the reason for probability, for example, high winds.

12.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=extended_fire_danger

12.2 Request Parameters

12.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
city_name	The location name.
location	The name of the forecast location.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the forecast location in meters or feet.
state	The state code of the forecast location.
state_name	The state name of the forecast location.
country	The country code of the forecast location.
iso_cc	The ISO country code of the forecast location.
country_name	The country name of the forecast location.
distance	The distance to the forecast location in kilometers or miles.
segment	The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_segment	The time segment of the day text.
day_of_week	The day of the week integer 1 = Sunday).
weekday	The day of the week name.
danger_level	The fire danger level integer (0-4).
level	The fire danger text.
danger_reason	The fire danger reason integer (0-8).
reason	The fire danger reason text.
upper_soil_moisture	The upper soil moisture in mm or inches.
lower_soil_moisture	The lower soil moisture in mm or inches.
icon_name	The weather icon name.
iso8601	The date and time of the forecast in ISO 8601 format.

12.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_fire_danger&id=12156&metric=false

12.5 Example Response(XML)

<report gmt_date="0611242016" unix_date="147101067511.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Thu, 24 Nov 2016 01:310:16 PST" localupdatetime="Wed, 23 Nov 2016 22:05:11 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="detailed_fire_danger">
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast segment="N" day_segment="Night" day_of_week="4" weekday="Wednesday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T00:00:00.00-08:00"/>
<forecast segment="M" day_segment="Morning" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T06:00:00.00-08:00"/>
<forecast segment="A" day_segment="Afternoon" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T12:00:00.00-08:00"/>
<forecast segment="E" day_segment="Evening" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T18:00:00.00-08:00"/>
<forecast segment="N" day_segment="Night" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T00:00:00.00-08:00"/>
<forecast segment="M" day_segment="Morning" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T06:00:00.00-08:00"/>
<forecast segment="A" day_segment="Afternoon" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T12:00:00.00-08:00"/>
<forecast segment="E" day_segment="Evening" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T18:00:00.00-08:00"/>
</location>
</report>

13. Hurricane

The hurricane products returns all the active tropical storms.

13.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=hurricane

13.2 Request Parameters

13.3 Response Object

Field	Description
gmt_date	The update time of the product in UTC time in HHMMDDYYYY format.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
code	The CustomWeather storm code (YYYY_stormname)
name	Full name of the tropical system
current_pressue	The tropical system's current pressure
current_movement_deg	The tropical system's current movement in degrees
current_movement_kmh	The tropical system's current speed in kilometers per hour (if metric units are requested)
current_movement_mph	The tropical system's current speed in miles per hour (if Imperial units are requested)
iso_date	The date and time of the update in ISO 8601 format.
utc_time	The date and time of the update in %m/%d/%Y %H:%M format in UTC time.
locale_time	Same as utc_time
latitude	The latitude coordinates in decimal degrees of the tropical system's current position.
longitude	The longitude coordinates in decimal degrees of the tropical system's current position.
wind_speed	The tropical system's current wind speed.
wind_gusts	The tropical system's current wind gusts.
category	The category strength of the tropical system.
storm_name	The tropical system's name.
local_storm_name	The tropical system's local name.
type	Observation or forecast.
comments	Comment from the National Hurricane Center.
NE_12ft_radii	12 foot sea radii in NE quadrant in feet or meters.
SE_12ft_radii	12 foot sea radii in SE quadrant in feet or meters.
SW_12ft_radii	12 foot sea radii in SW quadrant in feet or meters.
NW_12ft_radii	12 foot sea radii in NW quadrant in feet or meters.
minimum_wind_speed	The minimum wind speed radii in knots. The subsequent quadrant attributes return the distance of the radii.
northeast	The distance in miles or kilometers of the wind radii in the northeast quadrant.
southeast	The distance in miles or kilometers of the wind radii in the southeast quadrant.
southwest	The distance in miles or kilometers of the wind radii in the southwest quadrant.
northwest	The distance in miles or kilometers of the wind radii in the northwest quadrant.
iso8601	The date and time of the report in ISO 8601 format.

13.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=hurricane

13.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1710202017" unix_date="1508521492.000000">
<hurricane code="2017_25W" name="Tropical Depression TWENTYFIVE" current_pressure="1012.312" current_movement_deg="300" current_movement_kmh="11.11">
    <period iso_date="2017-10-15T12:00:00Z" utc_time="10/15/2017 12:00 UTC" locale_time="10/15/2017 12:00 UTC" latitude="9.3" longitude="136.8" wind_speed="46.3" wind_gusts="64.82" category="Tropical Depression" storm_name="TWENTYFIVE" local_storm_name="Tropical Depression TWENTYFIVE" type="observation" comments="151500Z POSITION NEAR 9.5N 136.5E. TROPICAL DEPRESSION 25W (TWENTYFIVE), LOCATED APPROXIMATELY 78 NM WEST OF YAP, CNMI, HAS TRACKED WEST-NORTHWESTWARD AT 06 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 151200Z IS 8 FEET. NEXT WARNINGS AT 152100Z, 160300Z, 160900Z AND 161500Z. REFER TO TYPHOON 24W (KHANUN) WARNINGS (WTPN31 PGTW) FOR SIX-HOURLY UPDATES. THIS CANCELS AND SUPERSEDES REF A (WTPN21 PGTW 150230)." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="1012">
        <wind_radii minimum_wind_speed="34.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
        <wind_radii minimum_wind_speed="50.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-16T06:00:00Z" utc_time="10/16/2017 06:00 UTC" locale_time="10/16/2017 06:00 UTC" latitude="11.0" longitude="134.7" wind_speed="64.82" wind_gusts="83.34" category="Tropical Storm" storm_name="LAN" local_storm_name="Tropical Depression LAN" type="observation" comments="160900Z POSITION NEAR 11.1N 134.4E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 220 NM WEST-NORTHWEST OF YAP, FSM, HAS TRACKED WEST-NORTHWESTWARD AT 11 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 160600Z IS 12 FEET. NEXT WARNINGS AT 161500Z, 162100Z, 170300Z AND 170900Z. REFER TO TROPICAL DEPRESSION 24W (KHANUN) WARNINGS (WTPN31 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="1007">
        <wind_radii minimum_wind_speed="34.0" northeast="101.85" southeast="194.45" southwest="74.08" northwest="92.6"/>
        <wind_radii minimum_wind_speed="50.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-16T12:00:00Z" utc_time="10/16/2017 12:00 UTC" locale_time="10/16/2017 12:00 UTC" latitude="10.7" longitude="133.3" wind_speed="64.82" wind_gusts="83.34" category="Tropical Storm" storm_name="LAN" local_storm_name="Tropical Depression LAN" type="observation" comments="161500Z POSITION NEAR 10.8N 133.1E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 214 NM NORTH- NORTHWEST OF KOROR, PALAU, HAS TRACKED WESTWARD AT 12 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 161200Z IS 12 FEET. NEXT WARNINGS AT 162100Z, 170300Z, 170900Z AND 171500Z. REFER TO TROPICAL CYCLONE 24W (KHANUN) WARNINGS (WTPN31 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="1007">
        <wind_radii minimum_wind_speed="34.0" northeast="101.85" southeast="194.45" southwest="74.08" northwest="92.6"/>
        <wind_radii minimum_wind_speed="50.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-16T18:00:00Z" utc_time="10/16/2017 18:00 UTC" locale_time="10/16/2017 18:00 UTC" latitude="10.7" longitude="132.3" wind_speed="74.08" wind_gusts="92.6" category="Tropical Storm" storm_name="LAN" local_storm_name="Tropical Storm LAN" type="observation" comments="162100Z POSITION NEAR 10.7N 132.1E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 239 NM NORTH- NORTHWEST OF KOROR, HAS TRACKED WESTWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 161800Z IS 15 FEET. NEXT WARNINGS AT 170300Z, 170900Z, 171500Z AND 172100Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="1003">
        <wind_radii minimum_wind_speed="34.0" northeast="259.27" southeast="138.89" southwest="138.89" northwest="259.27"/>
        <wind_radii minimum_wind_speed="50.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-17T06:00:00Z" utc_time="10/17/2017 06:00 UTC" locale_time="10/17/2017 06:00 UTC" latitude="10.0" longitude="132.2" wind_speed="92.6" wind_gusts="120.37" category="Tropical Storm" storm_name="LAN" local_storm_name="Tropical Storm LAN" type="observation" comments="170900Z POSITION NEAR 10.2N 132.2E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 187 NM NORTHWEST OF KAYANGEL, HAS TRACKED SOUTH-SOUTHEASTWARD AT 03 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 170600Z IS 18 FEET. NEXT WARNINGS AT 171500Z, 172100Z, 180300Z AND 180900Z. " NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="994">
        <wind_radii minimum_wind_speed="34.0" northeast="148.15" southeast="120.37" southwest="120.37" northwest="166.67"/>
        <wind_radii minimum_wind_speed="50.0" northeast="64.82" southeast="46.3" southwest="46.3" northwest="74.08"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-17T12:00:00Z" utc_time="10/17/2017 12:00 UTC" locale_time="10/17/2017 12:00 UTC" latitude="10.2" longitude="132.4" wind_speed="101.85" wind_gusts="129.63" category="Tropical Storm" storm_name="LAN" local_storm_name="Severe Tropical Storm LAN" type="observation" comments="171500Z POSITION NEAR 10.6N 132.4E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 186 NM NORTHWEST OF KAYANGEL, HAS TRACKED NORTHEASTWARD AT 03 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 171200Z IS 18 FEET. NEXT WARNINGS AT 172100Z, 180300Z, 180900Z AND 181500Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="981">
        <wind_radii minimum_wind_speed="34.0" northeast="148.15" southeast="175.93" southwest="194.45" northwest="185.19"/>
        <wind_radii minimum_wind_speed="50.0" northeast="64.82" southeast="83.34" southwest="92.6" northwest="92.6"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-17T18:00:00Z" utc_time="10/17/2017 18:00 UTC" locale_time="10/17/2017 18:00 UTC" latitude="10.8" longitude="132.4" wind_speed="111.11" wind_gusts="138.89" category="Tropical Storm" storm_name="LAN" local_storm_name="Severe Tropical Storm LAN" type="observation" comments="172100Z POSITION NEAR 11.2N 132.4E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 212 NM NORTHWEST OF KAYANGEL, HAS TRACKED NORTH-NORTHEASTWARD AT 04 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 171800Z IS 21 FEET. NEXT WARNINGS AT 180300Z, 180900Z, 181500Z AND 182100Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="981">
        <wind_radii minimum_wind_speed="34.0" northeast="240.75" southeast="370.38" southwest="370.38" northwest="240.75"/>
        <wind_radii minimum_wind_speed="50.0" northeast="111.11" southeast="138.89" southwest="138.89" northwest="111.11"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-18T00:00:00Z" utc_time="10/18/2017 00:00 UTC" locale_time="10/18/2017 00:00 UTC" latitude="12.1" longitude="132.3" wind_speed="120.37" wind_gusts="148.15" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="180300Z POSITION NEAR 12.5N 132.2E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 314 NM NORTH-NORTHWEST OF KOROR, HAS TRACKED NORTHWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 180000Z IS 25 FEET. NEXT WARNINGS AT 180900Z, 181500Z, 182100Z AND 190300Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="981">
        <wind_radii minimum_wind_speed="34.0" northeast="305.56" southeast="351.86" southwest="379.64" northwest="231.49"/>
        <wind_radii minimum_wind_speed="50.0" northeast="166.67" southeast="194.45" southwest="212.97" northwest="120.37"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-18T06:00:00Z" utc_time="10/18/2017 06:00 UTC" locale_time="10/18/2017 06:00 UTC" latitude="12.9" longitude="132.3" wind_speed="120.37" wind_gusts="148.15" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="180900Z POSITION NEAR 13.4N 132.1E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 321 NM NORTH-NORTHWEST OF KAYANGEL, HAS TRACKED NORTHWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 180600Z IS 25 FEET. NEXT WARNINGS AT 181500Z, 182100Z, 190300Z AND 190900Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="981">
        <wind_radii minimum_wind_speed="34.0" northeast="333.34" southeast="398.16" southwest="379.64" northwest="250.01"/>
        <wind_radii minimum_wind_speed="50.0" northeast="166.67" southeast="194.45" southwest="212.97" northwest="120.37"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-18T12:00:00Z" utc_time="10/18/2017 12:00 UTC" locale_time="10/18/2017 12:00 UTC" latitude="14.2" longitude="131.8" wind_speed="120.37" wind_gusts="148.15" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="181500Z POSITION NEAR 14.5N 131.6E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 404 NM NORTH-NORTHWEST OF KAYANGEL, HAS TRACKED NORTH-NORTHWESTWARD AT 14 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 181200Z IS 25 FEET. NEXT WARNINGS AT 182100Z, 190300Z, 190900Z AND 191500Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="977">
        <wind_radii minimum_wind_speed="34.0" northeast="314.82" southeast="592.61" southwest="500.01" northwest="370.38"/>
        <wind_radii minimum_wind_speed="50.0" northeast="166.67" southeast="259.27" southwest="231.49" northwest="148.15"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-18T18:00:00Z" utc_time="10/18/2017 18:00 UTC" locale_time="10/18/2017 18:00 UTC" latitude="14.7" longitude="131.4" wind_speed="120.37" wind_gusts="148.15" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="182100Z POSITION NEAR 15.1N 131.2E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 441 NM NORTH-NORTHWEST OF KAYANGEL, HAS TRACKED NORTH-NORTHWESTWARD AT 08 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 181800Z IS 27 FEET. NEXT WARNINGS AT 190300Z, 190900Z, 191500Z AND 192100Z. REFER TO TROPICAL CYCLONE 26W (TWENTYSIX) WARNINGS (WTPN31 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="977">
        <wind_radii minimum_wind_speed="34.0" northeast="305.56" southeast="305.56" southwest="175.93" northwest="296.3"/>
        <wind_radii minimum_wind_speed="50.0" northeast="166.67" southeast="166.67" southwest="83.34" northwest="157.41"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-19T00:00:00Z" utc_time="10/19/2017 00:00 UTC" locale_time="10/19/2017 00:00 UTC" latitude="15.4" longitude="130.6" wind_speed="120.37" wind_gusts="148.15" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="190300Z POSITION NEAR 15.8N 130.4E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 500 NM NORTH-NORTHWEST OF KAYANGEL, HAS TRACKED NORTHWESTWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 190000Z IS 28 FEET. NEXT WARNINGS AT 190900Z, 191500Z, 192100Z AND 200300Z. REFER TO TROPICAL DEPRESSION 26W (TWENTYSIX) WARNINGS (WTPN31 PGTW) FOR SIX- HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="977">
        <wind_radii minimum_wind_speed="34.0" northeast="259.27" southeast="259.27" southwest="222.23" northwest="185.19"/>
        <wind_radii minimum_wind_speed="50.0" northeast="138.89" southeast="138.89" southwest="111.11" northwest="92.6"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-19T06:00:00Z" utc_time="10/19/2017 06:00 UTC" locale_time="10/19/2017 06:00 UTC" latitude="16.3" longitude="130.1" wind_speed="138.89" wind_gusts="166.67" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="190900Z POSITION NEAR 16.7N 130.0E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 625 NM SOUTH-SOUTHEAST OF KADENA AB, OKINAWA, JAPAN, HAS TRACKED NORTH-NORTHWESTWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 190600Z IS 30 FEET. NEXT WARNINGS AT 191500Z, 192100Z, 200300Z AND 200900Z. REFER TO TROPICAL DEPRESSION 26W (TWENTYSIX) WARNINGS (WTPN31 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="968">
        <wind_radii minimum_wind_speed="34.0" northeast="407.42" southeast="425.94" southwest="324.08" northwest="305.56"/>
        <wind_radii minimum_wind_speed="50.0" northeast="212.97" southeast="240.75" southwest="175.93" northwest="166.67"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-19T12:00:00Z" utc_time="10/19/2017 12:00 UTC" locale_time="10/19/2017 12:00 UTC" latitude="16.9" longitude="130.0" wind_speed="138.89" wind_gusts="166.67" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="191500Z POSITION NEAR 17.2N 130.0E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 589 NM SOUTH-SOUTHEAST OF KADENA AB, OKINAWA, JAPAN, HAS TRACKED NORTHWARD AT 06 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 191200Z IS 30 FEET. NEXT WARNINGS AT 192100Z, 200300Z, 200900Z AND 201500Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="968">
        <wind_radii minimum_wind_speed="34.0" northeast="601.87" southeast="675.94" southwest="620.39" northwest="388.9"/>
        <wind_radii minimum_wind_speed="50.0" northeast="351.86" southeast="398.16" southwest="370.38" northwest="222.23"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-19T18:00:00Z" utc_time="10/19/2017 18:00 UTC" locale_time="10/19/2017 18:00 UTC" latitude="18.0" longitude="129.9" wind_speed="138.89" wind_gusts="166.67" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="192100Z POSITION NEAR 18.4N 129.9E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 523 NM SOUTH-SOUTHEAST OF KADENA AB, HAS TRACKED NORTHWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 191800Z IS 32 FEET. NEXT WARNINGS AT 200300Z, 200900Z, 201500Z AND 202100Z. REFER TO TROPICAL DEPRESSION 27W (TWENTYSEVEN) WARNINGS (WTPN33 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="972">
        <wind_radii minimum_wind_speed="34.0" northeast="601.87" southeast="629.65" southwest="592.61" northwest="398.16"/>
        <wind_radii minimum_wind_speed="50.0" northeast="351.86" southeast="398.16" southwest="370.38" northwest="222.23"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-20T00:00:00Z" utc_time="10/20/2017 00:00 UTC" locale_time="10/20/2017 00:00 UTC" latitude="18.8" longitude="130.0" wind_speed="157.41" wind_gusts="194.45" category="Category 2 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="200300Z POSITION NEAR 19.2N 130.0E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 478 NM SOUTH-SOUTHEAST OF KADENA AB, HAS TRACKED NORTHWARD AT 08 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 200000Z IS 36 FEET. NEXT WARNINGS AT 200900Z, 201500Z, 202100Z AND 210300Z. REFER TO TROPICAL STORM 27W (TWENTYSEVEN) WARNINGS (WTPN33 PGTW) FOR SIX- HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="963">
        <wind_radii minimum_wind_speed="34.0" northeast="601.87" southeast="648.17" southwest="601.87" northwest="425.94"/>
        <wind_radii minimum_wind_speed="50.0" northeast="351.86" southeast="398.16" southwest="370.38" northwest="222.23"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-20T06:00:00Z" utc_time="10/20/2017 06:00 UTC" locale_time="10/20/2017 06:00 UTC" latitude="19.7" longitude="130.1" wind_speed="166.67" wind_gusts="203.71" category="Category 2 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="200900Z POSITION NEAR 20.1N 130.2E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 427 NM SOUTH-SOUTHEAST OF KADENA AB, OKINAWA, JAPAN, HAS TRACKED NORTHWARD AT 09 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 200600Z IS 36 FEET. NEXT WARNINGS AT 201500Z, 202100Z, 210300Z AND 210900Z. REFER TO TROPICAL STORM 27W (TWENTYSEVEN) WARNINGS (WTPN33 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="959">
        <wind_radii minimum_wind_speed="34.0" northeast="351.86" southeast="351.86" southwest="296.3" northwest="277.78"/>
        <wind_radii minimum_wind_speed="50.0" northeast="194.45" southeast="194.45" southwest="166.67" northwest="148.15"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-20T12:00:00Z" utc_time="10/20/2017 12:00 UTC" locale_time="10/20/2017 12:00 UTC" latitude="20.4" longitude="130.2" wind_speed="185.19" wind_gusts="231.49" category="Category 3 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="201500Z POSITION NEAR 20.9N 130.3E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 389 NM SOUTH-SOUTHEAST OF KADENA AB, OKINAWA, JAPAN, HAS TRACKED  AT 07 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 201200Z IS 36 FEET. NEXT WARNINGS AT 202100Z, 210300Z, 210900Z AND 211500Z. REFER TO TROPICAL DEPRESSION 27W (TWENTYSEVEN) WARNINGS (WTPN33 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="950">
        <wind_radii minimum_wind_speed="34.0" northeast="481.49" southeast="527.79" southwest="444.46" northwest="416.68"/>
        <wind_radii minimum_wind_speed="50.0" northeast="277.78" southeast="305.56" southwest="259.27" northwest="240.75"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-21T00:00:00Z" utc_time="10/21/2017 00:00 UTC" locale_time="10/21/2017 00:00 UTC" latitude="22.2" longitude="130.7" wind_speed="203.71" wind_gusts="250.01" category="Category 3 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="forecast" comments="*" NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="950">
        <wind_radii minimum_wind_speed="34.0" northeast="546.31" southeast="583.35" southwest="564.83" northwest="638.91"/>
        <wind_radii minimum_wind_speed="50.0" northeast="296.3" southeast="314.82" southwest="259.27" northwest="268.53"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-21T12:00:00Z" utc_time="10/21/2017 12:00 UTC" locale_time="10/21/2017 12:00 UTC" latitude="24.7" longitude="131.6" wind_speed="222.23" wind_gusts="268.53" category="Category 4 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="forecast" comments="*" NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="941">
        <wind_radii minimum_wind_speed="34.0" northeast="638.91" southeast="546.31" southwest="620.39" northwest="712.98"/>
        <wind_radii minimum_wind_speed="50.0" northeast="305.56" southeast="305.56" southwest="268.53" northwest="314.82"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-22T00:00:00Z" utc_time="10/22/2017 00:00 UTC" locale_time="10/22/2017 00:00 UTC" latitude="27.6" longitude="132.8" wind_speed="203.71" wind_gusts="250.01" category="Category 3 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="forecast" comments="*" NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="950">
        <wind_radii minimum_wind_speed="34.0" northeast="657.42" southeast="564.83" southwest="638.91" northwest="777.8"/>
        <wind_radii minimum_wind_speed="50.0" northeast="333.34" southeast="314.82" southwest="277.78" northwest="361.12"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-22T12:00:00Z" utc_time="10/22/2017 12:00 UTC" locale_time="10/22/2017 12:00 UTC" latitude="31.8" longitude="135.4" wind_speed="166.67" wind_gusts="203.71" category="Category 2 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="forecast" comments="*" NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="968">
        <wind_radii minimum_wind_speed="34.0" northeast="685.2" southeast="611.13" southwest="694.46" northwest="777.8"/>
        <wind_radii minimum_wind_speed="50.0" northeast="342.6" southeast="314.82" southwest="277.78" northwest="351.86"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-23T12:00:00Z" utc_time="10/23/2017 12:00 UTC" locale_time="10/23/2017 12:00 UTC" latitude="41.2" longitude="147.3" wind_speed="101.85" wind_gusts="129.63" category="Tropical Storm" storm_name="LAN" local_storm_name="Severe Tropical Storm LAN" type="forecast" comments="*" NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="999">
        <wind_radii minimum_wind_speed="34.0" northeast="694.46" southeast="888.91" southwest="666.68" northwest="500.01"/>
        <wind_radii minimum_wind_speed="50.0" northeast="287.04" southeast="277.78" southwest="324.08" northwest="231.49"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
</hurricane></report>

13.6 Notes

Location parameters are not needed to request the data.

14. Air Quality Observations

Air Quality Observations include observed data for the past 24 hours (maximum pollution levels) for both U.S. and Canadian locations, gathered by the EPA as part of the AirNow project.

14.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=air_quality_obs

14.2 Request Parameters

14.3 Response Object

Field	Description
gmt_date	The update time of the product in UTC time in HHMMDDYYYY format.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
station_id	The air quality station ID.
forecast_id	The nearest CustomWeather location ID.
air_station_name	The air quality station name.
state_code	The US state code.
concentration	The ozone level integer (see range below).
category	The air quality category character (see full description below).
iso8601	The date and time of the report in ISO 8601 format.

14.4 Example Request

xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=air_quality_obs&id=KCGX

14.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="2309282017" unix_date="1506641402.000000" timezone="-6" state="IL" state_name="Illinois" country="US" iso_cc="US" country_name="United States" localtime="Fri, 29 Sep 2017 10:06:30 CDT" localupdatetime="Thu, 28 Sep 2017 18:30:02 CDT" metric="false" city_name="Chicago / Meigs" longitude="-87.59" latitude="41.86" tzinfo="America/Chicago" elevation="175.00" name="air_quality_obs" >
<observation station_id="170314002" forecast_id="14751" air_station_name="CIRERO" state_code="IL" concentration="41" category="G" />
<observation station_id="170310032" forecast_id="K63G" air_station_name="CHI-SWFP" state_code="IL" concentration="41" category="G" />
<observation station_id="170317002" forecast_id="K62G" air_station_name="EVANSTON" state_code="IL" concentration="45" category="G" />
<observation station_id="180892008" forecast_id="16050" air_station_name="HAMMOND" state_code="IN" concentration="41" category="G" />
</report>

14.6 Notes

G == Good M == Moderate S == Unhealthy for Sensitive Groups U == Unhealthy V == Very Unhealthy H == Hazardous 0-50 == Good 51-100 == Moderate 101-150 == Unhealthy for Sensitive Groups 151-200 == Unhealthy 201-300 == Very Unhealthy >300 == Hazardous

15. Air Quality Forecasts

Air Quality Forecasts provide 5 days of recent and forecasted air pollution information for the U.S.

15.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=air_quality_for

15.2 Request Parameters

15.3 Response Object

Field	Description
gmt_date	The update time of the product in UTC time in HHMMDDYYYY format.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
station_id	The air quality station ID.
forecast_id	The nearest CustomWeather location ID.
air_station_name	The air quality station name.
state_code	The US state code.
concentration	The ozone level integer (see range below).
category	The air quality category character (see full description below).
iso8601	The date and time of the report in ISO 8601 format.

15.4 Example Request

xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=air_quality_for&id=KCGX

15.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="2309282017" unix_date="1506641402.000000" timezone="-6" state="IL" state_name="Illinois" country="US" iso_cc="US" country_name="United States" localtime="Fri, 29 Sep 2017 10:06:30 CDT" localupdatetime="Thu, 28 Sep 2017 18:30:02 CDT" metric="false" city_name="Chicago / Meigs" longitude="-87.59" latitude="41.86" tzinfo="America/Chicago" elevation="175.00" name="air_quality_obs" >
<observation station_id="170314002" forecast_id="14751" air_station_name="CIRERO" state_code="IL" concentration="41" category="G" />
<observation station_id="170310032" forecast_id="K63G" air_station_name="CHI-SWFP" state_code="IL" concentration="41" category="G" />
<observation station_id="170317002" forecast_id="K62G" air_station_name="EVANSTON" state_code="IL" concentration="45" category="G" />
<observation station_id="180892008" forecast_id="16050" air_station_name="HAMMOND" state_code="IN" concentration="41" category="G" />
</report>

15.6 Notes

G == Good M == Moderate S == Unhealthy for Sensitive Groups U == Unhealthy V == Very Unhealthy H == Hazardous 0-50 == Good 51-100 == Moderate 101-150 == Unhealthy for Sensitive Groups 151-200 == Unhealthy 201-300 == Very Unhealthy >300 == Hazardous

16. Airport Delay Forecasts

The airport delay forecasts returns the data for the nearest airports or just the nearest airport (one_airport_delay).

16.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=airport_delay

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=one_airport_delay

16.2 Request Parameters

16.3 Response Object

Field	Description
gmt_date	The update time of the product in UTC time in HHMMDDYYYY format.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
station_id	The air quality station ID.
forecast_id	The nearest CustomWeather location ID.
air_station_name	The air quality station name.
state_code	The US state code.
date_format	The format of the forecast date.
date	The forecast date.
pollutant	The primary air pollutant listed as "O" for Ozone or "P" for particulates smaller than 2.5 microns.
concentration	The ozone level integer (see range below).
category	The air quality category character (see full description below).
city	The location's ID code.
city_name	The location name.
location	The name of the forecast location.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the forecast location in meters or feet.
state	The state code of the forecast location.
state_name	The state name of the forecast location.
country	The country code of the forecast location.
iso_cc	The ISO country code of the forecast location.
country_name	The country name of the forecast location.
distance	The distance to the forecast location in kilometers or miles.
segment	The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_segment	The time segment of the day text.
day_of_week	The day of the week integer 1 = Sunday).
weekday	The day of the week name
delay_time	The delay time integer. Descriptor can be found in the delays attribute.
delay	The delay time descriptor.
primary_delay_reason	The primary reason integer.
primary_reason	The primary reason descriptor.
secondary_delay_reason	The secondary reason integer.
secondary_reason	The secondary reason descriptor.
icon_name	The weather icon name.
iso8601	The date and time of the forecast day in ISO 8601 format.

16.4 Example Request

xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=airport_delay&id=12156

16.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1610192017" unix_date="1508431203.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Thu, 19 Oct 2017 14:47:20 PDT" localupdatetime="Thu, 19 Oct 2017 09:40:03 PDT" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="airport_delay" >
<location city="KSFO" city_name="San Francisco" latitude="37.618805" longitude="-122.37542" location="San Francisco International Airport" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="17.28">
<forecast segment="A" day_segment="Afternoon" day_of_week="5" weekday="Thursday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-19T12:00:00.00-07:00" />
<forecast segment="E" day_segment="Evening" day_of_week="5" weekday="Thursday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-19T18:00:00.00-07:00" />
<forecast segment="N" day_segment="Night" day_of_week="5" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T00:00:00.00-07:00" />
<forecast segment="M" day_segment="Morning" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T06:00:00.00-07:00" />
<forecast segment="A" day_segment="Afternoon" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T12:00:00.00-07:00" />
<forecast segment="E" day_segment="Evening" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T18:00:00.00-07:00" />
<forecast segment="N" day_segment="Night" day_of_week="6" weekday="Saturday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-21T00:00:00.00-07:00" />
<forecast segment="M" day_segment="Morning" day_of_week="7" weekday="Saturday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-21T06:00:00.00-07:00" />
</location>
<location city="KOAK" city_name="Oakland" latitude="37.7213" longitude="-122.2207" location="Metro Oakland International Airport" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="18.36">
<forecast segment="A" day_segment="Afternoon" day_of_week="5" weekday="Thursday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-19T12:00:00.00-07:00" />
<forecast segment="E" day_segment="Evening" day_of_week="5" weekday="Thursday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-19T18:00:00.00-07:00" />
<forecast segment="N" day_segment="Night" day_of_week="5" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T00:00:00.00-07:00" />
<forecast segment="M" day_segment="Morning" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T06:00:00.00-07:00" />
<forecast segment="A" day_segment="Afternoon" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T12:00:00.00-07:00" />
<forecast segment="E" day_segment="Evening" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T18:00:00.00-07:00" />
<forecast segment="N" day_segment="Night" day_of_week="6" weekday="Saturday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-21T00:00:00.00-07:00" />
<forecast segment="M" day_segment="Morning" day_of_week="7" weekday="Saturday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-21T06:00:00.00-07:00" />
</location>

17. Detailed Forecast Advisories

The product returns advisories based on the forecast for the next six or 24 hours or five days broken down into segments of the day (Morning, Afternoon, Evening, Overnight).

17.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_cw_advisories_6hr

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_cw_advisories

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_cw_advisories_ext

17.2 Request Parameters

17.3 Response Object

Field	Description
gmt_date	The update time of the product in UTC time in HHMMDDYYYY format.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
location	The name of the reporting station.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the reporting station in meters or feet.
distance	The distance to the forecast location in kilometers or miles.
type	The alert type integer.
description	The alert description.
segment	The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_of_week	The day of the week integer 1 = Sunday).
applicable_from	Date and time of the start of the advisory in ISO 8601 format.
applicable_to	Date and time of the end of the advisory in ISO 8601 format.
occurrence	Likelyhood of advisory occurring (Low, Medium, High).
impact	Impact of the advisory (Low, Medium, High).
iso8601	The date and time of the report in ISO 8601 format.

17.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=detailed_cw_advisories&id=12156

17.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<cw_multi_report>
<report gmt_date="1810202017" unix_date="1508523610.000000" timezone="-6" state="AR" state_name="Arkansas" country="US" iso_cc="US" country_name="United States" localtime="Fri, 20 Oct 2017 13:54:11 CDT" localupdatetime="Fri, 20 Oct 2017 13:20:10 CDT" metric="true" city_name="Bearden" longitude="-92.61" latitude="33.72" tzinfo="America/Chicago" elevation="70.00" name="detailed_cw_advisories" >
<location city="10997" city_name="Bearden" latitude="33.72" longitude="-92.61" location="Bearden" state="AR" state_name="Arkansas" country="US" iso_cc="US" country_name="United States" distance="0.00">
<cw_advisory type="1" description="Strong thunderstorms anticipated" >
<time_segment segment="N" day_of_week="7"  />
<time_segment segment="M" day_of_week="1"  />
</cw_advisory>

</location>
</report>

17.6 Notes

The product will only return data if an advisory is available for the location when requesting by id or coordinates.

18. Extended Forecast Advisories

The product returns advisories based on the forecast for the next six or 24 hours or 5 days.

18.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=cw_advisories_6hr

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=cw_advisories

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=cw_advisories_ext

18.2 Request Parameters

18.3 Response Object

Field	Description
gmt_date	The update time of the product in UTC time in HHMMDDYYYY format.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	The location's ID code.
location	The name of the reporting station.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
elevation	The elevation of the reporting station in meters or feet.
distance	The distance to the forecast location in kilometers or miles.
type	The alert type integer.
description	The alert description.
category	The alert category
applicable_from	Date and time of the start of the advisory in ISO 8601 format.
applicable_to	Date and time of the end of the advisory in ISO 8601 format.
occurrence	Likelyhood of advisory occurring (Low, Medium, High).
impact	Impact of the advisory (Low, Medium, High).
iso8601	The date and time of the report in ISO 8601 format.

18.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=cw_advisories&id=12156&format=json

18.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1812102018" unix_date="1544466013.000000" timezone="1" state="23" state_name="V�sterbotten" country="SW" iso_cc="SE" country_name="Sweden" localtime="Mon, 10 Dec 2018 21:36:13 CET" localupdatetime="Mon, 10 Dec 2018 19:20:13 CET" metric="true" city_name="Skelleftea" longitude="20.95" latitude="64.75" tzinfo="Europe/Stockholm" elevation="5.00" name="cw_advisories" >
<location city="75562" city_name="Skelleftea" latitude="64.75" longitude="20.95" location="Skelleftea" state="23" state_name="V�sterbotten" country="SW" iso_cc="SE" country_name="Sweden" distance="0.00">
<cw_advisory type="13" description="Snow advisory" category="Snow and Ice" applicable_from="2018-12-10T19:00:00.00+01:00" applicable_to="2018-12-11T19:00:00.00+01:00" occurrence="Likely" impact="Medium" />

</location>
</report>

18.6 Notes

The product will only return data if an advisory is available for the location when requesting by id or coordinates.

19. US and Canadian Weather Alerts

The product returns National Weather Service and Canadian Weather Service weather alerts (nws_alerts will only return NWS alerts).

19.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=intl_alerts

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=nws_alerts

19.2 Request Parameters

19.3 Response Object

Field	Description
gmt_date	The update time of the product in UTC time in HHMMDDYYYY format.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
metric	Metric units indicator (true or false).
name	The name of the weather product being requested.
message_id	The unique reference id as an alphanumeric string.
description	The text description of the alert.
type	The alert type integer.
nws_office	Issuing NWS office.
source	Source of alert.
severity	Severity of alerts (0-100 where 0 is the most severe).
issue_time_local	The issue date and time of the alert in %m/%d/%Y %H:%M format in local time.
issue_time_utc	The issue date and time of the alert in %m/%d/%Y %H:%M format in UTC time.
broadcast_time_local	The broadcast date and time of the alert in %m/%d/%Y %H:%M format in local time.
broadcast_time_utc	The broadcast date and time of the alert in %m/%d/%Y %H:%M format in UTC time.
valid_until_time_local	The valid until date and time of the alert in %m/%d/%Y %H:%M format in local time.
valid_until_time_utc	The valid until date and time of the alert in %m/%d/%Y %H:%M format in UTC time.
parent_id	The parent reference id as an alphanumeric string.
name	The name of the weather product being requested.
state_name	The state name of the requested location.
country_name	The country name.
latitude	Latitude Coordinates in Decimal Degrees
longitude	Longitude Coordinates in Decimal Degrees
message	The alert text.
latitude (county_id, zone_id or location_id attribute)	Central latitude coordinates in decimal degrees of the county.
longitude (county_id, zone_id or location_id attribute)	Central longitude coordinates in decimal degrees of the county.
name (county_id, zone_id or location_id attribute)	The county name.
country (county_id, zone_id or location_id attribute)	The country code.
country_name (county_id, zone_id or location_id attribute)	The country name.
state (county_id, zone_id or location_id attribute)	The state or province code.
state_name (county_id, zone_id or location_id attribute)	The state or province name.
county_id	The NWS county ID.
zone_id	The NWS zone ID.
location_id	The Canadian Weather office province ID.
smpp_message	Not in use (defunct).
polygon	The coordinates of the polygon of the warned area.
effective_time_local	The effective date and time of the alert in %m/%d/%Y %H:%M format in local time.
effective_time_utc	The effective date and time of the alert in %m/%d/%Y %H:%M format in UTC time.

19.4 Example Request

http://xml.customweather.com/xml/v2?client=client=sampleuser&client_password=samplepassword&product=intl_alerts

19.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1610232017" unix_date="1508774919.000000" metric="true" name="nws_alert" >


<watch message_id="190742PMZ1531000" description="Small Craft Advisory" type="1000" nws_office="NWS Field Office" source="9" severity="70" issue_time_local="10/19/2017 17:42 ChST" issue_time_utc="10/19/2017 07:42 UTC" broadcast_time_local="10/19/2017 17:42 ChST" broadcast_time_utc="10/19/2017 07:42 UTC" valid_until_time_local="10/24/2017 18:00 ChST" valid_until_time_utc="10/24/2017 08:00 UTC" parent_id="181902PMZ1531000" name="Rota Island  N. Mariana Is  Rota International Airport" state_name="Guam" country_name="United States" latitude="14.43" longitude="145.44" >
<message>This alert has expired</message>
<zone_id latitude="14.86054" longitude="145.59991" name="Tinian Coastal Waters" country="US" country_name="United States" state="*" state_name="*">PMZ153</zone_id>
<zone_id latitude="15.32804" longitude="145.78462" name="Saipan Coastal Waters" country="US" country_name="United States" state="*" state_name="*">PMZ154</zone_id>
<zone_id latitude="13.37584" longitude="144.77906" name="Guam Coastal Waters" country="US" country_name="United States" state="*" state_name="*">PMZ151</zone_id>
<zone_id latitude="14.14431" longitude="145.59041" name="Rota Coastal Waters" country="US" country_name="United States" state="*" state_name="*">PMZ152</zone_id>
<smpp_message>Small Craft Advisory;till:10/24 18:00 ChST; This alert has expired</smpp_message></watch>

19.6 Notes

Using a location parameter will return alerts for the location only if it's available.

20. Daily Historical Climate

The product returns daily historical climate for any one year range based on availability. Access is available via Paid Subscription only. For more information please contact sales@customweather.com.

20.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=

20.2 Request Parameters

20.3 Response Object

Field	Description
gmt_date	The update time of the product in UTC time in HHMMDDYYYY format.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
icao	The ICAO ID of the nearest reporting station.
date	The date of the data in YYYY-MM-DD format.
tmax	The maximum temperature in Celsius or Fahrenheit.
tmin	The minumum temperature in Celsius or Fahrenheit.
tmean	The average temperature in Celsius or Fahrenheit.
hdd	The heating degree days in Celsius or Fahrenheit.
cdd	The cooling degree days in Celsius or Fahrenheit.
precip	The precipitation in millimeters or inches
rh	The relative humidity as a percentage.
windspd	The windspeed in kilometer per hour or miles per hour.
visibility	The visibility in kilometers or miles.
slp	The sea level pressure in millibars or inches of mercury.
iso8601	The date and time of the report in ISO 8601 format.

20.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=&id=12156&start_time=2016-05-22T00:00:00&end_time=2016-05-26T00:00:00

20.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1710232017" unix_date="1508779722.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Mon, 23 Oct 2017 10:28:42 PDT" localupdatetime="Mon, 23 Oct 2017 10:28:42 PDT" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="" >
<location city="KSFO" city_name="San Francisco" latitude="37.618805" longitude="-122.37542" location="San Francisco International Airport" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="17.28">
<observation icao="KSFO" date="2016-05-22" tmax="18.33" tmin="12.78" tmean="15.56" hdd="2.78" cdd="0.00" precip="0.00" rh="64.73" windspd="18.83" dewpoint="8.89" visibility="16.09" slp="1018.66" />

<observation icao="KSFO" date="2016-05-23" tmax="18.89" tmin="12.22" tmean="15.56" hdd="2.78" cdd="0.00" precip="0.00" rh="64.73" windspd="22.69" dewpoint="8.89" visibility="16.09" slp="1014.26" />

<observation icao="KSFO" date="2016-05-24" tmax="18.33" tmin="13.33" tmean="15.83" hdd="2.50" cdd="0.00" precip="0.00" rh="67.29" windspd="23.98" dewpoint="10.00" visibility="16.09" slp="1015.61" />

<observation icao="KSFO" date="2016-05-25" tmax="18.33" tmin="13.33" tmean="15.83" hdd="2.50" cdd="0.00" precip="0.00" rh="64.85" windspd="21.72" dewpoint="9.44" visibility="16.09" slp="1019.68" />

<observation icao="KSFO" date="2016-05-26" tmax="21.11" tmin="12.78" tmean="16.94" hdd="1.39" cdd="0.00" precip="0.00" rh="65.07" windspd="13.20" dewpoint="10.56" visibility="16.09" slp="1017.98" />

</location>
</report>

20.6 Notes

Most historical daily data is available back to 1970.

21. Hourly Historical Climate

The product returns hourly historical climate for up to one year from the current date based on availability. Access is available via Paid Subscription only. For more information please contact sales@customweather.com.

21.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=

21.2 Request Parameters

21.3 Response Object

Field	Description
gid	The database field.
utc_time	The UTC time of the location in %a, %d %b %Y %I:%M:%S %Z format.
local_time	The local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
city	The location's ID code.
city_name	The location name.
location	The name of the reporting station.
state	The state code of the requested location.
state_name	The state name of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
longitude	The longitude coordinates in decimal degrees of the requested location.
daylight	Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
sky_desc	The sky descriptor integer.
precip_desc	The precipitation descriptor integer.
temp_desc	The temperature descriptor integer.
air_desc	The air descriptor integer.
temperature	The temperature in Celsius or Fahrenheit.
wind_speed	The wind speed in kilometers per mile or miles per hour.
wind_dir	The wind direction in compass degrees.
wind_short	The cardinal and intercardinal wind direction initials.
humidity	The humidity in percentage.
dew_point	The dew point temperature in Celsius or Fahrenheit.
comfort	The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
baro_pressure	The barometric pressure in millibars or inches of Mercury.
baro_tendency	The barometric pressure tendency initials.
barometer	The barometric pressure tendency text.
visibility	The visibility in kilometers or miles.
sky_conditions	The sky conditions for the hour (C-lear,F-ew,S-cattered,B-roken,O-vercast, X-obscured).
min_cloud_base	The minimum cloud base in meters or feet.
max_cloud_base	The maximum cloud base in meters or feet.
weather_type	The weather type for the hour (+FC = tornado/waterspout, FC = funnel cloud, TS = thunderstorm, GR = hail, RA = rain, DZ = drizzle, SN = snow, SG = snow grains, GS = small hail &/or snow pellets, PE = ice pellets, IC = crystals, FG+ = heavy fog less than 0.25 miles vis, FG = fog, BR = mist, UP = unknown precip., HZ = haze, FU = smoke, VA = volcanic ash, DU = widespread dust, DS = duststorm, PO = sand/dust whirls, SA = sand, SS = sandstorm, PY = spray, SQ = squall) (DR - low drifting, SH - shower, FZ - freezing, MI - shallow, PR - partial, BC - patches, BL - blowing, VC - vicinity, - LIGHT, + HEAVY, 'NO SIGN' - moderate)| (24) hourly precip. [optional] (Floating Point - inches)|
hourly_precip_1hr	The hourly precipitation in millimeters or inches.
hourly_precip_3hr	The 3-hour precipitation in millimeters or inches.
hourly_precip_6hr	The 6-hour precipitation in millimeters or inches.
hourly_precip_12hr	The 12-hour precipitation in millimeters or inches.
hourly_precip_24hr	The 24-hour precipitation in millimeters or inches.
max_temp_24hr	The 24-hr maximum temperature in Celsius or Fahrenheit.
max_temp_6hr	The 6-hr maximum temperature in Celsius or Fahrenheit.
min_temp_24hr	The 24-hr minimum temperature in Celsius or Fahrenheit.
min_temp_6hr	The 6-hr minimum temperature in Celsius or Fahrenheit.
snow_cover	The snow cover in centimeters or inches.
solar_radiation	The solar radiation in minutes.
iso8601	The date and time of the report in ISO 8601 format.

21.4 Example Request

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=&id=KSFO&start_time=2016-12-27T07:00:00.00&end_time=2016-12-28T08:00:00.00

21.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="2110232017" unix_date="1508793569.000000"><observation gid="9946897931" utc_time="2016-12-27T07:56:00.00+00:00" local_time="2016-12-26T23:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="5.61" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="68" dewpoint="*" comfort="5.61" baro_pressure="1028.20" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="11.72" max_temp_6hr="*" min_temp_24hr="5.00" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9946947632" utc_time="2016-12-27T08:56:00.00+00:00" local_time="2016-12-27T00:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="6.11" wind_speed="11.12" wind_direction="150" wind_gusts="*" humidity="62" dewpoint="-0.61" comfort="3.76" baro_pressure="1027.40" baro_tendency="F" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9946997977" utc_time="2016-12-27T09:56:00.00+00:00" local_time="2016-12-27T01:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="6.72" wind_speed="9.27" wind_direction="10" wind_gusts="*" humidity="51" dewpoint="-2.78" comfort="4.87" baro_pressure="1027.70" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947048543" utc_time="2016-12-27T10:56:00.00+00:00" local_time="2016-12-27T02:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="6" air_desc="*" temperature="8.28" wind_speed="9.27" wind_direction="30" wind_gusts="*" humidity="54" dewpoint="-0.61" comfort="6.72" baro_pressure="1028.10" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947098670" utc_time="2016-12-27T11:56:00.00+00:00" local_time="2016-12-27T03:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="5.00" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="60" dewpoint="-2.22" comfort="5.00" baro_pressure="1027.70" baro_tendency="R" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="8.28" min_temp_24hr="*" min_temp_6hr="4.39" snow_cover="*" solar_radiation="*" />
<observation gid="9947150630" utc_time="2016-12-27T12:56:00.00+00:00" local_time="2016-12-27T04:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="4" air_desc="*" temperature="4.39" wind_speed="7.41" wind_direction="160" wind_gusts="*" humidity="70" dewpoint="-0.61" comfort="2.58" baro_pressure="1027.20" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947203191" utc_time="2016-12-27T13:56:00.00+00:00" local_time="2016-12-27T05:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="5.00" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="65" dewpoint="-1.11" comfort="5.00" baro_pressure="1027.00" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947255335" utc_time="2016-12-27T14:56:00.00+00:00" local_time="2016-12-27T06:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="4" air_desc="*" temperature="3.89" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="76" dewpoint="*" comfort="3.89" baro_pressure="1027.80" baro_tendency="S" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947307928" utc_time="2016-12-27T15:56:00.00+00:00" local_time="2016-12-27T07:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="7.22" wind_speed="11.12" wind_direction="330" wind_gusts="*" humidity="74" dewpoint="2.78" comfort="5.10" baro_pressure="1028.20" baro_tendency="*" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947360798" utc_time="2016-12-27T16:56:00.00+00:00" local_time="2016-12-27T08:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="7.22" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="71" dewpoint="2.22" comfort="7.22" baro_pressure="1028.10" baro_tendency="*" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947413281" utc_time="2016-12-27T17:56:00.00+00:00" local_time="2016-12-27T09:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="9.39" wind_speed="5.56" wind_direction="80" wind_gusts="*" humidity="59" dewpoint="1.72" comfort="8.89" baro_pressure="1028.40" baro_tendency="R" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="9.39" min_temp_24hr="*" min_temp_6hr="3.89" snow_cover="*" solar_radiation="*" />
<observation gid="9947465938" utc_time="2016-12-27T18:56:00.00+00:00" local_time="2016-12-27T10:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="10.00" wind_speed="5.56" wind_direction="60" wind_gusts="*" humidity="52" dewpoint="0.61" comfort="9.59" baro_pressure="1028.30" baro_tendency="*" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947518249" utc_time="2016-12-27T19:56:00.00+00:00" local_time="2016-12-27T11:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="10.00" wind_speed="12.97" wind_direction="0" wind_gusts="*" humidity="57" dewpoint="1.72" comfort="8.18" baro_pressure="1028.20" baro_tendency="*" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947568707" utc_time="2016-12-27T20:56:00.00+00:00" local_time="2016-12-27T12:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="10.61" wind_speed="11.12" wind_direction="140" wind_gusts="*" humidity="48" dewpoint="*" comfort="9.18" baro_pressure="1026.40" baro_tendency="F" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947619290" utc_time="2016-12-27T21:56:00.00+00:00" local_time="2016-12-27T13:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="14" precip_desc="*" temp_desc="6" air_desc="*" temperature="11.11" wind_speed="7.41" wind_direction="0" wind_gusts="*" humidity="49" dewpoint="0.61" comfort="10.43" baro_pressure="1026.30" baro_tendency="*" visibility="16.09" sky_conditions="B" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947669969" utc_time="2016-12-27T22:56:00.00+00:00" local_time="2016-12-27T14:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="14" precip_desc="*" temp_desc="6" air_desc="*" temperature="11.11" wind_speed="5.56" wind_direction="10" wind_gusts="*" humidity="61" dewpoint="3.89" comfort="10.86" baro_pressure="1026.20" baro_tendency="*" visibility="16.09" sky_conditions="B" min_cloud_base="5486.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947719828" utc_time="2016-12-27T23:56:00.00+00:00" local_time="2016-12-27T15:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="14" precip_desc="*" temp_desc="6" air_desc="*" temperature="11.72" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="59" dewpoint="3.89" comfort="11.72" baro_pressure="1026.00" baro_tendency="F" visibility="16.09" sky_conditions="B" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="11.72" min_temp_24hr="*" min_temp_6hr="8.89" snow_cover="*" solar_radiation="*" />
<observation gid="9947770166" utc_time="2016-12-28T00:56:00.00+00:00" local_time="2016-12-27T16:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="14" precip_desc="*" temp_desc="6" air_desc="*" temperature="11.72" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="48" dewpoint="1.11" comfort="11.72" baro_pressure="1026.00" baro_tendency="*" visibility="16.09" sky_conditions="B" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947820373" utc_time="2016-12-28T01:56:00.00+00:00" local_time="2016-12-27T17:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="11.11" wind_speed="5.56" wind_direction="200" wind_gusts="*" humidity="47" dewpoint="*" comfort="10.86" baro_pressure="1025.90" baro_tendency="*" visibility="16.09" sky_conditions="S" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947869175" utc_time="2016-12-28T02:56:00.00+00:00" local_time="2016-12-27T18:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="9.39" wind_speed="5.56" wind_direction="160" wind_gusts="*" humidity="57" dewpoint="1.11" comfort="8.89" baro_pressure="1026.00" baro_tendency="S" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947918960" utc_time="2016-12-28T03:56:00.00+00:00" local_time="2016-12-27T19:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="6" air_desc="*" temperature="10.61" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="42" dewpoint="-1.72" comfort="10.61" baro_pressure="1026.00" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947969038" utc_time="2016-12-28T04:56:00.00+00:00" local_time="2016-12-27T20:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="6" air_desc="*" temperature="10.00" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="50" dewpoint="*" comfort="10.00" baro_pressure="1026.50" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9948018699" utc_time="2016-12-28T05:56:00.00+00:00" local_time="2016-12-27T21:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="6" air_desc="*" temperature="8.28" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="59" dewpoint="0.61" comfort="8.28" baro_pressure="1026.70" baro_tendency="R" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="11.72" min_temp_24hr="*" min_temp_6hr="7.22" snow_cover="*" solar_radiation="*" />
<observation gid="9948069593" utc_time="2016-12-28T06:56:00.00+00:00" local_time="2016-12-27T22:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="6" air_desc="*" temperature="7.78" wind_speed="5.56" wind_direction="180" wind_gusts="*" humidity="61" dewpoint="0.61" comfort="7.05" baro_pressure="1027.10" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9948120854" utc_time="2016-12-28T07:56:00.00+00:00" local_time="2016-12-27T23:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="6.11" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="71" dewpoint="1.11" comfort="6.11" baro_pressure="1026.90" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="11.72" max_temp_6hr="*" min_temp_24hr="3.89" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
</report>

21.6 Notes

Many variables such as the 3-hour precipation and solar radiation are optional. Most historical houlry data is available back to 1970.

22. Ski Reports

The product returns ski report data for all the resorts in the location's US state or country for resorts outside of the US. The ski_search product will return the data only for the specified resort. More information is provided in the Notes seciton.

22.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=ski_reports&id=12156

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=ski_search&id=909002

22.2 Request Parameters

22.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
sno_country_id	The ski resort ID.
ski_area_name	The ski resort name.
state	The state name of the resort.
new_snow_min24	The minimum new snow in the last 24 hours in centimeters or inches.
new_snow_max24	The maximum new snow in the last 24 hours in centimeters or inches.
primary_surface	The primary surface conditions. CORN CORN SNOW FRGR FROZEN GRANULAR HP HARD PACKED ICY ICY LSGR LOOSE GRANULAR MGS MACHINE GROOMED SNOW PDR POWDER PP PACKED POWDER SC SPRING CONDITIONS (after Mar 1) VC VARIABLE CONDITIONS WBLN WIND BLOWN WETGR WET GRANULAR WETPS WET PACKED SNOW WETSN WET SNOW
base_depth_min	The minimum base depth in centimeters or inches.
base_depth_max	The maximum base depth in centimeters or inches.
base_min	The minimum base depth in centimeters or inches.
base_max	The maximum base depth in centimeters or inches.
num_lifts_open	The number of open lifts.
num_trails_open	The number of open trails.
snow_making	Snow making. Y or N.
night_skiing	Night skiing. Y or N.
grooming	Grooming. Y or N.
num_miles_open	The number of open skiiable miles.
num_acres_open	The number of open skiable acres.
percent_runs_open	The percent of open runs.
cross_country	Cross country. Y or N.
snow_boarding	Snowboarding. Y or N.
operation_hours	The hours of operation.
operation_status	The operation status.
projected_operations	The projected operation status.
snow_comments24	The comments on the snowfall.
general_comments	The general comments from the ski resort.
state_code	The state code of the resort
country_code	The country code of the resort.
iso8601	The date and time of the report in ISO 8601 format.
resort_status	Status of the ski resort (open, closed, etc.).
total_lifts	The total number of lifts at the resort.
total_trails	The total number of trails at the resort.
seasonal_snowfall	The total natural snowfall season total in centimeters or inches.
last_snowfall_date	Date of last snowfall.
last_snowfall_amount	Amount of last snowfall in centimeters or inches.
previous_snowfall_date	Date of previous snowfall.
previous_snowfall_amount	Amount of previous snowfall in centimeters or inches.

22.4 Example Request

http://xml.customweather.com/xml/v2?client=client=sampleuser&client_password=samplepassword&product=ski_reports&id=12156

http://xml.customweather.com/xml/v2?client=client=sampleuser&client_password=samplepassword&product=ski_search&id=909002

22.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1510242017" unix_date="1508858409.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Tue, 24 Oct 2017 10:49:37 PDT" localupdatetime="Tue, 24 Oct 2017 08:20:09 PDT" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="ski_report" >

<observation sno_country_id="303001" ski_area_name="Arapahoe Basin" state="CO" new_snow_min24="*" new_snow_max24="*" primary_surface="PP" base_depth_min="46 cm" base_depth_max="46 cm" base_min="46" base_max="46" num_lifts_open="1" num_trails_open="2" snow_making="*" night_skiing="*" grooming="*" num_miles_open="*" num_acres_open="46.0" percent_runs_open="2.0" cross_country="*" snow_boarding="*" operation_hours="Mon-Fri: 9am-4pm; Sat/Sun: 8:30am-4pm" operation_status="*" projected_operations="*" snow_comments24="2&quot;  past 72 hours" general_comments="*" state_code="CO" country_code="US" />
</report>

22.6 Notes

The ski_search product requires the ID of the resort, and a list of the IDs can be provided.

23. Earthquakes

The earthquakes product returns a summary of all of the earthquakes from around the world for up to the past 7 days.

23.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=earthquake

23.2 Request Parameters

23.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
name	The name of the weather product being requested.
city	Location of the event.
occurrence	Date and time of the the event in %a %b %d %H:%M:%S %Z %Y format in UTC time.
latitude	The latitude coordinates of the event.
longitude	The longitude coordinates of the event.
magnitude	The magnitude of the event.
depth	The depth of the event in kilometers.
comments	The comments from the USGS.
iso8601	The date and time of the report in ISO 8601 format.

23.4 Example Request

http://xml.customweather.com/xml/v2?client=client=sampleuser&client_password=samplepassword&product=earthquake

http://xml.customweather.com/xml/v2?client=client=sampleuser&client_password=samplepassword&product=earthquake&earthquake.magnitude=5.0&earthquake.age=3

23.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
 <report gmt_date="2210242017" unix_date="1508885102.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Tue, 24 Oct 2017 15:55:01 PDT" localupdatetime="Tue, 24 Oct 2017 15:45:02 PDT" metric="true" total_results="201" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="earthquake" >
 
 <observation city="18Km N Of Pahala, Hawaii" occurrence="Tue Oct 24 22:23:30 UTC 2017" latitude="19.37" longitude="-155.50" magnitude="2.5" depth="6.9" comments="18Km N Of Pahala, Hawaii" />
 
 <observation city="27Km Wnw Of Amatignak Island, Alaska" occurrence="Tue Oct 24 20:49:18 UTC 2017" latitude="51.36" longitude="-179.48" magnitude="3.6" depth="40.6" comments="27Km Wnw Of Amatignak Island, Alaska" />
 
 <observation city="59Km E Of Amatignak Island, Alaska" occurrence="Tue Oct 24 20:44:56 UTC 2017" latitude="51.23" longitude="-178.25" magnitude="3.7" depth="32.4" comments="59Km E Of Amatignak Island, Alaska" />
 
 <observation city="26Km E Of Honaunau-Napoopoo, Hawaii" occurrence="Tue Oct 24 18:54:15 UTC 2017" latitude="19.41" longitude="-155.62" magnitude="2.6" depth="2.5" comments="26Km E Of Honaunau-Napoopoo, Hawaii" />
 
 <observation city="66Km W Of Larsen Bay, Alaska" occurrence="Tue Oct 24 18:17:54 UTC 2017" latitude="57.64" longitude="-155.07" magnitude="2.5" depth="80.0" comments="66Km W Of Larsen Bay, Alaska" />
 
 <observation city="124Km Sse Of Akutan, Alaska" occurrence="Tue Oct 24 17:44:35 UTC 2017" latitude="53.07" longitude="-165.18" magnitude="3.0" depth="28.4" comments="124Km Sse Of Akutan, Alaska" />
 </report>

23.6 Notes

Location parameters are not needed to request the data.

24. Tide Data

The tide data product returns tide data for the next 3 days or 30 days.

24.1 URL Description

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=tide_forecast

http://xml.customweather.com/xml/v2?client=sampleuser&client_password=samplepassword&product=tide_forecast_30day

24.2 Request Parameters

24.3 Response Object

Field	Description
gmt_date	The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date	The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone	Time zone offset from UTC of the location.
state	The state code of the requested location.
state_name	The state name of the requested location.
country	The country code.
iso_cc	The ISO country code.
country_name	The country name.
local_time	The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime	The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric	Metric units indicator (true or false).
city_name	The location name.
longitude	The longitude coordinates in decimal degrees of the requested location.
latitude	The latitude coordinates in decimal degrees of the requested location.
tzinfo	IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation	The elevation of the location in meters or feet.
city	Location of the event.
tide_id	The ID of the tide location.
tide_name	The name of the tide location.
latitude	The latitude coordinates in decimal degrees of the tide location.
longitude	The longitude coordinates in decimal degrees of the tide location.
date	The date of the tides in MM/DD/YY (timezone) format.
sunrise	The tide location's time of sunrise in h:mm%z format.
sunset	The tide location's time of sunset in h:mm%z format.
timezone	The timezone abbreviation.
iso8601	The date and time of the forecast day in ISO 8601 format.
time	The time of the tide in h:mm%z format.
type	The type of tide (HIGH or LOW).
height	The the height of the tide in feet or meters.

24.4 Example Request

http://xml.customweather.com/xml/v2?client=client=sampleuser&client_password=samplepassword&product=tide_forecast

http://xml.customweather.com/xml/v2?client=client=sampleuser&client_password=samplepassword&product=tide_forecast_30day&id=12156

24.5 Example Response(XML)

"<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="0803062019" unix_date="1551860927.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 06 Mar 2019 14:27:17 PST" localupdatetime="Wed, 06 Mar 2019 00:28:47 PST" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="tide_forecast" >
<location tide_id="T10129" tide_name="Potrero Point, San Francisco Bay">
<forecast tide_id="T10129" tide_name="Potrero Point, San Francisco Bay" latitude="37.7667" longitude="-122.3833" date="03/06/19 (PST)" sunrise="06:34 AM" sunset="06:07 PM" time_zone="PST" iso8601="2019-03-06T08:00:00.00+00:00" >
<tide time="12:27 AM" type="HIGH" height="1.7" />
<tide time="11:47 AM" type="HIGH" height="1.9" />
<tide time="05:58 AM" type="LOW" height="0.6" />
<tide time="06:17 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10129" tide_name="Potrero Point, San Francisco Bay" latitude="37.7667" longitude="-122.3833" date="03/07/19 (PST)" sunrise="06:32 AM" sunset="06:08 PM" time_zone="PST" iso8601="2019-03-07T08:00:00.00+00:00" >
<tide time="12:50 AM" type="HIGH" height="1.7" />
<tide time="12:25 PM" type="HIGH" height="1.8" />
<tide time="06:30 AM" type="LOW" height="0.5" />
<tide time="06:46 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10129" tide_name="Potrero Point, San Francisco Bay" latitude="37.7667" longitude="-122.3833" date="03/08/19 (PST)" sunrise="06:31 AM" sunset="06:09 PM" time_zone="PST" iso8601="2019-03-08T08:00:00.00+00:00" >
<tide time="01:14 AM" type="HIGH" height="1.7" />
<tide time="01:03 PM" type="HIGH" height="1.7" />
<tide time="07:04 AM" type="LOW" height="0.5" />
<tide time="07:15 PM" type="LOW" height="0.2" />
</forecast>

</location>
<location tide_id="T10128" tide_name="Potrero Point">
<forecast tide_id="T10128" tide_name="Potrero Point" latitude="37.7667" longitude="-122.3833" date="03/06/19 (PST)" sunrise="06:34 AM" sunset="06:07 PM" time_zone="PST" iso8601="2019-03-06T08:00:00.00+00:00" >
<tide time="12:27 AM" type="HIGH" height="1.7" />
<tide time="11:47 AM" type="HIGH" height="1.9" />
<tide time="05:58 AM" type="LOW" height="0.6" />
<tide time="06:17 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10128" tide_name="Potrero Point" latitude="37.7667" longitude="-122.3833" date="03/07/19 (PST)" sunrise="06:32 AM" sunset="06:08 PM" time_zone="PST" iso8601="2019-03-07T08:00:00.00+00:00" >
<tide time="12:51 AM" type="HIGH" height="1.7" />
<tide time="12:24 PM" type="HIGH" height="1.8" />
<tide time="06:30 AM" type="LOW" height="0.5" />
<tide time="06:46 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10128" tide_name="Potrero Point" latitude="37.7667" longitude="-122.3833" date="03/08/19 (PST)" sunrise="06:31 AM" sunset="06:09 PM" time_zone="PST" iso8601="2019-03-08T08:00:00.00+00:00" >
<tide time="01:14 AM" type="HIGH" height="1.7" />
<tide time="01:03 PM" type="HIGH" height="1.7" />
<tide time="07:04 AM" type="LOW" height="0.5" />
<tide time="07:15 PM" type="LOW" height="0.2" />
</forecast>

</location>
<location tide_id="T10319" tide_name="Rincon Point, Pier 22 1/2, San Francisco">
<forecast tide_id="T10319" tide_name="Rincon Point, Pier 22 1/2, San Francisco" latitude="37.7833" longitude="-122.3833" date="03/06/19 (PST)" sunrise="06:34 AM" sunset="06:07 PM" time_zone="PST" iso8601="2019-03-06T08:00:00.00+00:00" >
<tide time="12:17 AM" type="HIGH" height="1.7" />
<tide time="11:37 AM" type="HIGH" height="1.8" />
<tide time="05:37 AM" type="LOW" height="0.6" />
<tide time="05:56 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10319" tide_name="Rincon Point, Pier 22 1/2, San Francisco" latitude="37.7833" longitude="-122.3833" date="03/07/19 (PST)" sunrise="06:32 AM" sunset="06:08 PM" time_zone="PST" iso8601="2019-03-07T08:00:00.00+00:00" >
<tide time="12:41 AM" type="HIGH" height="1.7" />
<tide time="12:14 PM" type="HIGH" height="1.8" />
<tide time="06:09 AM" type="LOW" height="0.5" />
<tide time="06:25 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10319" tide_name="Rincon Point, Pier 22 1/2, San Francisco" latitude="37.7833" longitude="-122.3833" date="03/08/19 (PST)" sunrise="06:31 AM" sunset="06:09 PM" time_zone="PST" iso8601="2019-03-08T08:00:00.00+00:00" >
<tide time="01:04 AM" type="HIGH" height="1.7" />
<tide time="12:53 PM" type="HIGH" height="1.7" />
<tide time="06:43 AM" type="LOW" height="0.5" />
<tide time="06:54 PM" type="LOW" height="0.2" />
</forecast>

</location>
<location tide_id="T2062" tide_name="San Francisco, Pier 22 1/2">
<forecast tide_id="T2062" tide_name="San Francisco, Pier 22 1/2" latitude="37.79" longitude="-122.3867" date="03/06/19 (PST)" sunrise="06:34 AM" sunset="06:07 PM" time_zone="PST" iso8601="2019-03-06T08:00:00.00+00:00" >
<tide time="12:09 AM" type="HIGH" height="1.7" />
<tide time="11:30 AM" type="HIGH" height="1.8" />
<tide time="05:33 AM" type="LOW" height="0.6" />
<tide time="05:49 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T2062" tide_name="San Francisco, Pier 22 1/2" latitude="37.79" longitude="-122.3867" date="03/07/19 (PST)" sunrise="06:32 AM" sunset="06:08 PM" time_zone="PST" iso8601="2019-03-07T08:00:00.00+00:00" >
<tide time="12:33 AM" type="HIGH" height="1.7" />
<tide time="12:09 PM" type="HIGH" height="1.8" />
<tide time="06:05 AM" type="LOW" height="0.5" />
<tide time="06:17 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T2062" tide_name="San Francisco, Pier 22 1/2" latitude="37.79" longitude="-122.3867" date="03/08/19 (PST)" sunrise="06:31 AM" sunset="06:09 PM" time_zone="PST" iso8601="2019-03-08T08:00:00.00+00:00" >
<tide time="12:56 AM" type="HIGH" height="1.7" />
<tide time="12:48 PM" type="HIGH" height="1.7" />
<tide time="06:37 AM" type="LOW" height="0.5" />
<tide time="06:46 PM" type="LOW" height="0.2" />
</forecast>

</location>
<location tide_id="T1565" tide_name="North Point, Pier 41, San Francisco Bay">
<forecast tide_id="T1565" tide_name="North Point, Pier 41, San Francisco Bay" latitude="37.81" longitude="-122.4133" date="03/06/19 (PST)" sunrise="06:34 AM" sunset="06:08 PM" time_zone="PST" iso8601="2019-03-06T08:00:00.00+00:00" >
<tide time="12:00 AM" type="HIGH" height="1.6" />
<tide time="11:21 AM" type="HIGH" height="1.8" />
<tide time="05:17 AM" type="LOW" height="0.6" />
<tide time="05:33 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T1565" tide_name="North Point, Pier 41, San Francisco Bay" latitude="37.81" longitude="-122.4133" date="03/07/19 (PST)" sunrise="06:32 AM" sunset="06:09 PM" time_zone="PST" iso8601="2019-03-07T08:00:00.00+00:00" >
<tide time="12:22 AM" type="HIGH" height="1.6" />
<tide time="11:58 AM" type="HIGH" height="1.7" />
<tide time="05:48 AM" type="LOW" height="0.5" />
<tide time="06:02 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T1565" tide_name="North Point, Pier 41, San Francisco Bay" latitude="37.81" longitude="-122.4133" date="03/08/19 (PST)" sunrise="06:31 AM" sunset="06:10 PM" time_zone="PST" iso8601="2019-03-08T08:00:00.00+00:00" >
<tide time="12:46 AM" type="HIGH" height="1.6" />
<tide time="12:37 PM" type="HIGH" height="1.6" />
<tide time="06:21 AM" type="LOW" height="0.5" />
<tide time="06:32 PM" type="LOW" height="0.2" />
</forecast>

</location>
</report>"

24.6 Notes

The product will return up to the 8 nearest tide locations.